msw-packages

Indexes official MSWPackages prebuilt packages and guides their integration into MapleStory Worlds projects.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/yoongang02/MapleFist --skill msw-packages-yoongang02
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: msw-packages
Source: https://github.com/yoongang02/MapleFist/tree/main/.agents/skills/msw-packages
Command: npx skills add https://github.com/yoongang02/MapleFist --skill msw-packages-yoongang02

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building standard game features like inventories, shops, rankings, or dialogs from scratch in MapleStory Worlds wastes effort when official prebuilt packages already exist. This Skill checks the MSW-Git/MSWPackages catalog first and guides integration instead of zero-from-scratch implementation. ## Core Features & Use Cases - Feature-to-Package Mapping: Matches user requests (toast, ranking, inventory, shop, mail, quest, dialog, save data, and more) to one of 20 official first-party packages. - Scope-First Routing: Distinguishes whether the user needs a full system (data + logic + UI) or just a UI screen, routing UI-only work to the msw-ui-system skill. - On-Demand Fetching: Pulls package READMEs, file trees, and raw source files from GitHub only when needed, keeping the catalog current automatically. - Integration Workflow: Maps package files into the project layout, checks UUID and sprite RUID collisions, resolves cross-package dependencies, and wires package APIs into existing scripts. - Use Case: A user asks for a leaderboard. The skill matches the ranking packages, fetches both basic and advanced READMEs, summarizes the differences, and after confirmation copies the Core files into RootDesk/MyDesk while regenerating colliding UUIDs. ## Quick Start Ask the AI to check the MSWPackages catalog for a prebuilt inventory system before writing one from scratch.

Frequently Asked Questions about msw-packages

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a prebuilt inventory or shop system in MapleStory Worlds?

Check the MSWPackages catalog for a matching package such as inventory-package or shop-package, fetch its README from GitHub, then copy the Core scripts into RootDesk/MyDesk after confirming integration. Verify UUID collisions before writing files.

What packages are available in MSW-Git/MSWPackages?

The catalog includes 20 first-party packages covering toast notifications, basic and advanced rankings, inventory, shop, world shop, mail, quests, dialog, key binding, game events, player data, collections, slash commands, scroll views, drop tables, global config, GM messages, resources, and UI components.

Should I use a prebuilt package or build a MapleStory Worlds feature from scratch?

Check the catalog first; if a package matches the requested feature, propose integration since it saves implementation effort. Build from scratch only when no package matches, the user explicitly requests it, or the repository is unreachable.

Does MSWPackages integration handle UUID collisions automatically?

No, collisions must be checked manually. Grep the workspace for entity ids and EntryKeys in incoming .ui and .model files before writing, and regenerate any colliding UUID with a fresh hex value.

Why is the .modpackage file not installing the package automatically?

The .modpackage file is Maker-editor metadata, not an auto-installer script. Actual integration requires manually copying the package's Core files into the project layout and wiring its Logic singleton API into existing scripts.

What happens if the MSWPackages GitHub repository is unreachable?

Confirm the URL has not changed and prefer WebFetch over direct curl for raw and API URLs, since sandboxed networks may block api.github.com. If all fetches fail, fall back to building the feature from scratch and inform the user.