Skip to content
minejango2 edited this page Jul 23, 2026 · 11 revisions

Introduce

ChatItemSprite displays the correct item sprite in Minecraft chat, including support for custom item plugins such as ItemsAdder, Oraxen, Nexo, and CraftEngine.

Features

  • Display vanilla item in chat with sprites!
    • You can remove the sprite from chat as you want
  • Support for custom item plugins (currently ItemsAdder, Oraxen, Nexo, CraftEngine)
  • Configurable display sprites
  • Optional hover information
  • Lightweight and dependency-free
  • Easy-to-modify chat format with LuckPerms

Requirements

  • Paper
  • Minecraft 26.2
  • Java 25

Recommended

  • LuckPerms: for chat format (not item, whole line)

Supported Plugin (Custom Item Plugins)

(you need to add your sprite manually for custom items)

  • ItemsAdder (Have an automatic sprite fallback, still recommend to define sprite manually by config)
  • Oraxen
  • Nexo (Not Tested)
  • CraftEngine

Installation

Just like other plugins, just put the plugin into plugins folder!

If supported custom item plugins are installed, ChatItemSprite will automatically detect and use them.

Commands

note: you can use /cis for alias

Command Description
/chatitemsprite help Print help messages
/chatitemsprite reload Reload the configuration
/chatitemsprite version see the version of ChatItemSprite plugin

Permissions

Permission Default Description
chatitemsprite.use OP permission for using [item] in chat. if you don't have this permission, [item] won't be converted to item
chatitemsprite.commnad OP base permission of /chatitemsprite and ChatItemSprite commands. subcommand requires this permission
chatitemsprite.command.help OP permission of /chatitemsprite help
chatitemsprite.command.reload OP permission of /chatitemsprite reload
chatitemsprite.command.version OP permission of /chatitemsprite version

Resource Pack

Vanilla sprites are available automatically except some special items. For custom items, you need to define the sprite for each custom item.


Sprite and Configuration

Your Item not displaying in chat? See Guides for all detailed informations.

➡️ Atlas & Sprite Guide (work in progress)

➡️ Configuration Guide


Need Help?

If you encounter a bug or have a feature request, please open an Issue on GitHub. If you have another issue that want/had to be private, please send me a email (minejango2@gmail.com)

Clone this wiki locally