Minecraft plugin ItemJoin

🔌 O ItemJoin

ItemJoin je Minecraft plugin, který hráčům automaticky dává vysoce přizpůsobitelné vlastní předměty. Předměty lze udělovat při událostech jako join, first-join, respawn, world-switch, region-enter a region-leave. Plugin se zaměřuje na flexibilní definice předmětů (itemflags), spouštěcí události a příkazy navázané na předměty, aby servery mohly poskytovat lobby menu, starter kity nebo kontextové nástroje bez vlastních client modů.

🎯 Účel

ItemJoin řeší problém spolehlivého předávání vlastních nebo interaktivních předmětů hráčům navázaných na události serveru a světů. Je užitečný pro hub/lobby servery, minigame servery, survival sítě (kde musí být předměty omezené pro každý svět) a sítě, které potřebují menu ovládané předměty nebo předměty spouštějící příkazy.

⚙️ Funkce

• Udělování předmětů na základě konfigurovatelných triggerů: join, first-join, respawn, world-switch, region-enter/exit a podobné události.
• itemflags pro každý předmět, které upravují chování (slot, overwrite, pravidla stackování, blokování pohybu/vyzvednutí, omezení gamemode, šance získání, cooldowns).
• ItemCommands: připojení příkazů k předmětům a nastavení kontextu provedení (console, player, server, message) a typů akcí (levé/pravé kliknutí, kliknutí v inventáři, physical, multi-click).
• Integrace PlaceholderAPI pro dynamické názvy/lore předmětů a podporu placeholders.
• Podpora vlastních hlav hráčů (vlastní textures a owners), map obrázků, tipped arrows, knih, banners, ohňostrojů, úprav kožené zbroje a vlastních úrovní enchantů.
• Volitelné blokování pohybu předmětů nebo jejich sběru v konkrétních světech a omezení předmětů podle IP adresy nebo stavu first-join.
• In-game GUI editor pro sestavování sad předmětů a vestavěný workflow importu/vytváření.
• API pro další pluginy: dostupné na me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Pro koho to je

• Majitele serverů, kteří potřebují automatické lobby/hub předměty nebo starter kity.
• Provozovatele minigame a sítí, kteří potřebují předměty specifické pro svět nebo menu kompasy.
• Vývojáře, kteří chtějí systém předmětů napojitelný přes API.

🏗️ Příklady použití

• Dát hráčům při join kompas menu, který po kliknutí spouští různé příkazy.
• Poskytnout jednorázové starter kity při first-join a zároveň zabránit přenosu předmětů mezi určenými světy.
• Vytvářet interaktivní předměty, které spouštějí economy/shop příkazy s cooldowns a náklady.

⌨️ Příkazy

Poznámka: tyto příkazy a podpříkazy pocházejí z dokumentovaného seznamu příkazů pluginu. Plugin nabízí další podpříkazy ve wiki a v generovaném nápovědním výstupu.

🔐 Oprávnění

Chování oprávnění pro konkrétní předměty je konfigurovatelné; kontroly oprávnění předmětů jsou ve výchozím nastavení vypnuté a musí být zapnuty v konfiguraci pluginu, aby se projevily.

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální jar soubor ItemJoin a vložte jej do složky plugins/ na vašem serveru.
• Ujistěte se, že v plugins/ nejsou duplicitní jar soubory ItemJoin (např. ItemJoin(1).jar).
• Restartujte server, aby plugin mohl vygenerovat konfiguraci a zaregistrovat funkce pro vaši verzi serveru.
• Zkontrolujte logy konzole serveru, zda se plugin načetl, a podívejte se do wiki pluginu pro podrobné nastavení.

📦 Závislosti

Plugin nemá žádné tvrdé runtime požadavky, ale uvádí několik běžných soft-dependencies a integrací (jsou volitelné a aktivují se, když jsou přítomné):

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

Integrace zapněte nebo nastavte podle potřeby; plugin funguje i bez nich, ale funkce jako placeholders, vlastní heads/skiny a economy hooky spoléhají na odpovídající pluginy.

🧠 Technické poznámky

• Platformy: potvrzeno pro servery ve stylu Spigot (Spigot, Bukkit, Paper, Purpur, Folia).
• Podporovaný/testovaný rozsah Minecraftu: 1.8 až 1.21.
• Zdrojový kód a vydání jsou zveřejněny a projekt poskytuje API na me.RockinChaos.itemjoin.api.ItemJoinAPI, které mohou jiné pluginy používat k napojení.
• Licence: LGPL-3.0.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete flexibilní, konfigurovatelný systém pro poskytování kontextových a interaktivních předmětů hráčům (menu, starter kity, nástroje specifické pro svět) a chcete API pro integrace, ItemJoin tyto funkce poskytuje a zároveň podporuje běžné placeholder a skin pluginy.