Minecraft plugin AzLink

🔌 O AzLink

AzLink je Minecraft plugin, který propojuje herní server nebo proxy s webem Azuriom. Poskytuje most mezi serverovým runtime a webem Azuriom pro synchronizaci dat souvisejících s účty, integrací shopu a hlasování a také zpřístupňuje server-side placeholdery pro použití v pluginech a zprávách.

🎯 Účel

Hlavním účelem pluginu je integrace webu se serverem: udržovat účty hráčů a funkce řízené webem (nákupy v shopu, odměny za hlasování, udělování odměn) v souladu mezi webem Azuriom a jedním nebo více backendy Minecraft serverů či proxy. Je určen pro majitele serverů, kteří provozují web Azuriom a potřebují podporovaný, udržovaný konektor pro herní integrace.

⚙️ Funkce

• Propojení Server↔Website pro správu účtů a autentizační toky.
• Integrační body pro rozšíření shopu a hlasování Azuriom (lze zapnout v konfiguraci).
• Podpora PlaceholderAPI na platformách založených na Bukkitu (registruje placeholdery, jako jsou hráčovy webové peníze a placeholdery související se shopem/hlasováním).
• Jeden .jar funguje napříč více podporovanými serverovými platformami (s legacy buildy pro velmi staré servery).
• Chování řízené konfigurací (konfigurační soubor ovládá placeholdery a možnosti integrace).

🧩 Pro koho je to určeno

• Majitelé serverů provozující web Azuriom, kteří potřebují synchronizaci shopu, hlasování nebo účtů ve hře.
• Sítě používající proxy (Bungee/Velocity) nebo single-server setupy na serverech rodiny Bukkit.
• Administrátoři, kteří chtějí placeholdery připravené pro PlaceholderAPI naplněné daty z jejich webu.

🏗️ Příklady použití

• Zobrazit zůstatek hráče z webu Azuriom v chatu nebo na scoreboardech přes PlaceholderAPI.
• Automaticky udělit herní předměty nebo ranky při nákupu přes shop Azuriom.
• Udělit odměny za hlasování na serveru, když plugin hlasování na webu zaznamená hlas.

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální JAR pluginu AzLink vhodný pro vaši platformu a umístěte jej do adresáře plugins/ serveru (nebo ekvivalentního adresáře na vaší platformě).
• Restartujte server, aby se plugin načetl.
• Zkontrolujte startovací hlášky v konzoli serveru, abyste ověřili, že byl AzLink správně inicializován.

📦 Závislosti

• PlaceholderAPI — na serverech založených na Bukkitu je podporované a volitelné pro registraci placeholderů.
• Pro fungování integrace je vyžadována instance webu Azuriom (plugin komunikuje s webem).

🧾 Konfigurace

• AzLink vytváří a používá konfigurační soubor, ve kterém zapínáte/vypínáte funkce jako placeholdery pro shop a hlasování a zadáváte přihlašovací údaje pro připojení k webu Azuriom.
• Registraci placeholderů pro funkce shopu a hlasování lze na serverech rodiny Bukkit přepínat v configu.

🧠 Technické poznámky

• Podporované serverové platformy zahrnují servery rodiny Bukkit (Bukkit, Spigot, Paper, Folia) a několik proxy/alternativních serverových platforem (BungeeCord, Velocity, Sponge). Pro modded prostředí existují porty loaderů Mod/forge (Fabric/Forge/NeoForge).
• Plugin je open-source a publikován pod licencí MIT.
• Oficiální vydání a changelogy zveřejňuje projekt Azuriom a jsou udržovány v repozitáři AzLink.

🤝 Kdy je tento plugin užitečný

Pokud provozujete web Azuriom a potřebujete udržovaný konektor, který ve hře zpřístupní funkce řízené webem (shop, hlasy, data účtu, placeholdery), AzLink nabízí konfigurovatelný, multiplatformní most, který tyto systémy integruje bez vlastní vývoje.