Ir al contenido
Descargar
Guía de Gobu

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.

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”).

La página Linux de Project Settings > Platforms: faltan sus plantillas de exportación y lista las rutas donde las buscó

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….

El botón Platforms abierto: una entrada por plataforma y el submenú de Windows Desktop con Export Game, Export Debug Game, Export Dedicated Server y Platform 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.

Project Settings con las páginas Packaging y Platforms en la barra lateral; la página Windows Desktop muestra sus opciones y el botón Export

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.

Packaging > Content: Export Mode "Export selected levels (and what they use)" y el árbol de niveles que se exportan

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.

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.

La sección Scripts de la página Content con la lista Grost Export Mode abierta: Auto, Text, Binary tokens, Compressed binary tokens y Native

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.

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.

La página Grost de Project Settings, con Advanced Settings activado, y Native > Run From Editor

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.

Packaging > Security: Encrypt Exported Pack, Encrypt File Index y el campo Encryption Key

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 sección Renderer de la página Windows Desktop, con la lista Renderer abierta, y debajo Quality y Bake Shaders

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 .wasm comprimido 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.

La sección Variant de la página Web: Extensions Support, Thread Support, Compress Wasm y Compress Wasm Brotli

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.