Exportar el juego
Exportar es convertir el proyecto en algo que otros pueden ejecutar sin el editor: un .exe
para Windows o una página web. El editor junta tus recursos en un paquete y lo pone al lado
de una plantilla de exportación, un ejecutable del motor ya compilado.
Plantillas de exportación
Sección titulada «Plantillas de exportación»Las plantillas se buscan en Engine/Binaries/platform/<plataforma>/, junto al editor, en una
carpeta debug/ y otra release/ (Engine/Binaries/platform/windows/release/,
Engine/Binaries/platform/web/debug/…). Cada plataforma tiene plantillas
debug y release, y dos variantes:
- 3D: para proyectos 3D (sin los actores 2D).
- 2D: para proyectos 2D (sin el código 3D), más pequeña.
No eliges la variante: el exportador mira si el proyecto es 2D o 3D y usa la que toca. Los
nombres dicen la plataforma, la variante y la configuración: en Windows, por ejemplo,
windows_3d_release.exe y windows_2d_debug.exe (más _opengl para el renderer OpenGL ES 3 y
_console para el envoltorio de consola); en la web web_3d_release.zip (_nothreads sin hilos); en
Android android_release.apk y android_vulkan_release.apk. Las plantillas release se compilan para
velocidad (con LTO en Windows).
Si faltan las plantillas de una plataforma, su página en Project Settings > Platforms lo avisa (“Export templates for this platform are missing”).

Exportar desde el editor
Sección titulada «Exportar desde el editor»El botón Platforms, junto a Play (como en Unreal), tiene un submenú por plataforma:
- Export Game: el juego en release.
- Export Debug Game: el juego en debug, más lento, con sus errores y prints en una consola.
- Export Dedicated Server (Windows y Linux): el juego como servidor de partidas online, ver Online.
- Platform Settings…, o Install Module… si faltan las plantillas de la plataforma.
Debajo, Export All… (todas las plataformas que pueden exportar, en debug o release), Platform Modules… y Export Settings….

Project > Export es una sola lista: una entrada por plataforma que exporta en release, luego Linux Server y Windows Desktop Server para el servidor dedicado, y Export All…, Platform Modules… y Export Settings…. No tiene Export Debug Game ni Platform Settings….
El juego se escribe en <proyecto>/build/<plataforma>/ (por ejemplo build/windows/ o
build/web/); un servidor dedicado, en build/server/<plataforma>/.
Los ajustes están en Project Settings: Packaging reúne lo que comparten todas las plataformas (contenido, scripts, cifrado, parches y features) y Platforms tiene una página por plataforma con sus opciones, su icono y su splash, y un botón Export.

Qué se exporta
Sección titulada «Qué se exporta»En los recursos puedes elegir exportar solo los niveles marcados y lo que usan (es el modo
por defecto en presets nuevos). Siempre entran la escena principal y los archivos que
nombra un ajuste del proyecto; desde ahí el exportador sigue las dependencias:
los use de Grost, los prefabs, las interfaces .uip… Así no viajan recursos que nada usa.

El paquete va comprimido con zstd (salvo los formatos ya comprimidos, como .ogg o .png).
Calidad de las texturas por plataforma (LOD Bias)
Sección titulada «Calidad de las texturas por plataforma (LOD Bias)»Como en Unreal, una textura puede ir más pequeña en las plataformas que lo necesitan, sin tocar el archivo original. Cada nivel de LOD Bias divide su ancho y su alto entre dos: una textura de 4096×2048 con 1 viaja a 2048×1024 y ocupa la cuarta parte de memoria de vídeo.
- En la textura (clic derecho en Assets > Reimport, sección Lod):
- Group: World, Character, Effects, Skybox o UI. Dice qué niveles quita cada plataforma.
- Bias: niveles que quita en todas las plataformas, también en el editor.
- En la plataforma (Project Settings > Platforms, tarjeta Textures): LOD Bias: World, Character, Effects y Skybox, los niveles que quita a las texturas de cada grupo al exportar, además de su propio Bias.
Las texturas del grupo UI nunca bajan por plataforma: úsalo para la interfaz y el pixel art. Por defecto, Android, iOS y la web quitan un nivel a los cielos (Skybox) y nada más: el Skybox del motor va a 4096 en PC y a 2048 en móvil y web.
El editor siempre muestra la calidad completa; lo reducido se hace al exportar y se guarda para la siguiente vez.
Scripts nativos
Sección titulada «Scripts nativos»En Packaging > Content, el modo de exportación de Grost (Grost Export Mode, en su sección
Scripts) decide cómo viajan los scripts.
Además de texto y tokens binarios está Native: cada script exportado se compila a código
nativo, en una biblioteca junto al juego y con su nombre (exportando landwork.exe:
landwork.grost.dll junto a landwork.assets; en la web index.grost.wasm; en Android
libgame_grost.so por arquitectura, dentro del APK), que ejecuta las funciones de los scripts en
lugar de la VM. Los cálculos con números van
decenas de veces más rápido, el código con vectores y arrays varias veces, y el juego arranca en
la mitad de tiempo.

Las exportaciones release a Windows x86_64, a la web y a Android van siempre en Native (en Android, todas las arquitecturas: arm64-v8a, armeabi-v7a, x86_64, x86), diga lo que diga el preset: sus plantillas release no llevan el parser, los compiladores ni la VM de scripts, porque los scripts llegan compilados (unos 1,8 MB menos en Windows 2D). En un móvil (Galaxy A30), los cálculos con números fueron 19 veces más rápido, y el código con arrays 9 veces.
El modo que elijas vale para las exportaciones debug, que conservan la VM para que funcionen los breakpoints y el paso a paso, y para las plataformas sin scripts nativos. El de por defecto, Auto, ahí es tokens comprimidos.
- Sirve para Windows x86_64, Web y Android (arm64-v8a, armeabi-v7a, x86_64 y x86; una biblioteca por arquitectura). Elegido a mano para una exportación debug a otra plataforma, la exportación falla.
- Necesita el compilador nativo de Grost (clang y lld), que viene con las plantillas de la plataforma (Project Settings > Platforms): unos 60 MB para Windows y la web, 75 MB para Android. La primera exportación nativa lo descomprime en la carpeta de datos del editor. Sin él, una exportación release falla y dice que se reinstalen las plantillas.
- Todo o nada: si una función usa algo que aún no se compila a nativo, la exportación falla
y lista
archivo:línea: qué. El juego nunca sale medio nativo. - El mismo proyecto da la misma biblioteca: se guarda en
<proyecto>/.cache/grost_native/y solo se recompila cuando cambia un script. - El SHA-256 de la biblioteca va dentro del ejecutable del juego (y en el paquete): en Windows el juego no ejecuta una biblioteca modificada o cambiada. (Frena los cambios casuales; quien parchee el ejecutable puede saltárselo.)
- El código fuente de los scripts no va en el paquete. La biblioteca guarda también cada script tal como quedó compilado (sus miembros, constantes, señales…), así que el juego los carga sin analizar nada y arranca antes: un proyecto mediano pasó de 1 s a 0,56 s.
- En código nativo no hay breakpoints ni paso a paso: para depurar una build, expórtala en debug (con tokens, lo de por defecto). Una exportación debug con Native elegido a mano sigue dando los errores con su archivo y línea, y el Profiler del depurador lista las funciones nativas (llamadas, tiempo total y propio) y los métodos del motor que llaman, igual que con tokens.
Código nativo al pulsar Play
Sección titulada «Código nativo al pulsar Play»Activa Grost > Native > Run From Editor en los Project Settings (se ve con Advanced Settings
activado, el interruptor que está arriba en la barra lateral) y Play ejecuta el juego con
sus scripts compilados a nativo, como lo haría la exportación (Windows). Antes de arrancar el
juego, el editor compila todos los scripts en <proyecto>/.cache/grost_native/play/ (la primera
vez tarda; después, solo lo que cambió), y la salida dice cuántos y cuánto tardó. Si un script no
se puede compilar, o falta el compilador, el juego corre en la VM y la salida dice por qué. Los
breakpoints no paran en funciones nativas: desactívalo para depurar paso a paso.

Cifrar el paquete
Sección titulada «Cifrar el paquete»En Packaging > Security, Encrypt Exported Pack cifra el paquete del juego con AES-256 y la
Encryption Key (64 caracteres hexadecimales); Encrypt File Index oculta también los nombres
de los archivos. En Windows y Linux la exportación escribe la clave dentro del ejecutable del
juego, así que las plantillas sirven tal como vienen. Las demás plataformas necesitan plantillas
compiladas con la clave (SCRIPT_AES256_ENCRYPTION_KEY). La clave viaja dentro del ejecutable:
el cifrado evita que el contenido del juego se abra con una herramienta de paquetes, no que
alguien saque la clave.

Windows
Sección titulada «Windows»Opciones propias del preset de Windows:
- Renderer: Project, Auto, Direct3D 11, Direct3D 12 u OpenGL ES 3 (para equipos antiguos).
- Quality: Project, Low, Medium, High, Epic o Cinematic.
- Bake shaders (activado por defecto): precompila los shaders del renderer elegido. Sin ellos, el juego dibuja los materiales con el shader de error.

La exportación web genera una página HTML con el motor en WebAssembly (sobre WebGL2). Usa
como icono el del proyecto (icon.svg). Opciones útiles:
variant/compress_wasm: escribe el.wasmcomprimido con gzip.variant/compress_wasm_brotli(requiere la anterior): además escribe una versión Brotli, bastante más pequeña. La exportación tarda más.

Las plantillas web incluyen variantes con y sin hilos (nothreads). Para probarla, sirve la
carpeta build/web/ con un servidor HTTP; abrir el .html directamente desde el disco no
suele funcionar en los navegadores.