msw-sprite-ruid

Q: How do I install msw-sprite-ruid?

Run npx skills add https://github.com/msw-git/msw-ai-coding-plugins-official --skill msw-sprite-ruid in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/msw-sprite-ruid/ (personal) or .claude/skills/msw-sprite-ruid/ (project).

by msw-gitMedia & Creative

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 icons, displaying a thumbnail image in a world entity. Keywords: SpriteRUID, ImageRUID, thumbnail://, animationclip, RUID apply, RUID assign, thumbnail, item icon, sprite RUID, RUID to renderer

Installs: 9.8K
Last 24h: +73
Trending rank: #2490
Security: Pass

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/msw-git/msw-ai-coding-plugins-official --skill msw-sprite-ruid

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads msw-sprite-ruid automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files.

Gen Agent Trust Hub PassSAFE ·The skill provides documentation and code examples for managing sprite and image resource IDs (RUIDs) in a game development environment. It covers native type support, the use of the thumbnail:// prefix for rendering icons, and common implementation pitfalls. No malicious behavior or security risks were detected.

Socket PassNo alerts

Snyk PassLOW ·Risk: LOW · No issues

SKILL.md

The instructions your agent reads when the skill is triggered.

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).

animationclip: single animation vs multi-state

Single looping animation (background deco, idle effect, prop): set SpriteRUID or ImageRUID directly to the animationclip RUID.
Multi-state (stand / move / attack / hit / die): use StateAnimationComponent + ActionSheet. See msw-general/references/monster.md.

`thumbnail://` prefix — static thumbnail from any resource

Prepend thumbnail:// to SpriteRUID or ImageRUID to render a static thumbnail image from any resource — useful for icons, preview images, and item thumbnails.

thumbnail://<32-char hex RUID>

Accepted types: sprite · animationclip · skeleton · avataritem

-- World thumbnail (any resource type)
self.Entity.SpriteRendererComponent.SpriteRUID = "thumbnail://" .. anyRuid

-- UI thumbnail (any resource type)
self.Entity.SpriteGUIRendererComponent.ImageRUID = DataRef("thumbnail://" .. anyRuid)

Primary use case: avataritem icons

avataritem RUIDs cannot render without thumbnail://. With the prefix they become item icons for inventory slots, shop listings, and equip previews.

slotEntity.SpriteGUIRendererComponent.ImageRUID = DataRef("thumbnail://" .. avatarItemRuid)

Search avatar item RUIDs with the msw-search skill (searchAvatarItems).

Common pitfalls

skeleton / avataritem directly into SpriteRUID / ImageRUID without prefix → silently invisible.
thumbnail:// = static image only. For live animation, assign the animationclip RUID directly (no prefix).
Runtime .mlua uses ImageRUID = DataRef("..."); the { "DataId": "..." } object form is .ui / .model JSON only (the prefix goes inside DataId, not a separate field). Do not use the table form in runtime code — the LSP rejects it as a DataRef type mismatch.
CostumeManagerComponent.Custom*Equip, StateAnimationComponent.ActionSheet, and SkeletonRendererComponent.SkeletonRUID do not accept thumbnail://.
Do not prepend thumbnail:// to a RUID that was already retrieved as a thumbnail or icon image from msw-search. The prefix converts a source resource into its thumbnail — applying it to an already-thumbnail sprite is logically redundant. If the search query targeted an icon / thumbnail image and returned a sprite RUID, assign that RUID directly without any prefix.
To search for RUIDs use the msw-search skill — searchAvatarItems for avatar items; searchResources for everything else.

FAQ

What does the msw-sprite-ruid skill do?

How do I install msw-sprite-ruid?

Run npx skills add https://github.com/msw-git/msw-ai-coding-plugins-official --skill msw-sprite-ruid in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/msw-sprite-ruid/ (personal) or .claude/skills/msw-sprite-ruid/ (project).

Which AI agents can use msw-sprite-ruid?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is msw-sprite-ruid safe to install?

Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk passed. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains msw-sprite-ruid?

It is published by msw-git in msw-git/msw-ai-coding-plugins-official. It has 9,774 recorded installs.