ingame-feature

Stars14

Forks4

UpdatedMay 26, 2026 at 07:30

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-

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

MujyKun

MujyKun/MapleClaude

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

More from this repository

same repository

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

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

wz-audio-bind

MujyKun/MapleClaude

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.

2026-05-2614

name

ingame-feature

description

ingame-feature

The biggest pattern after "look it up in IDB" — implementing a player or world feature end-to-end. Examples from recent prompts: "player dies → tombstone → revive UI", "mob death animation", "mobs hit us and knock us back", "facial expressions on F1-F7", "drop to ground with spin animation", "pick up flies into the character", "play mob sounds when hit".

These cut across multiple layers:

Packet layer — OpCodes.cs + Kinoko handler/builder + C# encoder/decoder.
IDB animation/state logic — what the original client does for the visual / state transition.
WZ assets — sprites, sounds, animation timings.
Runtime state — Character/, Map/, UI/Game/, Stages/GameStage.cs.

This skill coordinates the per-layer skills so all four stay aligned.

Procedure

1. Map the feature to its opcodes

Find the involved opcodes from src/MapleClaude.Net/Packet/OpCodes.cs + Kinoko handlers. Standard table (expand as features land):

Feature	C→S opcodes	S→C opcodes
Player melee attack	`UserMeleeAttack` (47)	`UserMeleeAttack` (remote, 184), `MobDamaged`
Mob hit you	(none — server-pushed)	`UserHit` (48 in/out variant), `UserStatChange` (HP)
Mob move	(controller pushes back)	`MobMove` (231), `MobMoveCtrlAck`
Mob die	(none)	`MobDamaged` w/ death flag, `MobLeaveField`
Player move	`UserMove` (44/0x2C)	`UserMove` remote (210)
NPC click → dialog	`UserSelectNpc`, `UserQuestRequest`, `UserScriptMessageAnswer`	`ScriptMessage`, `OpenShopDlg`
Drop appears	(none)	`DropEnterField`, `DropLeaveField`
Drop pickup	`DropPickUpRequest`	`InventoryOperation` (28), `MoneyOperation`, `DropLeaveField`
Drop to ground from inventory	`UserChangeSlotPositionRequest` (77/0x4D, `newPos=0`)	`InventoryOperation`, `DropEnterField`
Emotion (facial expression)	`UserEmotion` (56/0x38)	`UserEmotion` remote
Player death	(server-side detection)	`UserHP` to 0, `MigrateCommand` to tomb / town
Revive	`UserReviveRequest` / via dialog	`ReviveResult`, `SetField` to revive map
Skill cast	`UserSkillUseRequest`	`UserSkillEffect` (remote), `MobAffected`
Stat change	(server-only)	`UserStatChange` (30 — dual-decode), `Message` (38 — money/loot popups)
Portal use	`UserTransferFieldRequest` (41/0x29)	`SetField` (141/0x8D)

Use the server-packet-mirror skill for any S→C opcode the project doesn't yet decode, and client-packet-author for any C→S opcode it doesn't yet emit.

2. Look up the IDB animation / state logic

Delegate to ida-lookup for the relevant runtime class(es):

Feature	IDB class / method
Mob hit	`CMob::OnDamaged`, `CMob::Hit`, `CMob::DoSkill`
Mob die	`CMob::OnDead`, removeAfter timing
Mob sounds	`CMobSoundMan`, `CMob::PlaySound`, `Sound.wz/Mob.img/<id>/<state>`
Mob touch / collision damage	`CMob::CheckTouchEvil`, `CUserLocal::OnTouchMob`
Mob aggro	`CMob::Update`, `CMob::IsAggroed`, look for `aggro` xrefs
Player attack	`CUserLocal::TryDoingMeleeAttack`, `CUserLocal::DoAttack`
Player hit / knockback	`CUserLocal::OnHit`, knockback velocity computation
Player die	`CUserLocal::OnDead`, `CUITombstone`, `CUIRevive`
Player emotion	`CUserLocal::SetEmotion`, `CAvatarLook::SetEmotion`, expression duration
Drop appear	`CDropPool::Create`, `CDrop::Init` (toss-fall-bob anim)
Drop pickup	`CUserLocal::TryPickUpDrop`, `CDrop::OnPickUp` (fade + move toward body)
NPC click	`CNpc::OnTouch`, `CWvsContext::OnSelectNpc`

3. Look up the WZ assets

Common asset paths:

Feature	WZ assets
Mob actions	`Mob.wz/<mobId:D7>.img/{stand,move,attack1..N,hit1,die1,fly,…}` (frames + delays)
Mob sounds	`Sound.wz/Mob.img/<mobId>/{Damaged,Die,Attack1,…}`
Drop visual	`Item.wz/...` icon, `Map.wz/MapHelper.img/drop` for shadow/anim
Drop sound	`Sound.wz/Field.img/Drop`, `Sound.wz/Field.img/Pickup`
NPC sprite	`Npc.wz/<npcId:D7>.img/<state>`
NPC dialog frame	`UIWindow2.img/UtilDlgEx`
Emotion face	`Character.wz/Face/<faceId:D8>.img/<emote>` (smile, blink, cry, …)
Tombstone	tombstone canvas (find via `ida-lookup` for `CUITombstone`)
Revive UI	`UIWindow2.img/Revive`

Delegate to wz-audio-bind for any Sound.wz binding. For a brand-new subsystem the project hasn't typed yet, delegate to wz-subsystem-research.

4. Implement in C#

Layered file placement:

src/MapleClaude.Net/Handlers/        <- packet decoders
src/MapleClaude.Net/Senders/         <- packet encoders
src/MapleClaude/Character/           <- player + mob runtime
src/MapleClaude/Map/                 <- foothold, portals, drops, field state
src/MapleClaude/UI/Game/             <- HUD, dialogs, popups
src/MapleClaude/Stages/GameStage.cs  <- wiring + per-feature glue

The project already has many half-built feature files (e.g. MobInfo.cs, MobAttack.cs, Revive.cs, TombstoneEffect.cs); prefer extending those over creating parallel ones.

5. Test it live

dotnet build + dotnet test.
Drive the feature in the live client via watch.ps1. Hot Reload picks up method-body edits; rude edits relaunch.
For network features, the running Kinoko server's logs are the ground truth — match the packet bytes the server sends/receives.

6. Save a memory entry

If the implementation made a non-obvious decision (e.g. "drops fall via VR clamp", "mob sounds bind via MobSoundService cache", "right-Ctrl needs separate scancode binding"), save a memory entry. See [[mob-wz-attributes]], [[drops-portals-rendering]], [[foothold-physics-idb]], [[keyconfig-1to1]] for examples.

Feature → asset / opcode quick reference

The most-requested in-game features in this project, with everything you need to start:

Feature	Opcodes	IDB	WZ	Memory
Mob hit / die / sound	`MobDamaged` (236), `MobMove` (231)	`CMob::OnDamaged`, `CMob::OnDead`, `CMobSoundMan`	`Mob.wz/<id>/{hit,die}`, `Sound.wz/Mob.img/<id>`	`[[mob-wz-attributes]]`
Collision damage	(S-pushed `UserHit`)	`CMob::CheckTouchEvil`, `CUserLocal::OnTouchMob`	mob `bodyAttack` flag	—
Drops ground anim	`DropEnterField`	`CDropPool`, `CDrop::Update` toss-fall-bob	`Item.wz/...`, `Map.wz/MapHelper.img/drop`	`[[drops-portals-rendering]]`
Drop to ground	`UserChangeSlotPositionRequest` newPos=0	`CUIItemInven::DropItem`	—	—
Pickup fly-to-body	`DropPickUpRequest`	`CUserLocal::TryPickUpDrop`, `CDrop::OnPickUp`	—	`[[drops-portals-rendering]]`
NPC click / dialog	`UserSelectNpc`, `ScriptMessage`	`CNpc::OnTouch`, `CUtilDlgEx`	`Npc.wz/<id>`, `UIWindow2.img/UtilDlgEx`, `String.wz/Npc.img/<id>`	`[[npc-quest-dialog]]`
NPC ambient bubble	(none)	`CNpc::DoSay`	`Npc.wz/<id>.img/info/speak`, `String.wz/Npc.img/<id>`	`[[quest-system]]`
Player emotion	`UserEmotion` (56)	`CUserLocal::SetEmotion`, `CAvatarLook::SetEmotion` (3+ second duration before blink resumes)	`Character.wz/Face/<id>.img/<emote>`	(new)
Player death	server detects HP=0	`CUserLocal::OnDead`, `CUITombstone`, `CUIRevive`	`UIWindow2.img/Revive`, tombstone canvas	(new)
Revive	`UserReviveRequest`	`CUIRevive`, `CWvsContext::OnReviveResult`	revive dialog canvas	(new)
Skill cast	`UserSkillUseRequest`	`CUserLocal::DoSkill`, `CSkillEffect`, `CCharLook::PlayAction`	Skill.wz cast/effect anims	`[[skill-window-system]]`
Stat change	(S-only)	dual-decode `StatChanged(30)` + `Message(38)`	—	`[[statchanged-dual-decode]]`
Foothold / wall	(S-only)	`CFoothold::*`, `m_lZMass`, `BoundPosMapRange`	`Map.wz/<map>/foothold`	`[[foothold-physics-idb]]`
Body action / climbing	(none)	`CCharLook` clock-driven delays, ladder/rope 2-frame back	`Character.wz/<body>/<action>`	`[[body-animation-actions]]`

Privacy / safety

All the standard pr-privacy-guard.local forbidden tokens apply.
IDB lookups go through ida-lookup, which enforces no path leakage.
v83 reference patterns are read-only; never name the v83 client in committed text.

Verification

Before declaring a feature done:

dotnet build clean.
dotnet test clean (existing tests + any new ones you added).
Live client demo: trigger the feature, watch the right packets fly, see the right animation play.
Logs are clean (no exceptions, no "unhandled opcode").
Memory entry saved if the feature taught us something non-obvious.

Related skills

client-packet-author — for new C→S packets.
server-packet-mirror — for new S→C handlers.
ida-lookup — for every IDB query in steps 2 and 3.
wz-audio-bind — for sounds.
wz-subsystem-research — for new typed models.
authentic-ui-rebuild — for any UI surfaces the feature adds.
layout-tune — for inevitable pixel nudges.
ship-pr — for shipping the feature.