Configuración del proyecto

El archivo game.project contiene toda la configuración global del proyecto. Debe permanecer en la carpeta raíz del proyecto y llamarse game.project. Lo primero que hace el motor al iniciarse y lanzar tu juego es buscar este archivo.

Cada configuración del archivo pertenece a una categoría. Cuando abres el archivo, Defold muestra todas las configuraciones agrupadas por categoría.

Formato de archivo

La configuración en game.project normalmente se cambia desde Defold, pero el archivo también se puede editar en cualquier editor de texto estándar. El archivo sigue el estándar de formato de archivo INI y se ve así:

[category1]
setting1 = value
setting2 = value
[category2]
...

Un ejemplo real es:

[bootstrap]
main_collection = /main/main.collectionc

lo que significa que la configuración main_collection pertenece a la categoría bootstrap. Cada vez que se usa una referencia de archivo, como en el ejemplo anterior, la ruta debe llevar agregado un carácter ‘c’, lo que significa que estás referenciando la versión compilada del archivo. Ten en cuenta también que la carpeta que contiene game.project será la raíz del proyecto, por eso hay una ‘/’ inicial en la ruta de la configuración.

Acceso en runtime

Es posible leer cualquier valor de game.project en runtime usando sys.get_config_string(key), sys.get_config_number(key) y sys.get_config_int(key). Ejemplos:

local title = sys.get_config_string("project.title")
local gravity_y = sys.get_config_number("physics.gravity_y")

Secciones y configuraciones

A continuación se muestran todas las configuraciones disponibles, organizadas por categoría.

Project

Title

El título de la aplicación.

Version

La versión de la aplicación.

Publisher

Nombre del publicador.

Developer

Nombre del desarrollador.

Write Log File

Controla cuándo el motor escribe un archivo de log. Opciones:

• “Never”: no escribir un archivo de log.
• “Debug”: escribir un archivo de log solo para builds Debug.
• “Always”: escribir un archivo de log tanto para builds Debug como Release.

Si se ejecuta más de una instancia desde el editor, el archivo se llamará instance_2_log.txt, donde 2 es el índice de la instancia. Si se ejecuta una sola instancia o desde un bundle, el archivo se llamará log.txt. La ubicación del archivo de log será una de las siguientes rutas (se prueban en orden):

1. La ruta especificada en project.log_dir (configuración oculta)
2. La ruta de log del sistema:
   • macOS/iOS: NSDocumentDirectory
   • Android: Context.getExternalFilesDir()
   • Otros: raíz de la aplicación
3. La ruta de soporte de la aplicación
   • macOS/iOS: NSApplicationSupportDirectory
   • Windows: CSIDL_APPDATA (por ejemplo, C:\Users\<username>\AppData\Roaming)
   • Android: Context.getFilesDir()
   • Linux: variable de ambiente HOME

Minimum Log Level

Especifica el nivel mínimo de log para el sistema de logging. Solo se mostrarán los logs de este nivel o superiores.

Compress Archive

Activa la compresión de archivos al crear bundles. Ten en cuenta que actualmente esto se aplica a todas las plataformas excepto Android, donde el apk ya contiene todos los datos comprimidos.

Dependencies

Una lista de URL a las Library URL del proyecto. Consulta el manual de bibliotecas para obtener más información.

Custom Resources

custom_resources Los recursos personalizados se empaquetan en el archivo principal del juego usando el campo Custom Resources en game.project.

El campo Custom Resources debe contener una lista separada por comas de los recursos que se incluirán en el archivo principal del juego. Si se especifican directorios, todos los archivos y directorios dentro de ese directorio se incluyen de forma recursiva. Puedes leer los archivos usando sys.load_resource().

La carga de recursos personalizados se explica con más detalle en el manual de acceso a archivos.

Bundle Resources

bundle_resources Los recursos de bundle son archivos y carpetas adicionales ubicados como parte del bundle de tu aplicación usando el campo Bundle Resources en game.project.

El campo Bundle Resources debe contener una lista separada por comas de directorios que contienen archivos de recursos y carpetas que deben copiarse tal cual en el paquete resultante al crear el bundle. Los directorios deben especificarse con una ruta absoluta desde la raíz del proyecto, por ejemplo /res. El directorio de recursos debe contener subcarpetas con nombres según platform o architecture-platform.

Las plataformas soportadas son ios, android, osx, win32, linux, web, switch. También se permite una subcarpeta llamada common, que contiene archivos de recursos comunes para todas las plataformas. Ejemplo:

res
├── win32
│   └── mywin32file.txt
├── common
│   └── mycommonfile.txt
└── android
    ├── myandroidfile.txt
    └── res
        └── xml
            └── filepaths.xml

Puedes usar sys.get_application_path() para obtener la ruta donde está almacenada la aplicación. Usa esta ruta base de la aplicación para crear la ruta absoluta final a los archivos a los que necesitas acceder. Una vez que tengas la ruta absoluta de estos archivos, puedes usar las funciones io.* y os.* para acceder a los archivos.

La carga de recursos de bundle se explica con más detalle en el manual de acceso a archivos.

Bundle Exclude Resources

bundle_exclude_resources Una lista separada por comas de recursos que no deben incluirse en el bundle. Es decir, se eliminan del resultado del paso de recopilación de bundle_resources.

Bootstrap

Main Collection

Referencia de archivo de la colección que se usará para iniciar la aplicación, /logic/main.collection de forma predeterminada.

Render

Qué archivo de configuración de render usar, el cual define el pipeline de renderizado, /builtins/render/default.render de forma predeterminada.

Library

Include Dirs

Una lista de directorios separados por espacios que deben compartirse desde tu proyecto mediante el uso compartido de bibliotecas. Consulta el manual de bibliotecas para obtener más información.

Script

Shared State

Marca esta opción para compartir un único estado Lua entre todos los tipos de script.

Engine

Run While Iconified

Permite que el motor siga ejecutándose mientras la ventana de la aplicación está iconificada (solo plataformas de escritorio).

Fixed Update Frequency

La frecuencia de actualización de la función de ciclo de vida fixed_update(self, dt). En Hertz.

Max Time Step

Si el paso de tiempo se vuelve demasiado grande durante un solo frame, se limitará a este valor máximo. Segundos.

Display

Width

El ancho en pixeles de la ventana de la aplicación.

Height

La altura en pixeles de la ventana de la aplicación.

High Dpi

Crea un back buffer de alta densidad de pixeles en pantallas que lo soportan. Normalmente, el juego se renderizará al doble de la resolución establecida en las configuraciones Width y Height, que seguirán siendo la resolución lógica usada en scripts y propiedades.

Samples

Cuántas muestras usar para super sampling anti-aliasing. Define el window hint GLFW_FSAA_SAMPLES. Un valor de 0 significa que el anti-aliasing está desactivado.

Fullscreen

Marca esta opción si la aplicación debe iniciar en pantalla completa. Si no está marcada, la aplicación se ejecuta en una ventana.

Update Frequency

La tasa de frames deseada en Hertz. Define 0 para una tasa de frames variable. Un valor mayor que 0 dará como resultado una tasa de frames fija limitada en runtime hacia la tasa de frames real (lo que significa que no puedes actualizar el loop del juego dos veces en un frame del motor). Usa sys.set_update_frequency(hz) para cambiar este valor en runtime. Esta configuración también funciona en builds headless.

Swap interval

Este valor entero controla cómo la aplicación gestiona vsync. 0 desactiva vsync, y el valor predeterminado es 1. Al usar un adaptador OpenGL, este valor define el número de frames que la ventana debe actualizar entre intercambios de buffer. Para Vulkan no existe un concepto integrado de swap interval; en su lugar, el valor controla si vsync debe estar activado o no.

Vsync

Depende de vsync por hardware para el timing de frames. Puede ser sobrescrito según el driver gráfico y los detalles específicos de la plataforma. Para el comportamiento obsoleto de ‘variable_dt’, desmarca esta configuración y define el límite de frames en 0.

Display Profiles

Especifica qué archivo de perfiles de pantalla usar, /builtins/render/default.display_profilesc de forma predeterminada. Aprende más en el manual de layouts de GUI.

Dynamic Orientation

Marca esta opción si la app debe cambiar dinámicamente entre orientación vertical y horizontal al rotar el dispositivo. Ten en cuenta que la app de desarrollo actualmente no respeta esta configuración.

Display Device Info

Muestra información de GPU en la consola al iniciar.

Render

Clear Color Red

Canal rojo del color de limpieza, usado por el script de render y cuando se crea la ventana.

Clear Color Green

Canal verde del color de limpieza, usado por el script de render y cuando se crea la ventana.

Clear Color Blue

Canal azul del color de limpieza, usado por el script de render y cuando se crea la ventana.

Clear Color Alpha

Canal alfa del color de limpieza, usado por el script de render y cuando se crea la ventana.

Font

Runtime Generation

Usa generación de fuentes en runtime.

Physics

Max Collision Object Count

Número máximo de objetos colisionadores.

Type

Qué tipo de físicas usar, 2D o 3D.

Gravity X

Gravedad del mundo a lo largo del eje x. En metros por segundo.

Gravity Y

Gravedad del mundo a lo largo del eje y. En metros por segundo.

Gravity Z

Gravedad del mundo a lo largo del eje z. En metros por segundo.

Debug

Marca esta opción si las físicas deben visualizarse para depuración.

Debug Alpha

Valor del componente alfa para las físicas visualizadas, 0–1.

World Count

Número máximo de mundos de físicas concurrentes, 4 de forma predeterminada. Si cargas más de 4 mundos simultáneamente mediante proxies de colección, debes aumentar este valor. Ten presente que cada mundo de físicas asigna una cantidad considerable de memoria.

Scale

Indica al motor de físicas cómo escalar los mundos de físicas en relación con el mundo del juego para obtener precisión numérica, 0.01–1.0. Si el valor se define como 0.02, significa que el motor de físicas verá 50 unidades como 1 metro ($1 / 0.02$).

Allow Dynamic Transforms

Marca esta opción si el motor de físicas debe aplicar la transformación de un objeto de juego a cualquier componente de objeto colisionador adjunto. Esto se puede usar para mover, escalar y rotar formas de colisión, incluso las que son dinámicas.

Use Fixed Timestep

Marca esta opción si el motor de físicas debe usar actualizaciones de paso de tiempo fijo e independientes del frame rate. Usa esta configuración en combinación con la función de ciclo de vida fixed_update(self, dt) y la configuración de proyecto engine.fixed_update_frequency para interactuar con el motor de físicas a intervalos regulares. Para proyectos nuevos, la configuración recomendada es true.

Debug Scale

El tamaño con el que dibujar objetos unitarios en físicas, como tríadas y normales.

Max Collisions

Cuántas colisiones se reportarán de vuelta a los scripts.

Max Contacts

Cuántos puntos de contacto se reportarán de vuelta a los scripts.

Contact Impulse Limit

Ignora impulsos de contacto con valores menores que esta configuración.

Ray Cast Limit 2d

El número máximo de solicitudes de ray cast 2D por frame.

Ray Cast Limit 3d

El número máximo de solicitudes de ray cast 3D por frame.

Trigger Overlap Capacity

El número máximo de triggers de físicas superpuestos.

Velocity Threshold

Velocidad mínima que dará lugar a colisiones elásticas.

Max Fixed Timesteps

Número máximo de pasos en la simulación al usar paso de tiempo fijo (solo 3D).

Graphics

Default Texture Min Filter

Especifica qué filtrado usar para el filtrado de minificación.

Default Texture Mag Filter

Especifica qué filtrado usar para el filtrado de magnificación.

Max Draw Calls

El número máximo de llamadas de render.

Max Characters:

El número de caracteres preasignados en el buffer de renderizado de texto, es decir, el número de caracteres que se pueden mostrar en cada frame.

Max Font Batches

El número máximo de lotes de texto que se pueden mostrar en cada frame.

Max Debug Vertices

El número máximo de vértices de debug. Se usa, entre otras cosas, para renderizar formas de físicas.

Texture Profiles

El archivo de perfiles de textura que se usará para este proyecto, /builtins/graphics/default.texture_profiles de forma predeterminada.

Verify Graphics Calls

Verifica el valor de retorno después de cada llamada gráfica y reporta cualquier error en el log.

OpenGL Version Hint

Indicación de versión de contexto OpenGL. Si se selecciona una versión específica, se usará como versión mínima requerida (no se aplica a OpenGL ES).

OpenGL Core Profile Hint

Define la indicación de perfil ‘core’ de OpenGL al crear el contexto. El perfil core elimina todas las funcionalidades obsoletas de OpenGL, como el renderizado en modo inmediato. No se aplica a OpenGL ES.

Shader

Exclude GLES 2.0

No compila shaders para dispositivos que ejecutan OpenGLES 2.0 / WebGL 1.0.

Input

Repeat Delay

Segundos que esperar antes de que un input mantenido presionado empiece a repetirse.

Repeat Interval

Segundos que esperar entre cada repetición de un input mantenido presionado.

Gamepads

Referencia al archivo de configuración de gamepads, que mapea señales de gamepad al sistema operativo, /builtins/input/default.gamepads de forma predeterminada.

Game Binding

Referencia al archivo de configuración de input, que mapea inputs de hardware a acciones, /input/game.input_binding de forma predeterminada.

Use Accelerometer

Marca esta opción para hacer que el motor reciba eventos de input del acelerómetro en cada frame. Desactivar el input del acelerómetro puede dar cierto beneficio de rendimiento.

Resource

Http Cache

Si está marcada, se activa una caché HTTP para cargar más rápido recursos por red hacia el motor que se ejecuta en el dispositivo.

Uri

Dónde encontrar los datos de build del proyecto, en formato URI.

Max Resources

El número máximo de recursos que se pueden cargar al mismo tiempo.

Network

Http Timeout

El timeout HTTP en segundos. Define 0 para desactivar el timeout.

Http Thread Count

El número de worker threads para el servicio HTTP.

Http Cache Enabled

Marca esta opción para activar la caché HTTP para solicitudes de red (usando http.request()). La caché HTTP almacenará la respuesta asociada con una solicitud y reutilizará la respuesta almacenada para solicitudes posteriores. La caché HTTP soporta los headers de respuesta HTTP ETag y Cache-Control: max-age.

SSL Certificates

Archivo que contiene certificados raíz SSL para usar al verificar la cadena de certificados durante handshakes SSL.

Collection

Max Instances

Número máximo de instancias de objetos de juego en una colección, 1024 de forma predeterminada. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Max Input Stack Entries

Número máximo de objetos de juego en la pila de input.

Sound

Gain

Ganancia global (volumen), 0–1.

Use Linear Gain

Si está activada, la ganancia es lineal. Si está desactivada, usa una curva exponencial.

Max Sound Data

Número máximo de recursos de sonido, es decir, el número de archivos de sonido únicos en runtime.

Max Sound Buffers

(Actualmente no se usa) Número máximo de buffers de sonido concurrentes.

Max Sound Sources

(Actualmente no se usa) Número máximo de sonidos que se reproducen de forma concurrente.

Max Sound Instances

Número máximo de instancias de sonido concurrentes, es decir, sonidos reales reproducidos al mismo tiempo.

Max Component Count

Número máximo de componentes de sonido por colección.

Sample Frame Count

Número de muestras usadas para cada actualización de audio. 0 significa automático (1024 para 48 kHz, 768 para 44.1 kHz).

Use Thread

Si está marcada, el sistema de sonido usará threads para la reproducción de sonido y así reducir el riesgo de tirones cuando el thread principal está bajo mucha carga.

Stream Enabled

Si está marcada, el sistema de sonido usará streaming para cargar archivos fuente.

Stream Cache Size

El tamaño máximo de la caché de chunks de sonido que contiene todos los chunks. 2097152 bytes de forma predeterminada. Este número debe ser mayor que el número de archivos de sonido cargados multiplicado por el tamaño de chunk de stream. De lo contrario, corres el riesgo de expulsar chunks nuevos en cada frame.

Stream Chunk Size

El tamaño en bytes de cada chunk transmitido por streaming.

Stream Preload Size

Determina el tamaño en bytes del chunk inicial para archivos de sonido leídos desde el archivo.

Sprite

Max Count

Número máximo de sprites por colección. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Subpixels

Marca esta opción para permitir que los sprites aparezcan desalineados con respecto a los pixeles.

Tilemap

Max Count

Número máximo de tile maps por colección. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Max Tile Count

Número máximo de tiles visibles concurrentes por colección.

Spine

Max Count

Número máximo de componentes de modelo Spine. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Mesh

Max Count

Número máximo de componentes mesh por colección. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Model

Max Count

Número máximo de componentes de modelo por colección. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Split Meshes

Divide meshes con más de 65536 vértices en meshes nuevos.

Max Bone Matrix Texture Width

Ancho máximo de la textura de matriz de huesos. Solo se usa el tamaño necesario para animaciones, redondeado hacia arriba a la potencia de dos más cercana.

Max Bone Matrix Texture Height

Altura máxima de la textura de matriz de huesos. Solo se usa el tamaño necesario para animaciones, redondeado hacia arriba a la potencia de dos más cercana.

GUI

Max Count

Número máximo de componentes GUI. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Max Particle Count

El número máximo de partículas concurrentes en GUI.

Max Animation Count

El número máximo de animaciones activas en GUI.

Label

Max Count

Número máximo de labels. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Subpixels

Marca esta opción para permitir que los labels aparezcan desalineados con respecto a los pixeles.

Particle FX

Max Count

El número máximo de emisores concurrentes. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Max Particle Count

El número máximo de partículas concurrentes.

Box2D

Velocity Iterations

Número de iteraciones de velocidad para el solver de físicas Box2D 2.2.

Position Iterations

Número de iteraciones de posición para el solver de físicas Box2D 2.2.

Sub Step Count

Número de subpasos para el solver de físicas Box2D 3.x.

Collection proxy

Max Count

Número máximo de proxies de colección. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Collection factory

Max Count

Número máximo de factories de colección. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

Factory

Max Count

Número máximo de factories de objetos de juego. (Consulta la información sobre optimizaciones del conteo máximo de componentes).

iOS

App Icon 57x57–180x180

Archivo de imagen (.png) para usar como icono de la aplicación en las dimensiones de ancho y alto dadas W × H.

Launch Screen

Archivo storyboard (.storyboard). Aprende más sobre cómo crear uno en el manual de iOS.

Icons Asset

El archivo de asset de iconos (.car) que contiene iconos de la app.

Prerendered Icons

(iOS 6 y anteriores) Marca esta opción si tus iconos están prerenderizados. Si está desmarcada, se agregará automáticamente un brillo a los iconos.

Bundle Identifier

El identificador de bundle permite que iOS reconozca cualquier actualización de tu app. Tu bundle ID debe estar registrado con Apple y ser único para tu app. No puedes usar el mismo identificador para apps de iOS y macOS. Debe constar de dos o más segmentos separados por un punto. Cada segmento debe empezar con una letra. Cada segmento debe contener solo letras alfanuméricas, el guion bajo o el carácter de guion (-) (consulta CFBundleIdentifier)

Bundle Name

El nombre corto del bundle (15 caracteres) (consulta CFBundleName).

Bundle Version

La versión del bundle, ya sea un número o x.y.z. (consulta CFBundleVersion)

Info.plist

Si se especifica, usa este archivo info.plist al crear el bundle de tu app.

Privacy Manifest

El Apple Privacy Manifest para la aplicación. El campo tendrá como valor predeterminado /builtins/manifests/ios/PrivacyInfo.xcprivacy.

Custom Entitlements

Si se especifica, los entitlements del perfil provisional suministrado (.entitlements, .xcent, .plist) se fusionarán con los entitlements del perfil provisional suministrado al crear el bundle de la aplicación.

Default Language

El idioma usado si la aplicación no tiene el idioma preferido del usuario en la lista Localizations (consulta CFBundleDevelopmentRegion). Usa el estándar ISO 639-1 de dos letras si el idioma preferido está disponible allí, o ISO 639-2 de tres letras.

Localizations

Este campo contiene strings separados por comas que identifican el nombre del idioma o el designador de idioma ISO de las localizaciones soportadas (consulta CFBundleLocalizations).

Android

App Icon 36x36–192x192

Archivo de imagen (.png) para usar como icono de la aplicación en las dimensiones de ancho y alto dadas W × H.

Push Icon Small–LargeXxxhdpi

Archivos de imagen (.png) para usar como icono personalizado de notificaciones push en Android. Los iconos se usarán automáticamente tanto para notificaciones push locales como remotas. Si no se define, se usará el icono de la aplicación de forma predeterminada.

Push Field Title

Especifica qué campo JSON del payload debe usarse como título de la notificación. Dejar esta configuración vacía hace que las notificaciones push usen de forma predeterminada el nombre de la aplicación como título.

Push Field Text

Especifica qué campo JSON del payload debe usarse como texto de la notificación. Si se deja vacío, se usa el texto del campo alert, igual que en iOS.

Version Code

Un valor entero que indica la versión de la app. Aumenta el valor para cada actualización posterior.

Minimum SDK Version

El API Level mínimo requerido para que la aplicación se ejecute (android:minSdkVersion).

Target SDK Version

El API Level al que apunta la aplicación (android:targetSdkVersion).

Package

Identificador de paquete. Debe constar de dos o más segmentos separados por un punto. Cada segmento debe empezar con una letra. Cada segmento debe contener solo letras alfanuméricas o el carácter de guion bajo.

GCM Sender Id

Google Cloud Messaging Sender Id. Define esto con el string asignado por Google para activar notificaciones push.

FCM Application Id

Firebase Cloud Messaging Application Id.

Manifest

Si se define, usa el archivo XML de manifiesto de Android especificado al crear el bundle.

Iap Provider

Especifica qué tienda usar. Las opciones válidas son Amazon y GooglePlay. Consulta extension-iap para obtener más información.

Input Method

Especifica qué método usar para obtener input de teclado en dispositivos Android. Las opciones válidas son KeyEvent (método antiguo) y HiddenInputField (nuevo).

Immersive Mode

Si se define, oculta las barras de navegación y estado y permite que tu app capture todos los eventos táctiles en la pantalla.

Display Cutout

Extiende la aplicación al display cutout.

Debuggable

Indica si la aplicación se puede depurar usando herramientas como GAPID o Android Studio. Esto definirá el flag android:debuggable en el manifiesto de Android (documentación oficial).

ProGuard config

Archivo ProGuard personalizado para ayudar a eliminar clases Java redundantes del APK final.

Extract Native Libraries

Especifica si el instalador del paquete extrae bibliotecas nativas del APK al sistema de archivos. Si se define como false, tus bibliotecas nativas se almacenan sin comprimir en el APK. Aunque tu APK puede ser más grande, tu aplicación carga más rápido porque las bibliotecas se cargan directamente desde el APK en runtime. Esto definirá el flag android:extractNativeLibs en el manifiesto de Android (documentación oficial).

macOS

App Icon

Archivo de icono de bundle (.icns) para usar como icono de la aplicación en macOS.

Info.plist

Si se define, usa el archivo info.plist especificado al crear el bundle.

Privacy Manifest

El Apple Privacy Manifest para la aplicación. El campo tendrá como valor predeterminado /builtins/manifests/osx/PrivacyInfo.xcprivacy.

Bundle Identifier

El identificador de bundle permite que macOS reconozca actualizaciones de tu app. Tu bundle ID debe estar registrado con Apple y ser único para tu app. No puedes usar el mismo identificador para apps de iOS y macOS. Debe constar de dos o más segmentos separados por un punto. Cada segmento debe empezar con una letra. Cada segmento debe contener solo letras alfanuméricas, el guion bajo o el carácter de guion (-).

Default Language

El idioma usado si la aplicación no tiene el idioma preferido del usuario en la lista Localizations (consulta CFBundleDevelopmentRegion). Usa el estándar ISO 639-1 de dos letras si el idioma preferido está disponible allí, o ISO 639-2 de tres letras.

Localizations

Este campo contiene strings separados por comas que identifican el nombre del idioma o el designador de idioma ISO de las localizaciones soportadas (consulta CFBundleLocalizations).

Windows

App Icon

Archivo de imagen (.ico) para usar como icono de la aplicación en Windows. Lee más sobre cómo crear un archivo .ico en el manual de Windows.

HTML5

Consulta el manual de la plataforma HTML5 para obtener más información sobre muchas de estas opciones.

Heap Size

Tamaño del heap en megabytes para que lo use Emscripten.

.html Shell

Usa el archivo HTML de plantilla especificado al crear el bundle. De forma predeterminada, /builtins/manifests/web/engine_template.html.

Custom .css

Usa el archivo CSS de tema especificado al crear el bundle. De forma predeterminada, /builtins/manifests/web/light_theme.css.

Splash Image

Si se define, usa la imagen de splash especificada al iniciar al crear el bundle, en lugar del logo de Defold.

Archive Location Prefix

Al crear un bundle para HTML5, los datos del juego se dividen en uno o más archivos de datos. Cuando el motor inicia el juego, estos archivos se leen en memoria. Usa esta configuración para especificar la ubicación de los datos.

Archive Location Suffix

Sufijo que se agregará a los archivos de datos. Útil, por ejemplo, para forzar contenido no cacheado desde un CDN (?version2, por ejemplo).

Engine Arguments

Lista de argumentos que se pasarán al motor.

Wasm Streaming

Activa streaming del archivo wasm (más rápido y usa menos memoria, pero requiere el tipo MIME application/wasm).

Show Fullscreen Button

Activa Fullscreen Button en el archivo index.html.

Show Made With Defold

Activa el enlace Made With Defold en el archivo index.html.

Show Console Banner

Cuando está activada, esta opción imprimirá información sobre el motor y la versión del motor en la consola del navegador (usando console.log()) cuando el motor arranque.

Scale Mode

Especifica qué método usar para escalar el canvas del juego.

Retry Count

El número de intentos para descargar un archivo cuando el motor arranca (consulta Retry Time).

Retry Time

El número de segundos que esperar entre intentos de descargar un archivo cuando la descarga falló (consulta Retry Count).

Transparent Graphics Context

Marca esta opción si quieres que el contexto gráfico tenga un fondo transparente.

IAP

Auto Finish Transactions

Marca esta opción para finalizar automáticamente las transacciones IAP. Si está desmarcada, debes llamar explícitamente a iap.finish() después de una transacción exitosa.

Live update

Settings

Archivo de recurso de configuración de Live Update para usar durante la creación de bundles.

Mount On Start

Activa el montaje automático de recursos montados previamente cuando la aplicación arranca.

Native extension

App Manifest

Si se define, usa el manifiesto de la aplicación para personalizar la build del motor. Esto te permite eliminar partes no usadas del motor para reducir el tamaño binario final. Aprende cómo excluir funcionalidades no usadas en el manual del manifiesto de aplicación.

Profiler

Enabled

Activa el profiler dentro del juego.

Track Cpu

Si está marcada, activa el profiling de CPU en versiones release de las builds. Normalmente, solo puedes acceder a la información de profiling en builds debug.

Sleep Between Server Updates

Número de milisegundos que dormir entre actualizaciones del servidor.

Performance Timeline Enabled

Activa la línea de tiempo de rendimiento en el navegador (solo HTML5).

Definir valores de configuración al iniciar el motor

Cuando el motor arranca, es posible proporcionar valores de configuración desde la línea de comando que sobrescriben la configuración de game.project:

# Especificar una colección bootstrap
$ dmengine --config=bootstrap.main_collection=/my.collectionc

# Definir dos valores de configuración personalizados
$ dmengine --config=test.my_value=4711 --config=test2.my_value2=foobar

Los valores personalizados pueden, igual que cualquier otro valor de configuración, leerse con sys.get_config_string() o sys.get_config_number():

local my_value = sys.get_config_number("test.my_value")
local my_value2 = sys.get_config_string("test.my_value2")

Optimizaciones de max count de componentes

El archivo de configuración game.project contiene muchos valores que especifican la cantidad máxima de un recurso determinado que puede existir al mismo tiempo, a menudo contada por colección cargada (también llamada mundo). El motor Defold usará estos valores máximos para preasignar la memoria necesaria para esa cantidad, y así evitar asignaciones dinámicas y fragmentación de memoria mientras el juego se ejecuta.

Las estructuras de datos de Defold usadas para representar componentes y otros recursos están optimizadas para usar la menor cantidad de memoria posible, pero aun así se debe tener cuidado al definir los valores para evitar asignar más memoria de la realmente necesaria.

Para optimizar aún más el uso de memoria, el proceso de build de Defold analizará el contenido del juego y sobrescribirá los max counts si es posible conocer con certeza la cantidad exacta:

• Si una colección no contiene componentes factory, se asignará la cantidad exacta de cada componente y Game Object, y se ignorarán los valores de max count.
• Si una colección contiene un componente factory, se analizarán los objetos generados y se usará el max count para los componentes que puedan generarse desde las factories y para los Game Objects.
• Si una colección contiene una factory o una factory de colección con la opción “Dynamic Prototype” activada, esta colección usará los contadores máximos.

Configuración personalizada del proyecto

Es posible definir configuraciones personalizadas para el proyecto principal o para una extensión nativa. Las configuraciones personalizadas para el proyecto principal deben definirse en un archivo game.properties en la raíz del proyecto. Para una extensión nativa, deben definirse en un archivo ext.properties junto al archivo ext.manifest.

El archivo de configuración usa el mismo formato INI que game.project, y los atributos de propiedad se definen usando una notación con puntos y un sufijo:

[my_category]
my_property.private = 1
...

El archivo meta predeterminado que siempre se aplica está disponible aquí

Los siguientes atributos están disponibles actualmente:

[my_extension]
// `type` - usado para analizar el string del valor
my_property.type = string // uno de los siguientes valores: bool, string, number, integer, string_array, resource

// `help` - usado como texto de ayuda en el editor (no se usa por ahora)
my_property.help = string

// `default` - valor usado como predeterminado si el usuario no definió el valor manualmente
my_property.default = string

// `private` - valor privado usado durante el proceso de bundle, pero eliminado del bundle en sí
my_property.private = 1 // valor booleano 1 o 0

// `label` - etiqueta de input del editor
my_property.label = My Awesome Property

// `minimum` y/o `maximum` - rango válido para propiedades numéricas, validado en la interfaz del editor
my_property.minimum = 0
my_property.maximum = 255

// `options` - opciones del desplegable para la interfaz del editor, pares value[:label] separados por comas
my_property.options = android: Android, ios: iOS

// solo tipo `resource`:
my_property.filter = jpg,png // extensiones de archivo permitidas para el diálogo selector de recursos
my_property.preserve-extension = 1 // usar la extensión original del recurso en lugar de una generada

// obsolescencia
my_property.deprecated = 1 // marcar propiedad como obsoleta
my_property.severity-default = warning // si se especifica una propiedad obsoleta, pero se define con un valor predeterminado
my_property.severity-override = error  // si se especifica una propiedad obsoleta y se define con un valor no predeterminado

Además, puedes definir los siguientes atributos en una categoría de configuración:

[my_extension]
// `group` - grupo de categoría de game.project, por ejemplo, Main, Platforms, Components, Runtime, Distribution
group = Runtime
// `title` - título de categoría mostrado
title = My Awesome Extension
// `help` - ayuda de categoría mostrada
help = Settings for My Awesome Extension

Por el momento, las propiedades meta se usan solo en bob.jar al crear el bundle de la aplicación, pero más adelante el editor las analizará y las representará en el visor de game.project.