msw-sprite-ruid
SpriteRendererComponent.SpriteRUID (world) and SpriteGUIRendererComponent.ImageRUID (UI) — native RUID type support (sprite / animationclip direct playback), thumbnail:// prefix for rendering avataritem / skeleton / animationclip as static thumbnail image, avatar item icon in inventory / shop / UI slot. Use when: assigning any RUID to a sprite renderer component, displaying an avatar item or resource as a thumbnail or icon, using animationclip directly in a renderer, rendering inventory item ico
Security Assessment
About msw-sprite-ruid
Msw-sprite-ruid provides the rules for assigning a RUID to a sprite renderer in MSW, covering SpriteRendererComponent.SpriteRUID in the world and SpriteGUIRendererComponent.ImageRUID in the UI. Both components accept a sprite or animationclip RUID directly, with no extra animator component required. In the world the value is a plain string, while in the UI the value is wrapped as an object with a DataId field. It applies when assigning any RUID to a sprite renderer, displaying an avatar item or resource as a thumbnail or icon, using an animationclip directly in a renderer, or rendering inventory item icons.
For animation, a single looping animation such as a background decoration or idle effect is handled by setting SpriteRUID or ImageRUID directly to the animationclip RUID, whereas multi-state animation like stand, move, attack, hit, and die uses StateAnimationComponent plus an ActionSheet, documented in a referenced monster guide. A skeleton or avataritem RUID assigned without the thumbnail:// prefix fails silently, rendering nothing with no error.
The thumbnail:// prefix renders a static thumbnail image from any resource, accepting sprite, animationclip, skeleton, and avataritem types in the form thumbnail:// followed by a 32-character hex RUID. Its primary use case is avatar item icons, since avataritem RUIDs cannot render without the prefix; with it they become item icons for inventory slots, shop listings, and equip previews, and in the UI the prefix goes inside the DataId field. The skill lists common pitfalls, including that thumbnail:// produces a static image only (live animation requires assigning the animationclip RUID directly), that CostumeManagerComponent.Custom*Equip, StateAnimationComponent.ActionSheet, and SkeletonRendererComponent.SkeletonRUID do not accept the prefix, and that the prefix should not be reapplied to a RUID already retrieved as a thumbnail. RUIDs are found with the msw-search skill, using searchAvatarItems for avatar items and searchResources for everything else.
FAQ
Which RUID types can be assigned directly to a sprite renderer?
Both SpriteRendererComponent (world) and SpriteGUIRendererComponent (UI) accept sprite and animationclip RUIDs directly, with no extra animator component required. The world property SpriteRUID takes a plain string, while the UI property ImageRUID takes an object of the form { DataId = ruid }.
Why does my skeleton or avataritem RUID render nothing?
A skeleton or avataritem RUID assigned without the thumbnail:// prefix fails silently, producing no error and rendering nothing. Prepend thumbnail:// to render it as a static thumbnail image, since avataritem RUIDs in particular cannot render without the prefix.
What does the thumbnail:// prefix do?
It renders a static thumbnail image from any resource, in the form thumbnail:// followed by a 32-character hex RUID, and accepts sprite, animationclip, skeleton, and avataritem types. It is the primary way to display avatar item icons in inventory slots, shop listings, and equip previews.
How do I handle multi-state animations like attack or die?
A single looping animation can be set directly via SpriteRUID or ImageRUID to the animationclip RUID, but multi-state animation such as stand, move, attack, hit, and die uses StateAnimationComponent plus an ActionSheet, as described in the referenced monster guide.
Where do I get the RUIDs to assign?
Use the msw-search skill: searchAvatarItems for avatar items and searchResources for everything else. You should not reapply thumbnail:// to a RUID that was already retrieved as a thumbnail or icon, since the prefix converts a source resource into its thumbnail and reapplying it is redundant.
Install msw-sprite-ruid
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
msw-git/msw-ai-coding-plugins-official