Godot: sistema de audio (música por bioma + SFX mapeados a señales)

[leocagli]

Objetivo

Implementar el sistema de audio con música ambiental por bioma, SFX mapeados a señales del juego y ajustes de volumen persistidos.

Alcance

• Buses de audio: Master, Music (−6 dB), SFX (0 dB)
• Música: loops ambientales por bioma dominante (pradera, desierto, tundra, océano), crossfade suave
• SFX: mover unidad, atacar, construir ciudad, finalizar turno, victoria, derrota, wallet conectada
• Volumen configurable en menú de opciones, guardado con ConfigFile
• Silencio automático al perder el foco de la ventana (pestaña del navegador en segundo plano)

Skill de referencia

/godot-audio-systems

Tareas

• Configurar buses en AudioServer y guardar layout en audio_bus_layout.tres
• MusicManager.gd autoload: play_biome(biome) con tween de volume para crossfade
• SFXLibrary.gd: diccionario { "unit_move": preload(...), "attack": preload(...), ... }
• AudioManager.gd: suscribirse a EventBus y llamar play_sfx(key, position) con atenuación 2D
• OptionsMenu.tscn: sliders para Music/SFX/Master conectados a AudioServer.set_bus_volume_db
• _notification(NOTIFICATION_APPLICATION_FOCUS_OUT): silenciar Music bus

Aceptación

La música cambia de loop al moverse a una región de bioma diferente, los SFX suenan en la posición del evento en el mapa y los ajustes de volumen persisten entre sesiones del navegador.

🎁 Evidencia = reward mayor

• Si tu PR incluye capturas de pantalla mostrando esto andando end to end, entra a reward de GrantFox en esta issue.
• Si además sumás un video demo corto, califica para reward mayor.
• No es obligatorio, pero pesa mucho en la evaluación.

Qué conviene mostrar en esta issue:

• Video con audio moviendo una unidad de una región de bioma a otra, para que se escuche el crossfade entre los loops de MusicManager.
• Video con audio de varios SFX disparados desde EventBus (mover unidad, atacar, fundar ciudad, finalizar turno) donde se note la atenuación 2D según la posición del evento en el mapa.
• Captura del OptionsMenu con los sliders de Master, Music y SFX, más un clip que muestre que el valor persiste al recargar la pestaña del navegador y que la música se silencia al perder el foco.

Pegá las capturas directo en la descripción del PR, arrastrándolas al cuadro de texto de GitHub.

[Glam26]

i want to handle this

[Glam26]

I'd like to be assigned to this issue.

My approach is to first understand the existing implementation, then deliver a solution that is consistent with the project's architecture, well-tested, and easy to review. I'll also document any changes that affect behavior or developer workflows.

[Glam26]

I'd like to be assigned to this issue.

My approach is to first understand the existing implementation, then deliver a solution that is consistent with the project's architecture, well-tested, and easy to review. I'll also document any changes that affect behavior or developer workflows.

[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.

[Truphile]

kindly assign me to this

[Truphile]

/assign

[grantfox-oss]

🦊 GrantFox — @Truphile has been assigned to this issue!

Next steps:

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

Good luck! Track your progress on GrantFox.

[Truphile]

@leocagli couldn't reach out anywhere, do we get paid from your repository? I have not been rewarded for the wave