CHATITEM PLUS - THE ULTIMATE INTERACTIVE SHARING PLUGINWelcome to ChatItem Plus, the professional-grade interactive sharing plugin for Minecraft servers running Paper or Spigot 1.21 and above! Elevate your community engagement by allowing players to showcase their items, full inventories, ender chests, and current equipment directly in the global chat with beautifully formatted, click-and-hover interactive elements.
Built with an enterprise-level architecture, ChatItem Plus guarantees 100% duplicate-proof read-only GUI snapshots, local SQLite database persistence, lag-free asynchronous Discord Webhooks, and automatic compatibility with premium texture plugins like Oraxen and ItemsAdder.
---
WHY CHOOSE CHATITEM PLUS?Unlike basic sharing plugins that cause performance lag or lose data when the server restarts, ChatItem Plus utilizes a local SQLite database to store inventory snapshots, fires external requests asynchronously (zero TPS drops), and supports modern Paper Adventure MiniMessage formatting alongside legacy color codes.
---
KEY FEATURES- SECURE READ-ONLY GUI SNAPSHOTS
Inventories, ender chests, and equipment shared in chat open as customized, read-only GUI snapshots. Players can inspect the items in real-time, but cannot take, move, or modify anything, completely eliminating duplication exploits.
- PERSISTENT LOCAL SQLITE DATABASE
All shared snapshots are written directly to a local SQLite database file. If your server restarts or crashes, shared chat links remain fully functional! Includes an automatic purging system to clean up old snapshot entries after a configurable number of days.
- ORAXEN & ITEMSADDER INTEGRATION
Full native support for custom textured items, 3D models, and custom furniture. ChatItem Plus automatically detects custom item identities, preserving their custom display names and formatting perfectly inside the snapshot GUIs.
- ASYNCHRONOUS DISCORD WEBHOOKS
Send rich embed messages to your Discord channel whenever players share their items or inventories in-game. This runs entirely asynchronously in a separate thread, keeping server TPS perfectly stable.
- ADVENTURE MINIMESSAGE & LEGACY COLORS
Fully supports modern Adventure MiniMessage formatting (such as gradients, rainbows, hovers, and click actions) as well as classic Minecraft legacy color codes.
- INDIVIDUAL COMMAND COOLDOWNS
Configure distinct cooldown timers in seconds for each sharing command to prevent chat flood and database overhead.
- IMMERSIVE SOUND EFFECTS
Play configurable 3D sound effects (e.g., chest open sounds) whenever players click a chat link to open someone's inventory snapshot.
- PLACEHOLDERAPI COMPATIBILITY
Inject any global placeholders from your server into the broadcast messages and GUI titles for personalized player ranks and tags.
---
COMMANDS & ALIASESCommand: /chatitem
Aliases: /citem, /showitem
Description: Shares the item in your main hand in chat. Players can hover their mouse over the message to view its complete tooltips, lore, and enchantments.
Cooldown: 3 seconds
Permission: chatitemplus.use.chatitem
Command: /chatinv
Aliases: /cinv, /showinv
Description: Shares your entire inventory in chat via a clickable tag. Other players can click the tag to open a GUI snapshot of your inventory.
Cooldown: 10 seconds
Permission: chatitemplus.use.chatinv
Command: /chatend
Aliases: /cend, /showend, /chatender
Description: Shares your Ender Chest in chat. Other players can click the link to view a GUI snapshot of your Ender Chest.
Cooldown: 10 seconds
Permission: chatitemplus.use.chatend
Command: /chatequip
Aliases: /cequip, /showequip
Description: Shares your active gear (armor slots, off-hand slot, and 9 hotbar slots) in a customized GUI snapshot.
Cooldown: 10 seconds
Permission: chatitemplus.use.chatequip
Command: /chatitems
Aliases: /citems
Description: Displays a list of all available commands and their descriptions.
Permission: chatitemplus.use.help
Command: /chatitemplus
Aliases: /cip, /chatitemp
Description: Main administrative command. Used to reload the plugin configuration.
Permission: chatitemplus.admin
---
PERMISSIONSPLAYER PERMISSIONS (Enabled for everyone by default):
- chatitemplus.use.chatitem : Allows using the /chatitem command.
- chatitemplus.use.chatinv : Allows using the /chatinv command.
- chatitemplus.use.chatend : Allows using the /chatend command.
- chatitemplus.use.chatequip : Allows using the /chatequip command.
- chatitemplus.use.help : Allows using the /chatitems command.
- chatitemplus.use.view : Crucial permission. Allows clicking shared chat links to open inventory snapshots.
ADMINISTRATIVE PERMISSIONS (OP by default):
- chatitemplus.admin : Grants access to administrative subcommands like /cip reload.
---
DEFAULT CONFIGURATION (config.yml)# ======================================================
# ChatItem Plus - Configuration
# ======================================================
# Duration in minutes before a captured snapshot expires and is removed from memory.
snapshot-expiration-minutes: 10
# Play a sound effect to the player when they open a snapshot GUI.
# Set to 'NONE' to disable.
sound-on-open: "BLOCK_CHEST_OPEN"
# Custom Permissions for each command.
permissions:
chatitem: "chatitemplus.use.chatitem"
chatinv: "chatitemplus.use.chatinv"
chatend: "chatitemplus.use.chatend"
chatequip: "chatitemplus.use.chatequip"
help: "chatitemplus.use.help"
view: "chatitemplus.use.view"
admin: "chatitemplus.admin"
# Aesthetics and Materials for the Snapshot GUIs
gui:
inventory:
spacer-material: "GRAY_STAINED_GLASS_PANE"
ender-chest:
spacer-material: "PURPLE_STAINED_GLASS_PANE"
equipment:
spacer-material: "GRAY_STAINED_GLASS_PANE"
# Material used if the offhand slot is empty
offhand-empty-material: "BARRIER"
# Cooldowns in seconds for each sharing command.
cooldowns:
chatitem: 3
chatinv: 10
chatend: 10
chatequip: 10
# SQLite Local Database Configuration
database:
# Automatically deletes snapshots from the SQLite database older than X days.
# Set to -1 to keep them forever.
purge-days: 7
# Discord Integration via Webhook (Asynchronous)
discord-webhook:
enabled: false
url: "https://discord.com/api/webhooks/your-webhook-id/your-webhook-token"
username: "ChatItem Plus"
avatar-url: "https://minotar.net/helm/Steve/100.png"
embed-color: "#d42cd4"
# External Hooks
hooks:
oraxen: true
itemsadder: true
---
SYSTEM REQUIREMENTS- Minecraft Server Version: 1.21 or above (Paper, Purpur, or Folia recommended).
- Java Runtime Environment: Java 21 or higher.
- Soft-Dependencies (Optional):
- Oraxen / ItemsAdder: For seamless support of custom textures and items.
---
EASY 5-STEP INSTALLATION1. Download the ChatItem Plus jar file.
2. Drag and drop the jar file into the plugins directory of your Minecraft server.
3. Start or restart your server to automatically generate default configuration folders and files.
4. Customize the config.yml file in the plugins/ChatItemPlus directory to your liking.
5. Execute the /cip reload command in-game or via the console to apply your changes instantly!
---
SupportNeed help or want to join the community?
Join our official Discord: https://discord.gg/Vvd2EtdhGk
