Plugin Minecraft ItemJoin

🔌 Despre ItemJoin

ItemJoin este un plugin Minecraft care oferă automat jucătorilor obiecte personalizate, foarte configurabile. Obiectele pot fi acordate la evenimente precum join, first-join, respawn, world-switch, region-enter și region-leave. Pluginul se concentrează pe definiții flexibile ale obiectelor (itemflags), evenimente declanșatoare și comenzi legate de obiecte, astfel încât serverele să poată oferi meniuri de lobby, starter kit-uri sau unelte dependente de context fără moduri client personalizate.

🎯 Scop

ItemJoin rezolvă problema oferirii fiabile către jucători a unor obiecte personalizate sau interactive, legate de evenimentele serverului și de world-uri. Este util pentru servere hub/lobby, servere de minigame, rețele survival (unde obiectele trebuie limitate pe fiecare world) și rețele care au nevoie de meniuri controlate de obiecte sau obiecte care lansează comenzi.

⚙️ Funcționalități

• Acordă obiecte pe declanșatoare configurabile: join, first-join, respawn, world-switch, region-enter/exit și evenimente similare.
• itemflags per obiect care modifică comportamentul (slot, overwrite, reguli de stack, blocarea mișcării/culesului, limite de gamemode, șansa de primire, cooldowns).
• ItemCommands: atașează comenzi la obiecte și configurează contextul de execuție (console, player, server, message) și tipurile de acțiuni (click stânga/dreapta, click în inventar, physical, multi-click).
• Integrare PlaceholderAPI pentru nume/lore dinamice ale obiectelor și suport pentru placeholders.
• Suport pentru head-uri personalizate de jucător (textures și owners personalizate), imagini pe map, tipped arrows, cărți, banners, artificii, personalizarea armurilor de piele și niveluri de enchant personalizate.
• Poate bloca opțional mișcarea obiectelor sau ridicarea lor în world-uri specifice și poate restricționa obiectele după adresa IP sau starea first-join.
• Creator GUI în joc pentru construirea seturilor de obiecte și un flux integrat de import/creare.
• API pentru alte pluginuri: disponibil la me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Pentru cine este

• Proprietari de servere care au nevoie de obiecte automate pentru lobby/hub sau starter kit-uri.
• Operatori de minigame și rețele care au nevoie de obiecte specifice world-ului sau busole de meniu.
• Dezvoltatori care vor un sistem de obiecte care poate fi conectat prin API.

🏗️ Exemple de utilizare

• Oferă jucătorilor o busolă de meniu la join, care rulează comenzi diferite la click.
• Oferă starter kit-uri o singură dată la first-join, prevenind în același timp transferul obiectelor între world-urile specificate.
• Creează obiecte interactive care execută comenzi economy/shop cu cooldowns și costuri.

⌨️ Comenzi

Notă: aceste comenzi și subcomenzi provin din setul de comenzi documentat al pluginului. Pluginul oferă subcomenzi suplimentare în wiki și în output-ul de ajutor generat.

🔐 Permisiuni

Comportamentul permisiunilor specifice obiectelor este configurabil; verificările permisiunilor pentru obiecte sunt dezactivate implicit și trebuie activate în configurația pluginului pentru a avea efect.

⚙️ Instalare

📥 Setare

• Descărcați fișierul jar oficial ItemJoin și puneți-l în folderul plugins/ al serverului.
• Asigurați-vă că nu există fișiere jar duplicate ItemJoin în plugins/ (de exemplu ItemJoin(1).jar).
• Reporniți serverul pentru ca pluginul să își poată genera configurația și înregistra funcțiile pentru versiunea serverului dvs.
• Verificați logurile consolei serverului pentru confirmarea încărcării pluginului și consultați wiki-ul pluginului pentru o setare detaliată.

📦 Dependențe

Pluginul nu are cerințe runtime obligatorii, dar listează câteva soft-dependencies și integrări comune (opționale și activate când sunt prezente):

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

Activați sau configurați integrările după nevoie; pluginul funcționează și fără ele, dar funcții precum placeholders, head-uri/skin-uri personalizate și hook-uri de economie depind de pluginurile corespunzătoare.

🧠 Note tehnice

• Platforme: confirmat pentru servere de tip Spigot (Spigot, Bukkit, Paper, Purpur, Folia).
• Interval Minecraft suportat/testat: 1.8 până la 1.21.
• Codul sursă și versiunile sunt publicate, iar proiectul oferă un API la me.RockinChaos.itemjoin.api.ItemJoinAPI pentru integrarea altor pluginuri.
• Licență: LGPL-3.0.

🤝 Când este util acest plugin

Dacă aveți nevoie de un sistem flexibil și configurabil pentru a oferi jucătorilor obiecte interactive și dependente de context (meniuri, starter kit-uri, unelte specifice world-ului) și doriți un API pentru integrări, ItemJoin oferă aceste funcții și suportă pluginuri populare pentru placeholders și skin-uri.