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

msw-sprite-ruid

Assigns sprite, animationclip, and thumbnail RUIDs to MapleStory Worlds renderer components.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Assigning resource RUIDs to sprite renderers in MapleStory Worlds fails silently when the wrong format is used — skeleton and avataritem RUIDs render nothing without the thumbnail:// prefix, and UI components require a different value structure than world components. This Skill documents the exact rules so sprites, animations, and item icons display correctly the first time. ## Core Features & Use Cases - Native RUID assignment: Set SpriteRendererComponent.SpriteRUID (world) or SpriteGUIRendererComponent.ImageRUID (UI) directly to sprite or animationclip RUIDs, with the correct value form for each (plain string vs DataId table). - thumbnail:// prefix rendering: Convert any sprite, animationclip, skeleton, or avataritem RUID into a static thumbnail image for icons and previews. - Avatar item icons: Render avataritem RUIDs as inventory slot, shop listing, and equip preview icons using the thumbnail prefix. - Use Case: When building an inventory UI, assign each slot's ImageRUID as { DataId = "thumbnail://" .. avatarItemRuid } so item icons appear instead of blank slots. ## Quick Start Show the avatar item with this RUID as an icon in my inventory slot UI using the thumbnail prefix.

Frequently Asked Questions about msw-sprite-ruid

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

FAQPage Schema
How do I assign a sprite RUID to a renderer in MapleStory Worlds?▼

Set SpriteRendererComponent.SpriteRUID to the RUID as a plain string for world entities, or SpriteGUIRendererComponent.ImageRUID to { DataId = ruid } for UI. Both accept sprite and animationclip RUIDs directly without an animator component.

How do I show an avatar item icon in an inventory slot?▼

Prepend thumbnail:// to the avataritem RUID and assign it to the slot's ImageRUID as { DataId = "thumbnail://" .. ruid }. Avatar item RUIDs cannot render without this prefix, so the thumbnail form is required for inventory, shop, and equip preview icons.

Why does my skeleton or avataritem RUID render nothing in MapleStory Worlds?▼

Skeleton and avataritem RUIDs fail silently when assigned directly to SpriteRUID or ImageRUID — no error appears and nothing renders. Add the thumbnail:// prefix to render them as static thumbnail images.

Can I play an animation directly in a sprite renderer without StateAnimationComponent?▼

Yes, assign the animationclip RUID directly to SpriteRUID or ImageRUID for a single looping animation like background decoration or idle effects. For multi-state animations such as stand, move, attack, and die, use StateAnimationComponent with an ActionSheet instead.

Does thumbnail:// work with CostumeManagerComponent or SkeletonRendererComponent?▼

No. CostumeManagerComponent.Custom*Equip, StateAnimationComponent.ActionSheet, and SkeletonRendererComponent.SkeletonRUID do not accept the thumbnail:// prefix. The prefix only works with SpriteRUID and ImageRUID, and produces static images rather than live animation.

Related Skills

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

msw-sprite-ruid

Assign sprite and animationclip RUIDs to MSW renderer components with thumbnail support.

Community
Advanced
mattwoodcomattwoodco
3

video-player

Provide React components for building interactive MUX video players.

Community
Intermediate
alexkaferalexkafer

pixijs-scene-sprite

Render PixiJS v8 sprite variants for static, animated, nine-slice, and tiling scenes.

Community
Intermediate
planetaryescapeplanetaryescape

auto-generated-shadcn-ui-patterns

Define and reuse CVA-based UI variants for shadcn/ui components in React.

Official
Advanced