skills.rest
yoongang02
yoongang02COMMUNITY
Explore all skills by this author →
GitHub

msw-search

Searches MapleStory Worlds API documentation and game resources via vector search and REST API.

Updated Sep 11, 2026
Search Tags:#vector search#api documentation#sprite#mlua#resource search#maplestory worlds#ruid
One-click install
npx skills add https://github.com/yoongang02/MapleFist --skill msw-search-yoongang02
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: msw-search
Source: https://github.com/yoongang02/MapleFist/tree/main/.agents/skills/msw-search
Command: npx skills add https://github.com/yoongang02/MapleFist --skill msw-search-yoongang02

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? When building MapleStory Worlds games in mLua, developers lack detailed API descriptions, code examples, and a reliable way to obtain resource RUIDs for sprites, animations, sounds, and avatar items. This Skill provides two search paths: vector search over API docs and guides through the msw-mcp MCP server, and a REST API for resource lookup. ## Core Features & Use Cases - Document Search: Retrieve detailed API descriptions, code examples, related APIs, and implementation guides via the mlua_api_retriever and mlua_document_retriever MCP tools when .d.mlua stubs are insufficient. - Resource Search: Find sprites, animationclips, resource packs, BGM, voice, sound effects, and avatar items through a Node.js wrapper (scripts/msw_resource_api.cjs) covering search, similar-resource, detail, batch, tags, list, random, and pack endpoints. - Use Case: You need a monster asset for your game. Search with resourceTypeFilter set to resource_pack, fetch the pack details with getResource, then assign an element RUID from payload.elements to SpriteRendererComponent.SpriteRUID. ## Quick Start Ask the assistant to find an orange mushroom monster resource pack and show the API details for SpriteRendererComponent.

Frequently Asked Questions about msw-search

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

FAQPage Schema
How do I find a sprite or animation RUID in MapleStory Worlds?▼

Use the resource search REST API through the msw_resource_api.cjs wrapper, calling searchResources with resourceTypeFilter set to resource_pack first. Then call getResource on the pack id and pick an element RUID from payload.elements to assign to SpriteRendererComponent.SpriteRUID.

How do I get MapleStory Worlds API documentation and code examples?▼

Read the .d.mlua stub first for signatures and types, then call the msw-mcp tools mlua_api_retriever for API details and examples or mlua_document_retriever for implementation guides. The stubs lack descriptions, examples, and related-API cross-references that vector search provides.

What is the difference between sprite, animationclip, and resource_pack in MSW search?▼

A sprite is a static image, an animationclip is a frame-based animation, and a resource_pack bundles sprites, animations, and sounds for one asset. Search resource_pack first, since picking a lone sprite or animationclip often leaves the entity with a single frame or no animation set.

Why does my MSW resource search return zero results?▼

Zero results usually come from invalid category values like map, effect, or ui, which are not indexed. Use background or object for maps, sprite or animationclip with skill category for visual effects, and remember that effect is an audio resource type, not a category.

Why does my POST to the MSW resource API fail with a body parsing error?▼

The error occurs when JSON is sent inline via curl with non-ASCII characters. Use the msw_resource_api.cjs wrapper, which sends UTF-8 JSON bytes directly with the correct Content-Type header, avoiding the parsing failure for Korean, Japanese, or emoji queries.

Can I search MapleStory Worlds avatar items by keyword?▼

Yes, avatar costume items are searched through the same POST /v3/search/resources endpoint with resourceTypeFilter set to avataritem. The searchAvatarItems wrapper hard-codes this filter, and you can narrow results by slot categories like cap, coat, shoes, or weapon.

Related Skills

Explore More Software Engineering Skills→
MSW-GitMSW-Git
33

msw-defaultplayer

Inspect and patch DefaultPlayer models using the msw-general ModelBuilder.

Community
Intermediate
MSW-GitMSW-Git
33

msw-avatar

Manage avatar costumes and animations in MapleStory Worlds workspace files.

Community
Advanced
mcclowesmcclowes
4

textmate-grammar

Author TextMate grammars for Lea syntax highlighting in editors.

Community
Intermediate
Fabric-ProFabric-Pro
3

security-patterns

Implement OWASP Top 10 defenses including input validation, authentication, and encryption in web applications.

Official
Intermediate