Skip to content

feat(minimessage): Add info about requiring namespace for custom textures in paths - #793

Open
Andre601 wants to merge 2 commits into
PaperMC:mainfrom
Andre601:feat/update-minimessage-sprite-path-info
Open

feat(minimessage): Add info about requiring namespace for custom textures in paths#793
Andre601 wants to merge 2 commits into
PaperMC:mainfrom
Andre601:feat/update-minimessage-sprite-path-info

Conversation

@Andre601

@Andre601 Andre601 commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Textures that are added to an atlas from a different namespace require you to add said namespace to the Sprite path to actually show.

Example: Assume a texture called ruby.png exists in assets/example/textures/item/ and is loaded by the items Atlas (due to it collecting everything under item/ directory).
The correct way to display the sprite now is <sprite:items:"example:item/ruby">

This PR updates the docs on the sprite tag to not only mention that, but also that the sprite name to use depends on the atlas, as it may or may not add a prefix for the path to use.

@github-actions

github-actions Bot commented Sep 4, 2026

Copy link
Copy Markdown
built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
papermc-docs ✅ Ready (View Log) Visit Preview 360e744

Arguments
* `atlas` the atlas to use, e.g. `minecraft:blocks`.
* `sprite` the sprite to use, e.g. `item/emerald`.
* `sprite` the sprite to use, e.g. `item/emerald`. Name is based on the atlas used, may or may not have a prefix (e.g. `item/` for items atlas) and may require a namespace, if the texture is not stored in the `minecraft` namespace (e.g. texture paths from `assets/example/textures/item/` require `example:` as namespace).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* `sprite` the sprite to use, e.g. `item/emerald`. Name is based on the atlas used, may or may not have a prefix (e.g. `item/` for items atlas) and may require a namespace, if the texture is not stored in the `minecraft` namespace (e.g. texture paths from `assets/example/textures/item/` require `example:` as namespace).
* `sprite` the sprite to use, e.g. `item/emerald`. The name is based on the atlas used. It may have a prefix (e.g. `item/` for items atlas). If the texture is not stored in the `minecraft` namespace it may also require a namespace (e.g. texture paths from `assets/example/textures/item/` require `example:` as namespace).

Feel like this is a bit wordy

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants