Godot: arquitectura de señales y EventBus

[leocagli]

Objetivo

Definir un bus de eventos central (EventBus) con todas las señales del juego para desacoplar los sistemas entre sí.

Alcance

• Autoload EventBus.gd como única fuente de verdad de señales
• Señales de unidades: unit_moved, unit_attacked, unit_died, unit_promoted
• Señales de ciudad: city_built, city_captured, production_complete
• Señales de turno: turn_started, turn_phase_changed, turn_ended
• Señales Web3: wallet_connected, proof_generated, tx_confirmed, web3_error
• Señales de UI: hex_hovered, unit_selected, city_selected, panel_opened

Skill de referencia

/godot-signal-architecture

Tareas

• Crear autoloads/EventBus.gd con todos los signal declarados y tipados
• Añadir EventBus a la lista de autoloads en project.godot
• Documentar cada señal con un comentario de una línea y sus parámetros
• Crear scripts/EventBusTypes.gd con enums compartidos (Phase, TerrainType, UnitType)
• Validar que ningún nodo se suscriba directamente a señales de otro nodo (todo pasa por EventBus)

Aceptación

Todos los sistemas se comunican exclusivamente a través de EventBus; no hay llamadas directas entre escenas no relacionadas y el bus imprime en _DEBUG cada señal emitida si OS.is_debug_build().

🎁 Evidencia visual = reward extra

• Si tu PR incluye video demo o capturas de pantalla mostrando la funcionalidad pedida funcionando end-to-end, va a ser considerado para rewards de GrantFox en esta issue. No es obligatorio, pero suma mucho para la evaluación.

[Glam26]

I'd like to take this on.

I've worked on similar enhancements involving backend services, frontend features, and testing. I'll deliver a solution that aligns with the existing codebase, includes thorough test coverage, and is accompanied by clear documentation where necessary.

[Glam26]

I'd like to take this on.

I've worked on similar enhancements involving backend services, frontend features, and testing. I'll deliver a solution that aligns with the existing codebase, includes thorough test coverage, and is accompanied by clear documentation where necessary.

[Glam26]

I'd like to take this on.

I've worked on similar enhancements involving backend services, frontend features, and testing. I'll deliver a solution that aligns with the existing codebase, includes thorough test coverage, and is accompanied by clear documentation where necessary.

[Glam26]

I'd like to take this on.

I've worked on similar enhancements involving backend services, frontend features, and testing. I'll deliver a solution that aligns with the existing codebase, includes thorough test coverage, and is accompanied by clear documentation where necessary.

[gloskull]

Hi, I’d love to work on this issue. I have 4 years of experience across backend, frontend, full-stack, and smart contract development. I understand the task clearly and can deliver a clean, efficient, well-tested solution on time, with strong focus on code quality and maintainability. My PR will be submitted in under 10 hours.

[leocagli]

🟢 Reopened for assignment. The only interest so far was from accounts flagged for automated mass-claiming (gloskull, Glam26). This issue is open — comment /assign to take it.

[Vinaystwt]

I can take this.

I’ll add a centralized EventBus.gd autoload as the single place for game-wide signals, covering unit, city, turn, Web3, and UI event categories. I’ll keep the signals typed where practical, document every signal with its expected parameters, and add shared enum/type helpers only where they reduce ambiguity.

I’ll keep this scoped to decoupling architecture, not gameplay implementation. The goal is that scenes and managers communicate through EventBus instead of directly subscribing to each other, with optional debug logging in debug builds so emitted events are easy to trace.

[grantfox-oss]

🦊 GrantFox — @Vinaystwt has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #37)
2. Your PR will be reviewed by the Bitcoindefi maintainers

Good luck! Track your progress on GrantFox.