Minecraft plugin ItemJoin

🔌 About ItemJoin

ItemJoin is a Minecraft plugin for giving highly configurable custom items to players automatically. Items can be granted on events such as join, first-join, respawn, world-switch, region-enter, and region-leave. The plugin focuses on flexible item definitions (itemflags), trigger events, and item-bound commands so servers can provide lobby menus, starter kits, or context-sensitive tools without custom client mods.

🎯 Purpose

ItemJoin solves the problem of reliably giving players custom or interactive items tied to server events and worlds. It is useful for hub/lobby servers, minigame servers, survival networks (where items must be limited per world), and networks that need item-driven menus or command-launching items.

⚙️ Features

• Grant items on configurable triggers: join, first-join, respawn, world-switch, region-enter/exit, and similar events.
• Per-item itemflags that alter behavior (slot, overwrite, stack rules, movement/pickup blocking, gamemode limits, chance to receive, cooldowns).
• ItemCommands: attach commands to items and configure execution context (console, player, server, message) and action types (left/right-click, inventory click, physical, multi-click).
• PlaceholderAPI integration for dynamic item names/lore and placeholders support.
• Custom player head support (custom textures and owners), map images, tipped arrows, books, banners, fireworks, leather armor customization, and custom enchant levels.
• Optionally block item movement or pickups in specific worlds and restrict items by IP address or first-join state.
• In-game GUI creator for building item sets and a built-in import/creator workflow.
• API for other plugins: available under me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Who It Is For

• Server owners who need automated lobby/hub items or starter kits.
• Minigame and network operators requiring world-specific items or menu compasses.
• Developers who want a hookable item system via an API.

🏗️ Example Use Cases

• Give players a menu compass on join that runs different commands when clicked.
• Provide one-time starter kits on first join while preventing item transfer between specified worlds.
• Create interactive items that execute economy/shop commands with cooldowns and costs.

⌨️ Commands

Note: these commands and subcommands are taken from the plugin's documented command set. The plugin provides additional subcommands in its wiki and generated help output.

🔐 Permissions

Item-specific permission behavior is configurable; item permission checks are disabled by default and must be enabled in the plugin configuration to take effect.

⚙️ Installation

📥 Setup

• Download the official ItemJoin jar and place it into your server's plugins/ folder.
• Ensure there are no duplicate ItemJoin jar files in plugins/ (e.g., ItemJoin(1).jar).
• Restart the server so the plugin can generate its configuration and register features for your server version.
• Check server console logs for plugin load confirmation and consult the plugin wiki for detailed setup.

📦 Dependencies

The plugin has no hard runtime requirements but lists several common soft-dependencies and integrations (these are optional and enabled when present):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Enable or configure integrations as needed; the plugin functions without these, but features like placeholders, custom head/skinning, and economy hooks rely on the corresponding plugins.

🧠 Technical Notes

• Platforms: confirmed for Spigot-style servers (Spigot, Bukkit, Paper, Purpur, Folia).
• Supported/tested Minecraft range: 1.8 through 1.21.
• Source code and releases are published and the project exposes an API at me.RockinChaos.itemjoin.api.ItemJoinAPI for other plugins to hook into.
• License: LGPL-3.0.

🤝 When This Plugin Is Useful

If you need a flexible, configurable system to supply players with context-aware and interactive items (menus, starter kits, world-specific tools) and want an API for integrations, ItemJoin provides those features while supporting common placeholder and skin plugins.