Mundos grandes
Un mundo grande tiene que costar lo mismo que uno pequeño: lo que está cerca del jugador se carga, se procesa y se dibuja, y el resto espera en disco. Gobu lo hace como el World Partition de Unreal, por celdas: cuadrados del suelo (x e y en 2D, x y z en 3D) que entran cuando la cámara se acerca y se van cuando se aleja.
Hay dos tipos de contenido, y los dos van por celdas:
- Lo generado: generadores procedurales en modo At Runtime.
- Lo puesto a mano: un nivel con World Partition activado.
Los dos comparten un presupuesto por frame, así que moverse por un mundo grande no da tirones.
Lo generado: At Runtime
Sección titulada «Lo generado: At Runtime»Pon el Generate Mode de un generador en At Runtime (ver Generación procedural). En el juego hace las celdas dentro de Generation Radius alrededor de la cámara y de los nodos ProceduralSource2D/3D, las más cercanas primero, un poco cada frame. Quita las celdas que quedan más lejos que el radio por Cleanup Radius Multiplier.

- El alcance nunca es menor que lo que ve la cámara más un cuarto, así que nada aparece en pantalla mientras miras.
- En este modo,
generate()no lo hace todo de una vez: quita lo hecho y las celdas vuelven con los ajustes actuales. Un script que pone los parámetros y llama agenerate()funciona igual en cualquier modo. - Lo que el jugador cambia en algo generado (un árbol talado) se va cuando se va su celda: al
volver la celda, el grafo lo vuelve a hacer. El juego guarda lo que quiera con dos señales.
prefab_spawning(node, id)llega antes de que el prefab entre en la escena (lo que le pongas está ahí para su_ready);prefab_removing(node, id)llega antes de que se vaya.ides el id estable del punto: el mismo cada vez que vuelve la celda.
use actor::Forest as forest : ProceduralGenerator2D
# Los árboles talados, por su id estable (el mismo cada vez que vuelve su celda).mut cut_down : Dictionary[int, bool] = {}
on forest.prefab_spawning(node: Actor, id: int) { if tree := node as Tree { tree.cut = cut_down.get(id, false) }}
on forest.prefab_removing(node: Actor, id: int) { if tree := node as Tree { cut_down[id] = tree.cut }}En un juego en red, los objetos generados con un Online Mode guardan sus valores
@persistent en el servidor cuando se va su celda, y los recuperan al volver.
Lo puesto a mano: World Partition
Sección titulada «Lo puesto a mano: World Partition»Selecciona la raíz de un nivel (un .scene) y activa World Partition > Enabled en el
Inspector:
- Cell Size: el lado de una celda (2048 px en 2D y 128 m en 3D por defecto).
- Loading Range: hasta dónde alrededor de la cámara se cargan celdas (4096 px y 256 m por defecto).

Qué va por celdas (las unidades):
- Cada hijo de la raíz con posición (un
Spatial2D/Spatial3D), con todo lo que lleva dentro. - Los hijos con posición de una carpeta: un
Actorsin código, como las carpetas de Unreal.
Qué está siempre:
- La raíz, y lo que no tiene posición.
- Un nodo marcado World Partition > Always Loaded en el Inspector.
- Un nodo que el código del nivel nombra con
use actor::X: si no, su código no lo encontraría. - Lo que el nivel necesita esté donde esté: las cámaras (las celdas se cargan alrededor de
ellas), los puntos de inicio de los jugadores y lo que cubre el mundo en vez de un sitio
(
TileMapLayer,GridMap, los generadores procedurales, que cargan su propio contenido). Una unidad con una cámara dentro también se queda. - Los objetos online (con un Online Mode), por ahora.

En disco, la carpeta del nivel guarda lo que está siempre en tree.gobu, y las unidades de cada
celda en cells/<x>_<y>.gobu. El editor lo lee todo y el nivel se edita como siempre. Al guardar,
cada unidad va a la celda de su posición y las celdas que quedan vacías se borran. La
exportación incluye las celdas.
En el juego, el nivel empieza solo con lo que está siempre. Sus celdas entran cuando la cámara
(o un ProceduralSource2D/3D) está dentro de Loading Range: se leen en otro hilo y se meten
en la escena unos pocos nodos por frame. Cada unidad vuelve a su sitio entre sus hermanos, así
que el orden de dibujo no cambia. Las celdas a más de un cuarto más del alcance se van.
- Las conexiones de señales se hacen cuando los dos extremos están en la escena. Una conexión entre dos celdas se guarda en las dos, y se hace cuando llega la segunda.
- Un
NodePathque apunta a una celda que no está cargada no encuentra nada hasta que se cargue. - Un nivel partido que carga el juego tiene solo parte de sus nodos: guardarlo desde el juego se rechaza, para no perder sus celdas.
El presupuesto
Sección titulada «El presupuesto»Project Settings > World > Streaming > Frame Budget Ms (2 ms por defecto) es el tiempo por frame que puede usar, entre todo, lo que carga el mundo: generadores y niveles partidos. Una pieza de trabajo (el grafo de una celda, meter unos nodos en la escena) empieza solo si lo que se espera que tarde cabe en lo que queda. Para que ninguno se pare, en cada frame uno de ellos, por turnos, puede hacer una pieza igualmente.
Una copia de landwork con una isla de 16384×16384 px, hecha por sus cinco generadores:
| Todo de una vez (Manually) | Por celdas (At Runtime) | |
|---|---|---|
| Hasta el primer frame | 19,3 s | ~2 s |
| fps | 3 | ~150 quieto, 110-137 cruzándola |
| Nodos vivos | 73.110 | ~2.500 |
| Memoria | 603 MB | 68-82 MB |