Ir al contenido
Descargar
Guía de Gobu

Escenas, prefabs e interfaces

En Gobu no asignas scripts a actores sueltos. Cada documento tiene su propio código, y ese código corre sobre el actor raíz del documento.

ArchivoPara qué
.sceneUn nivel: qué aparece, la puntuación, el flujo de la partida
.prefabAlgo con comportamiento propio: jugador, enemigo, bala, moneda
.uipUna interfaz: menú, HUD, pantalla de pausa
.iface.groUna interfaz de datos de Grost, compartida entre documentos (capítulo 9)
.groUn script suelto: funciones, structs, código reutilizable

No hay extends ni class_name: el código del documento ya es el del actor raíz. Para usar un actor del documento lo importas con use actor:: (capítulo 6):

module Player
use actor::Player as root : CharacterBody2D
fn _physics_process(delta: float) void {
root.velocity = Vector2(200, 0)
_ = root.move_and_slide()
}

Solo el documento tiene código: un actor hijo no lleva script propio.

La página Code del prefab player: su código empieza con module Player y los use actor:: de sus actores

Todo lo que tiene comportamiento es un prefab

Sección titulada «Todo lo que tiene comportamiento es un prefab»

El jugador, cada enemigo, cada bala y cada moneda son prefabs, cada uno con su código. La escena los instancia y su propio código se limita a dirigir el nivel. Los menús y el HUD son .uip, no Labels añadidos a la escena.

El nivel: las monedas, los enemigos y la bandera son instancias de prefabs, marcadas con un cubo en el árbol

Un prefab colocado en el editor ya forma parte de la escena. Para crear instancias desde el código, impórtalo con use prefab:: por su nombre de archivo:

use prefab::enemy as enemy
fn _ready() void {
mut e := enemy.instantiate()
e.position = Vector2(100, 50)
GetWorld.add_child(e)
}

También puedes usar GetWorld.spawn("enemy") (capítulo 3). Los recursos se buscan por nombre, no por ruta: use prefab::enemy encuentra res://.../enemy.prefab esté en la carpeta que esté.

module <Nombre> le da nombre al código y también es su etiqueta. Con ella otro documento encuentra la entidad sin conocer su ruta en el árbol. Las etiquetas no distinguen mayúsculas de minúsculas: module Player se encuentra como "player".

@onready target : Actor = await GetWorld.Spawned("player")

Y para reaccionar a una señal de algo que aparecerá más tarde, on await (capítulo 7).

Un .uip tiene su código igual que cualquier documento: importa sus controles con use actor:: y reacciona con on:

use actor::start as start_button : Button
on start_button.pressed() {
SceneManager.load("level1")
}

El documento HUD.uip: sus controles en el árbol y sus páginas Viewport y Code

Más en Interfaces de usuario.