2nd/00_Raw/2026-04-26-Skybound_Tactical_Bomb_SFX_Routing_Fix.md

Skybound Tactical Bomb SFX Routing Fix

작성일: 2026-04-26 15:14 KST

요청 요약

• 폭탄을 사용할 때 효과음이 들리지 않는다.
• 시각 효과는 있는데 폭탄 사용의 타격감이 부족하다.

핵심 문제

폭탄 사운드 자체는 AudioManager.playTacticalBomb()에 이미 절차적 사운드로 구현되어 있었다.

하지만 실제 폭탄 사용 시 PlayerSystem은 bomb-trigger라는 SFX 이벤트를 발생시키고 있었고, useGameEngine의 SFX 라우터는 이 이벤트를 별도로 처리하지 않았다.

그 결과:

• bomb-trigger가 일반 playSFX('bomb-trigger')로 전달되었다.
• bomb-trigger라는 이름의 로드된 오디오 버퍼가 없었다.
• 따라서 폭탄 발동 시 실제 사운드는 재생되지 않았다.

적용한 변경

폭탄 이벤트 직접 라우팅

useGameEngine의 SFX 이벤트 처리에 bomb-trigger 분기를 추가했다.

변경:

• bomb-trigger 이벤트 수신 시 audioManager.playTacticalBomb() 직접 호출

의도:

• 폭탄 사용 즉시 절차적 폭발 사운드가 재생되게 한다.
• 외부 wav 파일 없이도 일관된 폭탄 사운드를 보장한다.

AudioManager fallback 라우팅 추가

AudioManager.playSFX()에도 bomb-trigger와 tactical-bomb 이름을 폭탄 사운드로 라우팅했다.

의도:

• 다른 시스템에서 playSFX('bomb-trigger')를 직접 호출하더라도 무음이 되지 않게 한다.
• 폭탄 사운드 이벤트 이름이 여러 경로에서 사용되어도 안전하게 동작하게 한다.

Mute 처리 보강

playTacticalBomb()에 mute 상태 체크를 추가했다.

의도:

• 다른 SFX와 동일하게 mute 상태에서는 폭탄 사운드도 재생되지 않게 한다.

수정 파일

• /Volumes/Data/project/Antigravity/Skybound/src/features/game/audio/AudioManager.ts
• /Volumes/Data/project/Antigravity/Skybound/src/features/game/hooks/useGameEngine.ts

검증

• npm run build 성공
• 출력 디렉터리: dist/36

후속 플레이테스트 체크 포인트

• Space 또는 폭탄 입력 시 폭발음이 즉시 들리는지 확인한다.
• 폭탄 시각 효과와 사운드 타이밍이 잘 맞는지 확인한다.
• 폭탄 사운드가 너무 크거나 BGM을 과하게 덮지 않는지 확인한다.
• mute 상태에서 폭탄 사운드가 재생되지 않는지 확인한다.