Minecraft-plugin ItemJoin

🔌 Om ItemJoin

ItemJoin är ett Minecraft-plugin som automatiskt ger spelare mycket konfigurerbara, anpassade föremål. Föremål kan delas ut vid händelser som join, first-join, respawn, world-switch, region-enter och region-leave. Pluginet fokuserar på flexibla föremålsdefinitioner (itemflags), utlösande händelser och föremålsbundna kommandon, så att servrar kan erbjuda lobbymenyer, startkit eller kontextkänsliga verktyg utan egna klientmods.

🎯 Syfte

ItemJoin löser problemet med att på ett tillförlitligt sätt ge spelare anpassade eller interaktiva föremål kopplade till serverhändelser och världar. Det är användbart för hubb-/lobbyservrar, minispelsservrar, survival-nätverk (där föremål måste begränsas per värld) och nätverk som behöver föremålsstyrda menyer eller föremål som запускар kommandon.

⚙️ Funktioner

• Ge föremål vid konfigurerbara triggers: join, first-join, respawn, world-switch, region-enter/exit och liknande händelser.
• Per-föremål itemflags som ändrar beteendet (slot, overwrite, stackregler, blockering av flytt/upplockning, gamemode-begränsningar, chans att få, cooldowns).
• ItemCommands: koppla kommandon till föremål och konfigurera körningskontext (console, player, server, message) samt åtgärdstyper (vänster/högerklick, inventory click, physical, multi-click).
• PlaceholderAPI-integration för dynamiska föremålsnamn/lore och stöd för placeholders.
• Stöd för anpassade spelarhuvuden (egna textures och owners), kartbilder, tipped arrows, böcker, banners, fyrverkerier, anpassning av läderrustning och anpassade enchant-nivåer.
• Valfritt blockera föremålsrörelse eller upplockning i specifika världar och begränsa föremål efter IP-adress eller first-join-status.
• Inbyggd GUI-skapare i spelet för att bygga föremålssamlingar och ett inbyggt import-/skapaflöde.
• API för andra plugin: tillgängligt via me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Vem det är för

• Serverägare som behöver automatiska lobby-/hubbföremål eller startkit.
• Minispels- och nätverksoperatörer som behöver världsspecifika föremål eller menykompasser.
• Utvecklare som vill ha ett föremålssystem som kan hookas via API.

🏗️ Exempel på användning

• Ge spelare en menykompass vid join som kör olika kommandon när den klickas.
• Erbjuda engångs-startkit vid first-join och samtidigt förhindra att föremål förs mellan angivna världar.
• Skapa interaktiva föremål som kör economy/shop-kommandon med cooldowns och kostnader.

⌨️ Kommandon

Notera: dessa kommandon och underkommandon är hämtade från pluginets dokumenterade kommandoset. Pluginet erbjuder fler underkommandon i sin wiki och i genererad hjälpoutput.

🔐 Behörigheter

Beteendet för föremålsspecifika behörigheter är konfigurerbart; kontroller av föremålsbehörigheter är inaktiverade som standard och måste aktiveras i pluginets konfiguration för att börja gälla.

⚙️ Installation

📥 Setup

• Ladda ner den officiella ItemJoin-jarfilen och lägg den i serverns mapp plugins/.
• Se till att det inte finns några dubbla ItemJoin-jarfiler i plugins/ (t.ex. ItemJoin(1).jar).
• Starta om servern så att pluginet kan skapa sin konfiguration och registrera funktioner för din serverversion.
• Kontrollera serverns konsolloggar för bekräftelse på att pluginet laddats och se pluginets wiki för detaljerad installation.

📦 Beroenden

Pluginet har inga hårda runtime-krav, men listar flera vanliga soft-dependencies och integrationer (valfria och aktiveras när de finns):

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

Aktivera eller konfigurera integrationer efter behov; pluginet fungerar utan dessa, men funktioner som placeholders, anpassade huvuden/skins och economy hooks är beroende av motsvarande plugin.

🧠 Tekniska noteringar

• Plattformar: bekräftat för Spigot-liknande servrar (Spigot, Bukkit, Paper, Purpur, Folia).
• Stödd/testad Minecraft-version: 1.8 till 1.21.
• Källkod och releaser är publicerade och projektet erbjuder ett API på me.RockinChaos.itemjoin.api.ItemJoinAPI för att andra plugin ska kunna hooka in.
• Licens: LGPL-3.0.

🤝 När detta plugin är användbart

Om du behöver ett flexibelt, konfigurerbart system för att ge spelare kontextmedvetna och interaktiva föremål (menyer, startkit, världsspecifika verktyg) och vill ha ett API för integrationer, erbjuder ItemJoin de funktionerna och stöder vanliga placeholder- och skin-plugin.