Minecraft plugin ItemJoin

🔌 Over ItemJoin

ItemJoin is een Minecraft-plugin waarmee spelers automatisch sterk configureerbare, aangepaste items krijgen. Items kunnen worden gegeven bij gebeurtenissen zoals join, first-join, respawn, world-switch, region-enter en region-leave. De plugin richt zich op flexibele itemdefinities (itemflags), triggergebeurtenissen en opdrachten die aan items zijn gekoppeld, zodat servers lobbymenu's, starterkits of contextgevoelige tools kunnen aanbieden zonder aangepaste clientmods.

🎯 Doel

ItemJoin lost het probleem op van het betrouwbaar geven van aangepaste of interactieve items aan spelers die gekoppeld zijn aan servergebeurtenissen en werelden. Het is handig voor hub/lobby-servers, minigame-servers, survival-netwerken (waar items per wereld beperkt moeten zijn) en netwerken die itemgestuurde menu's of items die commando's starten nodig hebben.

⚙️ Functies

• Geef items op basis van configureerbare triggers: join, first-join, respawn, world-switch, region-enter/exit en vergelijkbare gebeurtenissen.
• Per item itemflags die het gedrag aanpassen (slot, overwrite, stack-regels, blokkeren van verplaatsen/oprapen, gamemode-beperkingen, kans op ontvangst, cooldowns).
• ItemCommands: koppel commando's aan items en configureer de uitvoeringscontext (console, player, server, message) en actietypen (linker-/rechtermuisklik, inventory click, physical, multi-click).
• PlaceholderAPI-integratie voor dynamische itemnamen/lore en ondersteuning voor placeholders.
• Ondersteuning voor aangepaste spelershoofden (eigen textures en owners), map-afbeeldingen, tipped arrows, boeken, banners, vuurwerk, aanpassing van leren armor en aangepaste enchant-niveaus.
• Optioneel het verplaatsen of oprapen van items blokkeren in specifieke werelden en items beperken op basis van IP-adres of first-join-status.
• In-game GUI-maker voor het bouwen van itemsets en een ingebouwde import-/maakworkflow.
• API voor andere plugins: beschikbaar via me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Voor wie is dit

• Servereigenaren die geautomatiseerde lobby-/hub-items of starterkits nodig hebben.
• Beheerders van minigames en netwerken die wereldspecifieke items of menu-kompassen nodig hebben.
• Ontwikkelaars die een via API koppelbaar itemsysteem willen.

🏗️ Voorbeeldtoepassingen

• Spelers bij join een menukompas geven dat bij klikken verschillende commando's uitvoert.
• Eenmalige starterkits geven bij first-join en tegelijk itemoverdracht tussen bepaalde werelden voorkomen.
• Interactieve items maken die economy-/shop-commando's uitvoeren met cooldowns en kosten.

⌨️ Commando's

Opmerking: deze commando's en subcommando's zijn afkomstig uit de gedocumenteerde commando-set van de plugin. De plugin biedt extra subcommando's in de wiki en in de gegenereerde hulpuitvoer.

🔐 Permissies

Het gedrag van itemspecifieke permissies is configureerbaar; controles op itempermissies zijn standaard uitgeschakeld en moeten in de pluginconfiguratie worden ingeschakeld om effect te hebben.

⚙️ Installatie

📥 Setup

• Download de officiële ItemJoin-jar en plaats deze in de map plugins/ van je server.
• Zorg ervoor dat er geen dubbele ItemJoin-jarbestanden in plugins/ staan (bijv. ItemJoin(1).jar).
• Herstart de server zodat de plugin zijn configuratie kan aanmaken en functies voor jouw serverversie kan registreren.
• Controleer de consolelogs op bevestiging van het laden van de plugin en raadpleeg de pluginwiki voor gedetailleerde setup.

📦 Afhankelijkheden

De plugin heeft geen harde runtimevereisten, maar vermeldt verschillende gangbare soft-dependencies en integraties (optioneel en ingeschakeld wanneer aanwezig):

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

Schakel integraties in of configureer ze indien nodig; de plugin werkt ook zonder deze, maar functies zoals placeholders, aangepaste heads/skins en economy-hooks zijn afhankelijk van de bijbehorende plugins.

🧠 Technische notities

• Platformen: bevestigd voor servers in Spigot-stijl (Spigot, Bukkit, Paper, Purpur, Folia).
• Ondersteunde/geteste Minecraft-range: 1.8 tot 1.21.
• Broncode en releases zijn gepubliceerd en het project biedt een API op me.RockinChaos.itemjoin.api.ItemJoinAPI waar andere plugins op kunnen inhaken.
• Licentie: LGPL-3.0.

🤝 Wanneer deze plugin nuttig is

Als je een flexibel, configureerbaar systeem nodig hebt om spelers contextbewuste en interactieve items te geven (menu's, starterkits, wereldspecifieke tools) en je wilt een API voor integraties, dan biedt ItemJoin die functies en ondersteunt het veelgebruikte placeholder- en skinplugins.