Ir al contenido
Descargar
Guía de Gobu

Efectos rápidos

Una explosión cuando muere un enemigo, un anillo al recoger una moneda, humo saliendo de una chimenea: son efectos que se reproducen con una línea de código, sin preparar nada antes. EffectManager trae los efectos incorporados de GameMaker (“Do Effect”), con las mismas partículas y tiempos. Las partículas desaparecen solas.

fn morir() void {
EffectManager.play(EffectManager.EXPLOSION, position)
queue_free()
}
EfectoLo que se ve
EXPLOSIONbocanadas que salen disparadas, con un centro oscuro
RINGun anillo que crece y se desvanece
ELLIPSElo mismo, achatado
FIREWORKchispas en todas direcciones que caen
SMOKEbocanadas de humo que se quedan
SMOKE_UPbocanadas de humo que suben
STARuna estrella girada que se encoge
SPARKun estallido de rayos que se encoge
FLAREun destello que se encoge
CLOUDuna nube grande y plana que aparece y se desvanece
RAINlluvia por toda la pantalla
SNOWnieve por toda la pantalla

Después del efecto y la posición van tres valores opcionales: el tamaño (SMALL, MEDIUM por defecto, LARGE), el color (blanco por defecto) y si se dibuja encima (true, por defecto) o debajo del resto:

EffectManager.play(EffectManager.RING, position, EffectManager.LARGE, Color.CYAN)
EffectManager.play(EffectManager.SMOKE, position, EffectManager.SMALL, Color.GRAY, false)
EffectManager.play(EffectManager.STAR, position, color = Color.GOLD) # por nombre: mediano, encima
  • Encima tapa todo lo del mundo: personajes, tiles, objetos. La interfaz (en su propio CanvasLayer) queda por encima.
  • Debajo va detrás de los actores con el z_index por defecto (0). Para que se vea delante del fondo, dale al fondo un z_index menor (por ejemplo -10).
  • La posición es del mundo, como position o global_position: si la cámara se mueve, el efecto se queda donde ocurrió.
  • El alfa del color lo hace más transparente.

Cuando ninguno es lo que necesitas, haz el tuyo (los tipos de partícula de GameMaker): clic derecho en el dock FileSystem, Asset… > Resource > EffectType, guárdalo (chispas.resource) y ajústalo en el inspector:

GrupoLo que decide
ShapeUna de las 7 formas de los efectos (destello, bocanada, estrella, chispa, anillo, línea, copo) o una texture tuya
AmountCuántas partículas hace cada vez y el círculo donde aparecen
LifetimeCuánto vive cada una, entre un mínimo y un máximo (segundos)
MotionDirección y cuánto se abre (spread), velocidad, su cambio y gravity (píxeles por segundo)
RotationÁngulo al aparecer, spin (grados por segundo), align_to_direction
SizeEscala al aparecer, su cambio por segundo, stretch
Colorcolor_start y color_end (con alfa 0 se desvanece), additive para brillos

Un EffectType en el Inspector: los grupos Shape, Amount, Lifetime, Motion y Color abiertos, Rotation y Size plegados

Luego reprodúcelo con play_custom (o play_custom_3d en 3D):

use resource::chispas as chispas
fn golpe() void {
EffectManager.play_custom(chispas, position)
}

RAIN y SNOW cubren la pantalla, esté donde esté la cámara: la posición da igual, y el tamaño dice cuánto cae. Cada llamada suelta unas pocas gotas, así que llámalas en cada frame para que siga lloviendo:

fn _process(delta: float) void {
EffectManager.play(EffectManager.RAIN, Vector2.ZERO, EffectManager.MEDIUM, Color(0.6, 0.7, 1.0))
}

Los efectos se pausan con el juego y se quitan al cambiar de escena. Para quitarlos todos de golpe (deja de llover, termina el nivel):

EffectManager.clear()

play_3d reproduce los mismos efectos en el mundo 3D, en un Vector3: las partículas miran a la cámara, una pared delante las tapa y se ven más pequeñas con la distancia. Un píxel del efecto 2D es un centímetro, así que una explosión mediana mide alrededor de un metro. El humo sube y las chispas caen como en el mundo (arriba es arriba), haga lo que haga la cámara:

EffectManager.play_3d(EffectManager.EXPLOSION, global_position, EffectManager.LARGE, Color.ORANGE)

En 3D no hay encima ni debajo. RAIN y SNOW siguen cubriendo la pantalla.