Msw Sprite Ruid

This one handles the specifics of assigning RUIDs to sprite renderers in MSW, both for world entities (SpriteRendererComponent.SpriteRUID) and UI elements (SpriteGUIRendererComponent.ImageRUID). The main thing to know is that sprite and animationclip RUIDs work natively, but avataritem and skeleton resources need the thumbnail:// prefix or they fail silently. You'll use this when building inventory UIs, shop slots, or any time you need to show item icons as static thumbnails. The documentation is clear about the DataRef wrapper for UI contexts and warns against double-prefixing thumbnails that are already thumbnail sprites. It's narrowly scoped but covers the common gotchas around RUID type compatibility and the difference between live animation playback versus static preview rendering.

skills.sh installs: 10.5K
GitHub stars: 38
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add msw-git/msw-ai-coding-plugins-official --skill msw-sprite-ruid --agent claude-code

Installs into .claude/skills of the current project.

Files

MSW Sprite RUID

Rules for assigning a RUID to SpriteRendererComponent.SpriteRUID (world) or SpriteGUIRendererComponent.ImageRUID (UI).

Native type support

Both components accept a sprite or animationclip RUID directly — no extra animator component required.

Component	Property	Value form (runtime `.mlua`)	Native RUID types
`SpriteRendererComponent` (world)	`SpriteRUID`	plain string	`sprite`, `animationclip`
`SpriteGUIRendererComponent` (UI)	`ImageRUID`	`DataRef("...")`	`sprite`, `animationclip`

ImageRUID is a DataRef: in runtime .mlua, assign DataRef(ruid). Use { DataId: ruid } only in .ui / .model JSON or builder patch data. SpriteRUID remains a plain string.

-- World: sprite or animationclip RUID both work
self.Entity.SpriteRendererComponent.SpriteRUID = ruid

-- UI: sprite or animationclip RUID both work
self.Entity.SpriteGUIRendererComponent.ImageRUID = DataRef(ruid)

A skeleton / avataritem RUID assigned without the thumbnail:// prefix fails silently (no error, nothing renders).