What ItemJoin works with.
| Platform | Java Edition |
|---|---|
| Loaders | Bukkit, Folia, Paper, Purpur, Spigot |
| Minecraft versions | 1.8, 1.12.2, 1.16.5, 1.18.2, 1.20.1, 1.21.1, 1.21.11, 26.1, 26.2 |
ItemJoin is a server plugin for Bukkit, Spigot, Paper, Purpur, and Folia that hands players a configured kit of items automatically, with no command needed. Server owners define each item once, pick a trigger such as join, first join, respawn, or world switch, and ItemJoin gives it out the moment that trigger fires. That makes it a common pick on minigame lobbies and PvP servers that need every player to start with the same gear. One 6.1.8 build covers Minecraft 1.8 through 26.2 across every supported server software.
Configuring a kit in items.yml
Every item ItemJoin gives out is defined once in items.yml. Each entry sets the material, the inventory slot it lands in, and which worlds it applies to, then names the trigger that hands it over. The in-game /itemjoin menu opens a GUI for previewing and building entries without hand-editing YAML, but the underlying config still drives everything.
- Material and display name for the item, plus enchantments or itemflags such as an unbreakable flag
- Inventory slot the item is placed into when it is given
- World restriction, so a kit can be limited to a lobby or minigame world
- Trigger: join, first-join, respawn, world-switch, or entering and leaving a WorldGuard region
- Optional first-join or ip-limit flags to stop a kit from being farmed on alternate accounts
Commands and permissions
- /itemjoin reload (or /ij reload) - reloads configuration files and cached items
- /itemjoin menu - opens the in-game GUI for viewing and building items
- /itemjoin get <item> <player> <amount> - manually distributes a configured item
- /itemjoin list - lists defined items and the worlds each is enabled in
- /itemjoin permissions - shows which item permissions a player currently has
- itemjoin.use - base command access, granted by default
- itemjoin.reload, itemjoin.menu, itemjoin.get, itemjoin.list - admin-level command permissions
- itemjoin.<world>.<item> or itemjoin.<world>.* - required per item only when an item is set to need a permission
Compatibility and optional integrations
ItemJoin needs no other plugin to run. It has no required dependency on any build from 1.8 through 26.2, so a fresh Bukkit, Spigot, Paper, Purpur, or Folia install can use it standalone. It also hooks into other plugins when they are present: Vault for priced items, AuthMe for login-gated kits, PlaceholderAPI for placeholders in item names, and TokenEnchant or SkinsRestorer for related item behavior. None of these are required for the base join-kit feature to work.
Custom join items setup walkthrough
Questions about ItemJoin.
5 questions
What does the ItemJoin plugin do?
ItemJoin automatically gives players a set of configured items when a chosen trigger fires, most commonly joining the server, respawning, switching worlds, or entering a region. Server owners define each item once in items.yml, so every matching player gets the same starting kit without running a command.
How do I configure a kit in ItemJoin?
Kits are defined in items.yml, where each entry sets the material, display name, inventory slot, world restriction, and trigger. The /itemjoin menu command also opens an in-game GUI for building and previewing items without editing the YAML file directly.
Does ItemJoin work on Paper and Folia?
Yes. The current build, 6.1.8, targets Bukkit, Spigot, Paper, Purpur, and Folia, and covers Minecraft versions 1.8 through 26.2 in a single download. There is no separate build needed per server software.
Does ItemJoin need Vault or another plugin installed?
No. ItemJoin has no required dependency and runs standalone. It optionally integrates with Vault for priced items, PlaceholderAPI for item name placeholders, and a handful of other plugins like AuthMe and TokenEnchant, but none of them are needed for basic join kits.
Can I use ItemJoin on Bedrock Edition?
No. ItemJoin is a Java Edition server plugin built for Bukkit-family server software. It has no Bedrock version, and Bedrock servers use a different plugin or add-on system entirely.
