Logic Bricks son el sistema de scripting visual de Cave.

Te permiten crear comportamientos de juego conectando nodos en lugar de escribir código Python directamente.

Esta lección introduce qué son los Logic Bricks, dónde se encuentran, cómo funcionan y cuándo deberías usarlos. Aprenderás el sistema completo en lecciones más profundas más tarde, pero esta visión general te ayudará a entender dónde encajan los Logic Bricks en el flujo de trabajo de Cave.

Video Tutorial

Tenemos un Video Tutorial completo sobre cómo empezar con los Logic Bricks. Te recomendamos que lo mires.

Ver en YouTube

Será un enfoque mucho mejor para aprenderlos en profundidad.

Pero si quieres continuar aquí, entonces hagamos una rápida introducción:

¿Qué Son los Logic Bricks?

Logic Bricks son gráficos de lógica visual que te permiten crear lógica rápidamente de forma visual, sin escribir código real.

Si estás familiarizado con otros enfoques de scripting visual como los Blueprints de Unreal Engine, cada brick es esencialmente un nodo. Pero para las convenciones de nomenclatura de Cave, se llaman Bricks. Los Bricks pueden representar muchos tipos de lógica:

• Eventos.
• Acciones.
• Valores.
• Matemáticas.
• Cadenas de texto.
• Utilidades del motor.
• Operaciones de entidad.
• Operaciones de componente.
• Referencias de activos.
• Funciones.

Construyes comportamientos conectando los bricks entre sí.

Si eres nuevo en la programación, los Logic Bricks pueden ser una forma amigable de empezar a crear interacciones porque puedes ver el comportamiento como un gráfico.

Por ejemplo, un gráfico simple podría significar:

Cuando el jugador toca este trigger:
  Abre una puerta.
  Reproduce un sonido.
  Desactiva el trigger.

Ese tipo de interacción es a menudo más fácil de entender visualmente que como un script largo cuando aún estás aprendiendo.

Esta No Es El Curso Completo de Logic Bricks

Esta lección es solo una visión general.

Los Logic Bricks pueden llegar mucho más allá de esto:

• Funciones.
• Control de flujo.
• Sockets de valores.
• Depuración en tiempo de ejecución.
• Comentarios.
• Bricks de manejo de activos.
• Gráficos reutilizables.
• Integración de máquinas de estado.

Esos temas merecen lecciones enfocadas más adelante.

Por ahora, el objetivo es entender el papel de los Logic Bricks: son una forma visual de construir comportamientos, conectar sistemas, prototipar interacciones y hacer que los objetos del juego respondan a eventos.

Si quieres un tutorial completo sobre Logic Bricks, por favor mira esto.

Activos de Logic Bricks

Un gráfico de Logic Bricks es un activo. Lo creas en el Navegador de Activos, igual que creas escenas, scripts de Python, líneas de tiempo, materiales o plantillas de entidades.

Porque es un activo, puede ser:

• Nombrado.
• Organizado en carpetas.
• Seleccionado en el Navegador de Activos.
• Editado en la pestaña de Propiedades.
• Reutilizado por múltiples entidades.
• Guardado con el proyecto.

Esto es importante: el gráfico en sí es contenido del proyecto.

Por ejemplo, podrías crear un activo llamado Lógica de Puerta y usarlo en varias puertas. Más tarde, si mejoras el gráfico, esas puertas pueden compartir el comportamiento actualizado dependiendo de cómo estructures la configuración reutilizable.

Componente de Logic Bricks

Para ejecutar un activo de Logic Bricks en el juego, adjúntalo a una entidad con un Componente de Logic Bricks.

El componente elige qué activo de Logic Bricks debe usar. En tiempo de ejecución, el componente crea una instancia de ejecución del gráfico para su entidad propietaria.

Eso significa:

• El activo define el comportamiento compartido.
• Cada entidad obtiene su propia instancia en ejecución.
• El mismo gráfico puede ser reutilizado por múltiples entidades.

Esto es similar a cómo un script de Python reutilizable puede ejecutarse por separado en muchas entidades.

Logic Bricks Reutilizables

Los Logic Bricks son reutilizables, y esa es una de sus mayores fortalezas.

Por ejemplo, podrías crear un activo de Logic Bricks llamado Abrir Puerta. Luego varias entidades de puerta podrían usar ese mismo gráfico.

La lógica reutilizable funciona bien cuando:

• Muchos objetos comparten el mismo comportamiento.
• Cada objeto necesita valores locales ligeramente diferentes.
• Quieres mejorar el comportamiento en un solo lugar.
• Quieres que el proyecto se mantenga organizado.

Esto es similar a cómo:

En lugar de copiar el mismo gráfico en muchos lugares, mantienes un activo de comportamiento y configuras cada entidad según sea necesario.

Propiedades de Logic Bricks

Los Logic Bricks pueden exponer propiedades.

Esas propiedades están sincronizadas en el Componente de Logic Bricks, donde pueden ser sobrescritas localmente.

Por ejemplo, un gráfico de daño reutilizable podría exponer:

• Salud Máxima.
• Cantidad de Daño.
• Tiempo de espera de Daño.
• Etiqueta objetivo.
• Si destruye el objeto después de activarse.

Entonces, cada entidad que usa el gráfico puede tener diferentes valores.

Por ejemplo, una trampa de espinas puede causar poco daño, mientras que un volumen de lava puede usar la misma lógica con un daño mucho mayor.

Eventos de Flujo

La lógica generalmente comienza desde eventos.

Los eventos de flujo comunes incluyen:

Los eventos son los puntos de entrada del gráfico.

Sin un evento o algún otro desencadenante, el gráfico no tiene razón para comenzar a trabajar.

Flujo de Lógica

El flujo de lógica decide qué sucede y en qué orden. Los sockets de flujo conectan eventos y bricks de acción.

Por ejemplo:

Eso significa que la acción de impresión ocurre cuando comienza el gráfico.

La distinción importante para principiantes es:

Una vez que eso queda claro, los Logic Bricks se vuelven mucho más fáciles de leer.

Gráficos más complejos pueden ramificarse, retrasarse, programarse, llamar funciones, leer valores, modificar entidades y comunicarse con componentes.

Depuración en Tiempo de Ejecución

Los Logic Bricks pueden mostrar retroalimentación útil en tiempo de ejecución mientras se prueba.

Cuando la entidad propietaria se selecciona durante el Modo de Juego, los bricks y enlaces ejecutados pueden ser resaltados para que puedas ver qué se ejecutó:

La depuración en tiempo de ejecución puede ayudar a responder preguntas como:

• ¿Se ejecutó el evento?
• ¿Pasó la condición?
• ¿Se ejecutó la acción?
• ¿El gráfico llegó al objeto correcto?
• ¿Se imprimió un error en la Consola?

Si una puerta no se abrió, esta retroalimentación te ayuda a inspeccionar si se activó el evento desencadenante, si se pasó la condición y si la acción alcanzó la puerta.

Cuando seleccionas un logic brick después de probar el juego, también muestra en la esquina inferior izquierda de la pantalla cuántas veces se ejecutó y el tiempo de ejecución promedio.

Logic Bricks en Máquinas de Estado

Los Logic Bricks no solo se utilizan como componentes independientes. También pueden ser utilizados dentro de Máquinas de Estado.

Por ejemplo:

• Un estado de Máquina de Estado puede usar Logic Bricks para su comportamiento.
• Una transición puede usar Logic Bricks para su condición.

Las Máquinas de Estado se explican más adelante, pero es útil saber que los Logic Bricks pueden ser parte de sistemas de comportamiento estructurados más grandes.

Esto significa que puedes usar lógica visual para interacciones simples y también para comportamientos organizados como los estados de enemigos.

Cuándo Usar Logic Bricks

Los Logic Bricks son una buena opción para:

• Principiantes que aprenden lógica de juego.
• Diseñadores que prefieren lógica visual.
• Prototipos rápidos.
• Interacciones simples.
• Desencadenadores.
• Comportamiento de UI.
• Eventos de juego reutilizables.
• Conectar sistemas entre sí.

Ejemplos buenos para principiantes incluyen:

• Una placa de presión que abre una puerta.
• Un pickup que aumenta la salud.
• Un desencadenador que inicia una Línea de Tiempo.
• Un botón de UI que cambia escenas.
• Un peligro que daña al jugador.
• Un checkpoint que guarda una posición.

Para sistemas muy grandes o complejos, Python puede ser más fácil de organizar. Para muchas interacciones de juego, los Logic Bricks son rápidos, visuales y fáciles de inspeccionar.

Una Regla Simple

El scripting visual de Cave tiene una paridad uno a uno con la API de Python, lo que significa que cada función disponible a través del código también debería estar disponible a través de los Logic Bricks. Esto significa que puedes elegir libremente cuál prefieres para crear la lógica de tu juego. Es decir:

• Usa Logic Bricks cuando quieras ver el comportamiento como un gráfico.
• Usa Python cuando el comportamiento sea más fácil de expresar como código.
• ¡También puedes combinar ambos!

Ambos enfoques son parte de Cave, y muchos proyectos utilizan lógica visual para algunos sistemas y Python para otros.