msw-ui-template
MSW UI Template Skill
Read style-specific template files as reference when building game UI.
Each style is a coherent bundle: .ui structure templates + matching
RUIDs (ruid-map.md) + button handler patterns (Popupbutton.mlua).
Pick a style first, then use its files together for visual consistency.
Style Selection Guide
Pick based on UI complexity and interaction pattern, not game genre.
| Folder | Visual Theme | Pattern | Best For | Key Features |
|---|---|---|---|---|
style-1-black/ |
Black | Simple Popups | Games with a few feature popups | Multiple popups, simple open/close buttons |
style-2-diary/ |
Diary | Minimal HUD | Lightweight or single-screen games | Minimal UI, result screen, drag-drop delete |
style-3-wood/ |
Wood | Multi-Tab | Games with many menus/features | Menu toggle, tab switching, many popup types |
style-4-blue/ |
Blue | Transaction Flow | Games with purchase/reward flows | Purchase confirmation, button fold/unfold, result panels |
File Structure Per Style
More from msw-git/msw-ai-coding-plugins-official
msw-general
Foundation skill for MSW (MapleStory Worlds). Read this FIRST before anything else in MSW.
111msw-scripting
Authoring MSW scripts (.mlua) plus integrated playtest and debugging. Covers mlua syntax, annotations (@Component/@Logic/@ExecSpace/@Sync), lifecycle, exec spaces, property sync, event system, file workflow, build-log inspection, error classification, and the test/debug loop. Keywords: script, mlua, lua, Component, Logic, annotation, ExecSpace, Sync, event, play, test, debug, lifecycle.
111msw-search
MSW search integration — (1) vector search for API docs and implementation guides via the msw-mcp MCP server (mlua_api_retriever / mlua_document_retriever), (2) REST API search for resources (sprite / animation / sound / resource pack / avatar). Use for 'find details, examples, or related APIs not in .d.mlua', 'need a SpriteRUID', 'monster sprite', 'background image', 'find a sound', 'avatar rendering', etc. Keywords: document search, API details, examples, guide, retriever, resource, sprite, animation, sound, RUID, resource pack, avatar.
110msw-defaultplayer
MSW DefaultPlayer (character) management. Directly read/modify the DefaultPlayer.model file, add/remove components, configure movement speed / jump force / HP / camera, and per-map-mode movement components. Use for DefaultPlayer model, player components, movement speed, jump force, HP, camera, physics. Keywords: player, DefaultPlayer, speed, jump, HP, camera, gravity, revive, respawn, character.
110msw-avatar
MSW avatar management — costume (CostumeManagerComponent, 17 slots) + animation 3-layer pipeline (StateComponent → AvatarStateAnimationComponent → AvatarRendererComponent). Four-level distinction: State key (uppercase) / AvatarBodyActionStateName (lowercase) / MapleAvatarBodyActionState enum / sprite action ID (swingO1, shoot1). Two mapping systems via IsLegacy/ActionSheet/StateToAvatarBodyActionSheet. When PlayerControllerComponent auto state transitions collide with ActionStateChangedEvent, resolve via RemoveActionSheet / SetActionSheet / BodyActionStateChangeEvent. Applies to any avatar-bearing entity (NPC, monster, etc.), not only DefaultPlayer. Use for avatar costume get/set, 17 equip slots, animation state mapping, action override, weapon-specific attack motion, custom shoot/cast/dance action. Keywords: avatar, costume, animation, state, action, shoot, swing, weapon, equipment, bow, sword, fire, slash, custom action, block auto playback, remap, ActionStateChangedEvent, BodyActionStateChangeEvent, RemoveActionSheet, SetActionSheet, StateToAvatarBodyActionSheet, AvatarStateAnimationComponent, AvatarRendererComponent, MapleAvatarBodyActionState, PlayerControllerComponent.
88msw-combat-system
MSW combat system integration guide. Covers the Attack→Hit pipeline, damage model, i-frame, knockback, Hit Stop, Camera Shake, Sprite Flash, SFX, death/revive, damage skin, hit effect, avatar combat motion, custom events, and AI FSM — all based on MSW native APIs for 2D multi-genre coverage. Keywords: attack, hit, damage, combat, monster, hit effect, critical, projectile, damage skin, knockback, hit stop, combo, HP bar.
88