wz-audio-bind

스타14

포크4

업데이트2026년 5월 26일 07:30

Use when the user wants a sound or music clip from `Sound.wz` wired to a runtime event — phrases like "play [X] sound", "play the BGM", "play the BGM from Sound.wz", "BGM from Sound.wz of maps", "mob sounds when it gets hit", "play the mob's sounds", "audio for [Wizet/Nexon/Title/login]", "Bgm for [Wizet/Nexon]", "play the map's BGM", "Sound.wz/[node]", or any reference to binding a Sound.wz node to a play trigger (map BGM swap on `SetField`, mob hit/die SFX, UI clicks, login map BGM, drop/pickup SFX). Locates the right Sound.wz subtree, identifies the trigger site, wires through the project's MonoGame audio service in `src/MapleClaude/Audio/` (XAudio2 — NOT BASS). Triggers NOT for WZ binary decode work (that's `wz-reader`) and NOT for inventing new sound effects with no Sound.wz source.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

출처

MujyKun

MujyKun/MapleClaude

GitHub 저장소 열기 Creator 저장소 보기

다운로드

관련 직업SOC

SOC 직업 분류 기준

소프트웨어 개발자컴퓨터 및 수학직·SOC 15-1252

SKILL.md

readonly

이 저장소의 다른 Skills

같은 저장소

authentic-ui-rebuild

MujyKun/MapleClaude

Use when the user wants a placeholder/custom UI overlay replaced with the authentic v95 client version sourced from the WZ assets + IDA database — phrases like "not the custom overlay", "not the placeholder", "we have a custom overlay right now, but it's not authentic", "authentic v95", "authentic [stat/inventory/equip/chat/skill/quest/family/system menu/NPC dialog/channel select/character profile/key config/buddy/party/guild/alliance/blacklist] window", "rebuild [UI] 1:1 from the IDB", "look up CUI[X] and rebuild it 1:1", "fix [UI screen] to match the IDB", "look into the proper IDB implementation", "use the natural UI and proper icons", "should reuse the [UIWindow*.img/...]", "look into the IDB for the proper [UI]". Walks the WZ subtree identification → `CUI*` class decompile via `ida-lookup` → coordinate extraction → C# rebuild loop. For full-screen rebuilds it escalates to the `v95-ui-rebuilder` agent; for origin extraction to the `ui-origin-finder` agent. Triggers ONLY for UI that exists in the original

2026-05-2614

autonomous-phase

MujyKun/MapleClaude

Use when the user explicitly hands off the phase queue and wants Claude to pick the next item from `docs/roadmap.md` and run it to completion, then loop — phrases like "continue with the next phase", "do the next phase", "do the next phase from the readme", "continue with the phases", "continue with the phases to be implemented from the readme", "auto-implement the rest of the phases", "on auto mode dont ask me about anything", "im going to bed", "keep going on the roadmap", "keep going", "auto-run the roadmap". Reads `docs/roadmap.md` for the next un-shipped phase, plans, implements (delegating to `authentic-ui-rebuild`, `ingame-feature`, `wz-audio-bind`, `wz-subsystem-research`, packet skills as needed), tests, and ships via `ship-pr` — which still asks for per-commit approval per CLAUDE.md (no blanket auto-commit). Loops to the next phase until interrupted, roadmap exhausted, or three consecutive failures. Triggers NOT for a single mid-flight task (just keep working) and NOT for short replies like "continu

2026-05-2614

ida-lookup

MujyKun/MapleClaude

Use when the user wants a single v95 client class, function, struct, or constant looked up — phrases like "look into the IDB", "look into the IDB for X", "reference the IDB", "look up CXxx", "look in the idb", "check the IDB for", "investigate it with the idb", "look into how the v95 client does X", "look into the proper IDB implementation", "find the function that does Y", "decompile CUI[X]", "the IDB for the proper [Y]", or anywhere the user implies "go ask the IDA database what the real client does here". Drives the live `ida-pro/idalib` MCP via `idb-bind`, runs the standard lookup_funcs → decompile → xrefs recipe, and surfaces a paraphrased answer with translated constants / coordinates / formulas — never the .i64 path, never raw decompiled C++ blocks pasted into committed files. Triggers ONLY for single-symbol queries; NOT for full WZ subsystem sweeps (use `wz-subsystem-research`) and NOT for full UI screen rebuilds (use `authentic-ui-rebuild`, which itself calls into this skill).

2026-05-2614

ingame-feature

MujyKun/MapleClaude

Use when the user wants a player or world feature implemented end-to-end (packets + animation + WZ assets + state) — phrases like "implement [combat / death / drop / pickup / NPC click / emotion / facial expression / damage / attack / knockback / tombstone / revive / collision / aggro / mob movement / loot / level up]", "research how a player dies", "ensure when the player's HP reaches 0 he dies", "we need to be able to hit mobs", "mobs should X when Y", "player should X when Y", "when [event] happens, [response]", "mob death animation", "drop to the ground", "pick it up should fly into the character", "play the mob's sounds when hit", "introduce facial expressions", "we want emotions when F1-F7 is pressed", or similar full-feature requests that cut across the packet layer + the IDB animation logic + the WZ assets + the runtime state. Coordinates calls into `client-packet-author`, `server-packet-mirror`, `ida-lookup`, `wz-audio-bind`, and `wz-subsystem-research`. Triggers NOT for UI windows alone (`authentic-

2026-05-2614

layering

MujyKun/MapleClaude

Use when the user reports — or wants to enforce — that an NPC, mob, character, or drop is rendering on the wrong z-layer relative to a map's tiles/objs/trees — phrases like "layering", "z-index", "z-order", "z order", "render order", "the player goes behind/in front of [the tree/the object/the platform]", "draw order is wrong", "entity is in the wrong layer", "obj covers the player", "tree is behind the mob", "foothold layer", "make NPCs/mobs/characters layer-aware", "honor the v95 layer model", "draw on the correct layer", "behind the [obj/wall/decoration]". Owns the 8-layer + per-layer-z draw model documented in `docs/map-wz.md`, the foothold→entity-layer mapping, and the canonical per-layer entity draw order used by `GameStage.DrawEntitiesAtLayer`. Triggers NOT for parallax-back sort order (that's the `back/front` flag inside `FieldScene.DrawBacks`) and NOT for shader depth-buffer questions (we are 2D — no real depth buffer).

2026-05-2614

layout-tune

MujyKun/MapleClaude

Use when the user wants to nudge an already-rendered UI element by a small amount — phrases like "move it [N]px [direction]", "move it 3px down", "lower it like 3px", "move it 2 pixels to the right, 4 down", "icon too high", "icon too low", "the [element] is wrong [direction]", "needs to be a bit higher", "needs to be a bit lower", "nudge [element]", "position is wrong", "the position is off", "needs to be [N]px [direction]". Redirects the user to the live debug overlay (`watch.ps1` + `MAPLECLAUDE_DEBUG=1`) for tuning without rebuild, and only when overlay tuning isn't possible, makes the smallest constant-edit in the right Stage/UI file. Triggers ONLY for nudging an existing element; NOT for adding new UI (use `authentic-ui-rebuild`) and NOT for reading WZ origins from scratch (use `ida-lookup` or the `ui-origin-finder` agent).

2026-05-2614

name

wz-audio-bind

description

wz-audio-bind

Many MapleClaude prompts ask to play a specific Sound.wz node when something happens — e.g. when a mob gets hit, when a map loads, when a button is clicked, when the Nexon / Wizet logo splash plays. This skill owns the binding recipe.

Sound.wz subtree map

The standard GMS v95 Sound.wz layout — find your node here first:

Subtree	Contents	Typical trigger
`Sound.wz/Bgm<region>.img/<track>`	Map BGM tracks (one .img per region: `BgmGL`, `BgmJp`, `BgmTW`, `BgmEvent`, …)	`SetField` decode → field's `info/bgm` string changed
`Sound.wz/BgmUI.img/{NxLogoMS,WzLogo,Title,SelectChar,SelectWorld,CashShop,…}`	UI BGM	Splash screens, title, login map, char select
`Sound.wz/Mob.img/<mobId:D7>/{Damaged,Die,Attack1,Attack2,Skill,…}`	Per-mob SFX	`CMob`-equivalent runtime hit / die / attack states
`Sound.wz/UI.img/{BtMouseClick,BtMouseOver,DlgNotice,WorldSelect,CharSelect,ChatBoxClick,…}`	UI SFX	Button click / hover, dialog open, chat send
`Sound.wz/Field.img/{Portal,Drop,Pickup,Jump,LevelUp,…}`	Field SFX	Portal use, drop landing, pickup, level-up
`Sound.wz/Game.img/{Effect, GameLose, GameWin, …}`	Misc game SFX	Damage skin, KO, victory
`Sound.wz/Itemeff.img/<itemId:D8>/{Use,Effect,…}`	Per-item SFX	Consumable / scroll effect

If you don't see your node here, the wz-reader skill can decode and dump the tree structure of a target .img.

Procedure

1. Identify the node

State the full WZ path the user wants. If the user said "mob sounds when it gets hit", that's Sound.wz/Mob.img/<mobId>/Damaged (the per-mob image is keyed by the 7-digit mob id; if the per-mob image is missing, fall back to the global Sound.wz/Mob.img/Damaged).

If the trigger is a map BGM, read the map's info/bgm string (format "<region>/<track>", e.g. "BgmGL/AmorianChallenge"); the runtime resolves it to Sound.wz/Bgm<region>.img/<track>.

2. Identify the trigger site in code

Common trigger sites in the project:

Event	File / class	Pattern
Map BGM swap	`src/MapleClaude/Stages/GameStage.cs` / `FieldScene`	On `SetField` decode, compare new `bgm` string vs current; if changed, fade out old `Song`, play new
Mob hit / die	`src/MapleClaude/Character/MobInfoService.cs` or the mob runtime	`MobDamaged` decode → look up `Sound.wz/Mob.img/<id>/Damaged` → `SoundEffect.Play()`; `MobInfo.Sounds` precomputed via `MobSoundService`
UI click	`src/MapleClaude/UI/` widgets	Inside Button.OnClick — uniform path; the widget already exposes a `Click` event
Login splash BGM	`src/MapleClaude/Stages/{NxLogoStage,WizetLogoStage,TitleStage}.cs`	OnEnter → start the matching `Sound.wz/BgmUI.img/<…>` Song
Drop landing / pickup	`src/MapleClaude/Map/DropPool.cs` (or equivalent)	On drop spawn → Field/Drop; on pickup → Field/Pickup

3. Decode the WZ sound node

The decode flow is owned by MapleClaude.Wz:

WzPackage.GetNode("Sound.wz/<path>") returns a WzSound.
WzSound.AsMp3() / .AsWav() (whichever the project exposes) — see existing decoded samples for the canonical call pattern.
Cache the decoded buffer; sound nodes are immutable.

4. Wire to MonoGame audio

MonoGame integration lives at src/MapleClaude/Audio/ (XAudio2 backend — the v83 reference client used BASS; do NOT port BASS calls).

BGM (long, looping): decoded buffer → MonoGame Song → MediaPlayer.Play(song). Set MediaPlayer.IsRepeating = true for map BGM.
SFX (short, fire-and-forget): decoded buffer → MonoGame SoundEffect → SoundEffect.CreateInstance().Play() (or SoundEffect.Play() for one-shot).
Cross-fade BGM: at minimum, stop the old song before starting the new one. If the current AudioService supports fade-out, use it.

5. Honor system options

The system options window (CUISysOpt) carries BGM volume / SFX volume / mute toggles — reading from the same options store the rest of the app uses. Don't bypass it; if the user has BGM muted, the call must respect that.

6. Verify

dotnet build passes.
Trigger the event in the live client via watch.ps1; the sound plays through XAudio2.
For BGM, confirm the map change ACTUALLY swaps the track (vs starting a second one layered on top — that's the common bug).

What to avoid

Inventing sounds with no Sound.wz source. If the user wants a sound the WZ doesn't carry, surface that fact instead of synthesizing one.
Using Console.Beep or any non-WZ fallback for "I couldn't find the node".
Polluting the audio service with stage-specific globals; route everything through the existing service.
Decoding the same buffer twice — cache.

Privacy

No .i64 paths, no private project names. The same rules from pr-privacy-guard.local apply.
The v83 reference uses BASS; do NOT mention the v83 client by name in committed text (it's a private-machine reference).

Related skills

wz-reader — owns the binary-format decode side (WzSound, AES, version hash). Call this skill for any decode-format questions.
ida-lookup — for "what triggers this sound in the original client". The IDB has the CMobSoundMan / equivalent for mob SFX timing.
ingame-feature — feature implementations often need to bind a sound; that skill delegates here.
wz-subsystem-research — for the broader subsystem this sound is part of (e.g. the Mob.wz sweep already mapped the sound subtree).

Linked memories

[[ingame-camera-rendering]], [[mob-wz-attributes]], [[ingame-system-menu]], [[ingame-ui-windows]].