Minecraft plugin ItemTag

🔌 About ItemTag

ItemTag — is a Minecraft plugin that allows attaching non‑vanilla behaviors and restrictions to items. ItemTag is intended to extend item functionality (effects, commands, flags, triggers) beyond vanilla mechanics and is commonly used on Spigot/Paper servers for RPGs, adventure maps, and admin tools.

🎯 Purpose

ItemTag solves the need to make ordinary Minecraft items perform custom actions or gain persistent properties without core modding. It addresses use cases such as: giving equipment permanent potion effects, executing commands when an item is used or consumed, and preventing items from being placed or renamed. These capabilities help build custom items for RPG, survival, or minigame servers. ()

⚙ Key features

• Add permanent or conditional potion effects to equipment.
• Execute commands when an item is used (right‑click) or consumed (food/drink).
• Make items unplaceable, unusable, or unrenamable.
• Define custom flags and triggers for items (custom behaviors on events).
• User‑friendly command interface with tab completion and clickable help messages. ()

🧩 Who it's for

ItemTag is suitable for:

• Server owners running Spigot or Paper who need custom item behavior.
• RPG and adventure map creators who want item‑based abilities.
• Admins who need item‑based commands and restrictions.
• Plugin developers integrating ItemTag with ItemEdit for complex item systems. ()

🏗 Usage examples

• Give a worn helmet a constant Speed/Strength buff via ItemTag effects.
• Execute a server command when a player right‑clicks a custom wand item.
• Prevent a custom crafted item from being used in recipes or placed as a block. ()

⌨️ Commands

Note: command names and permissions are taken from the plugin resource — default permission nodes require operator status unless changed. ()

🔐 Permissions

All permission data above are taken from the official resource/permission listing. Defaults are typically op on initial install. ()

⚙ Installation

📥 Installing

• Download the ItemTag .jar from an official source (Spigot/Modrinth/GitHub releases).
• Place the .jar into your server's plugins/ folder.
• Fully restart the server (avoid /reload).
• Check server console to confirm ItemTag loaded without errors. ()

📦 Dependencies

• ItemEdit — ItemTag is an extension of ItemEdit and requires ItemEdit to be installed. ()
• NBTAPI — required on older Minecraft server versions (typically for 1.8–1.13 compatibility). ()

🧾 Configuration

• Information about automatic config.yml generation, MySQL/SQLite support, and exact config keys is not explicitly documented in the primary resources; consult the plugin's GitHub or resource page for shipped example files. If official config details are required, they are available in the repository and on the resource page. ()

🧠 Additional information

Known requirements & compatibility

• ItemTag is an extension of ItemEdit and therefore depends on ItemEdit. Ensure ItemEdit is updated to a compatible version when updating ItemTag. ()
• Tested major Minecraft versions listed on the resource include 1.8 through 1.21 (see resource for exact tested versions). ()

Metrics & support

• ItemTag appears on bStats (plugin metrics) indicating usage tracking via bStats is used by many plugins — check the plugin files for opt‑out details. ()
• The plugin author provides support via the resource discussion/Discord linked on the resource page. ()

FAQ

Q1: Does ItemTag require ItemEdit? A1: Yes — ItemTag is explicitly an extension of ItemEdit and requires ItemEdit to function. ()

Q2: Which Minecraft versions does ItemTag support? A2: The official resource lists testing for major versions from 1.8 up to 1.21; verify the exact supported build on the resource page before installing on cutting‑edge server builds. ()

Q3: Does ItemTag collect usage statistics? A3: ItemTag is listed on bStats which indicates it uses bStats metrics; review the plugin jar/config for opt‑out options. ()

Q4: Where to get help? A4: Use the Spigot/Modrinth resource discussion and the author’s GitHub/Discord as linked in the plugin resource. ()

🤝 When to use ItemTag

Use ItemTag when you need lightweight, configurable item behaviors on a Spigot/Paper server and already use or plan to use ItemEdit for custom item management. It is well suited to servers that rely on item‑based abilities, RPG mechanics, or admin‑controlled item restrictions. ()