Arena 3D
En este tutorial haces una arena 3D: controlas a un personaje en una plataforma, los enemigos llegan en oleadas y te persiguen, y tienes que aguantar 60 segundos sin morir. Puedes golpear a los enemigos cercanos con Espacio.
Es la continuación del Plataformas 2D. Aquí el foco está en la concurrencia y el estado reactivo:
- La escena lanza las oleadas con una corrutina (
spawn,loop { },await sleep(...)). - Los enemigos encuentran al jugador con
await GetWorld.Spawned("player"). - La vida de cada enemigo es una variable
livey muere conupon hp <= 0 { }. - “Aguanta 60 segundos o muere” es un
race { }.
1. Crea el proyecto
Sección titulada «1. Crea el proyecto»Crea un proyecto 3D nuevo desde el gestor de proyectos. Como en el tutorial anterior, los
archivos van en resources/ y Gobu los encuentra por nombre de archivo.
2. El input
Sección titulada «2. El input»Crea tres recursos de Enhanced Input:
move.inputaction:value_type=VALUE_TYPE_AXIS_2D.attack.inputaction:value_type=VALUE_TYPE_BOOL, con unInputTriggerPressedpara que dispare una sola vez por pulsación.combat.inputcontext: unInputMappingContextcon estos mapeos:
| Tecla | Acción | Modificadores |
|---|---|---|
| D | move | ninguno |
| A | move | InputModifierNegate |
| W | move | InputModifierSwizzle |
| S | move | InputModifierSwizzle + InputModifierNegate |
| Espacio | attack | ninguno |
move da un Vector2: x es izquierda/derecha y y es adelante/atrás. En 3D, “adelante”
es -Z, así que el jugador lo convierte a Vector3(x, 0, -y).
3. La interfaz arena
Sección titulada «3. La interfaz arena»La vida del jugador, el tiempo que queda y el mensaje final los escriben la escena y los
enemigos, y los lee el HUD. Van en una interfaz global, arena.iface.gro:
interface arena global { live health : int = 100 { set(value): field = clamp(value, 0, 100) } live time_left : int = 60 live message : String = ""
fn apply_damage(value: int) void { set health -= value }}El setter mantiene health entre 0 y 100. Como health es live, set además avisa a
quien la observe con watch.
4. El prefab del jugador
Sección titulada «4. El prefab del jugador»Crea player.prefab:
Player(CharacterBody3D), la raíz, a un metro sobre el suelo.MeshInstance3Dcon una CapsuleMesh.CollisionShape3Dcon una CapsuleShape3D.
Su código:
module Player
use actor::Player as player : CharacterBody3Duse input::combat as controls
@editable mut speed : float = 6.0@editable mut attack_range : float = 2.5
fn _ready() void { controls.enable(0)}
fn _physics_process(_delta: float) void { input : Vector2 = controls.move.value() player.velocity = Vector3(input.x, 0.0, -input.y) * speed player.move_and_slide()}
on controls.attack.triggered() { for e in GetWorld.SpawnedAll("enemy") { enemy : Spatial3D = e as Spatial3D if enemy.global_position.distance_to(player.global_position) < attack_range { e.hit(1) } }}module Playerle da al jugador la etiquetaplayer. Los enemigos la usan para encontrarlo.GetWorld.SpawnedAll("enemy")devuelve, en ese momento, la lista de enemigos de la escena.e.hit(1)llama a una funciónpubdel código del enemigo (la verás en el paso siguiente).
5. El prefab del enemigo
Sección titulada «5. El prefab del enemigo»Crea enemy.prefab:
Enemy(CharacterBody3D), la raíz.MeshInstance3Dcon una BoxMesh (dale un material rojo para distinguirlo).CollisionShape3Dcon una BoxShape3D del mismo tamaño.
Su código:
module Enemy
use actor::Enemy as body : CharacterBody3Duse interface::arena as arena
@editable mut speed : float = 3.0@editable mut damage : int = 10
live hp : int = 3mut cooldown : float = 0.0
@onready target : Actor = await GetWorld.Spawned("player")
pub fn hit(amount: int) void { set hp -= amount}
upon hp <= 0 { body.destroy()}
fn _physics_process(delta: float) void { if target == null { return } goal : Vector3 = (target as Spatial3D).global_position mut dir : Vector3 = goal - body.global_position dir.y = 0.0 if dir.length() < 1.5 { body.velocity = Vector3.ZERO cooldown -= delta if cooldown <= 0.0 { arena.apply_damage(damage) cooldown = 1.0 } } else { body.velocity = dir.normalized() * speed } body.move_and_slide()}@onready target : Actor = await GetWorld.Spawned("player")espera a que exista un actor con la etiquetaplayer. Hasta entoncestargetesnull, por eso_physics_processlo comprueba primero.hpeslive:set hp -= amountlo cambia y avisa.upon hp <= 0 { }se ejecuta una sola vez, la primera vez que la condición es cierta. No hace falta comprobar la vida después de cada golpe.- Cuando el enemigo está pegado al jugador, le quita vida una vez por segundo a través de la
interfaz
arena. No sabe nada del HUD.
6. El HUD
Sección titulada «6. El HUD»Crea HUD.uip:
HUD(Control), la raíz, a pantalla completa.Health(Label), arriba a la izquierda.Time(Label), arriba a la derecha.Message(Label), centrado, con el texto vacío.
Su código:
module HUD
use actor::Health as health_label : Labeluse actor::Time as time_label : Labeluse actor::Message as message_label : Labeluse interface::arena as arena
@onready watch arena.health(value: int) { health_label.text = $"HP: {value}"}
@onready watch arena.time_left(value: int) { time_label.text = $"{value} s"}
watch arena.message(value: String) { message_label.text = value}7. La escena de la arena
Sección titulada «7. La escena de la arena»Crea arena.scene y márcala como escena principal:
Arena(Spatial3D), la raíz.Floor(StaticBody3D) con unMeshInstance3D(PlaneMesh de 30 × 30) y unCollisionShape3D(BoxShape3D fina del mismo tamaño).DirectionalLight3D, inclinada, con sombras si quieres.Camera3Dalta y mirando hacia abajo al centro de la arena.- Una instancia de
player.prefaben el centro.
El código de la escena dirige la partida:
module Arena
use interface::arena as arenause ui::HUD as hud_uiuse prefab::enemy as enemy_prefab
SURVIVE_TIME :: 60SPAWN_RADIUS :: 12.0
mut waves : GrostFunctionState = null
async fn _ready() void { UiManager.show(hud_ui)
waves = spawn spawn_waves() won : bool = race { await survive() await player_dies() } waves.cancel() for e in GetWorld.SpawnedAll("enemy") { GetWorld.despawn(e) }
if won == true { set arena.message = "¡Sobreviviste!" } else { set arena.message = "Has caído" } await sleep(3.0) InterfacesManager.clear() SceneManager.restart()}
async fn spawn_waves() void { mut wave := 1 loop { for i in range(wave * 3) { spawn_enemy() } await sleep(8.0) wave += 1 }}
fn spawn_enemy() void { angle : float = randf() * TAU mut enemy := GetWorld.spawn("enemy") enemy.position = Vector3(cos(angle) * SPAWN_RADIUS, 1.0, sin(angle) * SPAWN_RADIUS) GetWorld.add_child(enemy)}
async fn survive() bool { for s in range(SURVIVE_TIME) { set arena.time_left = SURVIVE_TIME - s await sleep(1.0) } set arena.time_left = 0 return true}
async fn player_dies() bool { loop { if arena.health <= 0 { return false } await next_frame() }}Paso a paso:
_readyusaawait, así que esasync fn.spawn spawn_waves()arranca la corrutina de oleadas sin esperarla y guarda la tarea enwaves. La corrutina es unloop { }infinito: cada oleada trae tres enemigos más que la anterior, con 8 segundos entre oleadas.race { }ejecutasurvive()yplayer_dies()a la vez. La primera en terminar gana, la otra se cancela, ywonrecibe el valor de la ganadora:truesi aguantaste,falsesi caíste.waves.cancel()detiene las oleadas, yGetWorld.despawnquita a los enemigos que quedan.- Tras tres segundos,
InterfacesManager.clear()devuelve la interfaz a sus valores iniciales ySceneManager.restart()recarga la escena.
8. Ejecuta
Sección titulada «8. Ejecuta»Pulsa ejecutar. Muévete con WASD y golpea con Espacio a los enemigos que se acercan: tres golpes y desaparecen. El contador baja de 60 a 0; si llega a cero, ganas. Si tu vida llega a 0 antes, pierdes. En los dos casos la partida vuelve a empezar a los tres segundos.
Ideas para seguir
Sección titulada «Ideas para seguir»- Pon la vida de cada enemigo en una interfaz por instancia (sin
global) para que una barra de vida sobre su cabeza la observe conwatch. - Usa
defer { }enspawn_wavespara hacer algo cuando la corrutina se cancele. - Guarda la oleada máxima alcanzada con
@persistent, como en el tutorial anterior.
| Usaste | Capítulo |
|---|---|
async fn, await, spawn, loop { }, sleep, next_frame, race { }, cancel() | Concurrencia |
live, set, watch, upon | Estado reactivo |
| Interfaces globales con setter y funciones | Interfaces |
use actor::, GetWorld, UiManager, SceneManager | Importar con use |
pub fn | Funciones |
@onready, @editable | Anotaciones |
| Acciones, disparadores, modificadores | Input |