Plugin Minecraft AzLink

🔌 O AzLink

AzLink to wtyczka Minecraft, która łączy serwer gry lub proxy z witryną Azuriom. Zapewnia pomost między środowiskiem uruchomieniowym serwera a witryną Azuriom, aby synchronizować dane związane z kontem, integracje sklepu i głosów oraz udostępniać placeholdery po stronie serwera do użycia w wtyczkach i wiadomościach.

🎯 Cel

Głównym celem wtyczki jest integracja między stroną a serwerem: utrzymywanie spójności kont graczy i funkcji sterowanych przez witrynę (zakupy w sklepie, nagrody za głosy, przyznawanie nagród) między witryną Azuriom a jednym lub większą liczbą backendów lub proxy serwerów Minecraft. Jest przeznaczona dla właścicieli serwerów, którzy prowadzą witrynę Azuriom i potrzebują wspieranego, utrzymywanego łącznika do integracji w grze.

⚙️ Funkcje

• Połączenie Serwer↔Witryna do zarządzania kontami i przepływów uwierzytelniania.
• Punkty integracji dla rozszerzeń sklepu i głosów Azuriom (można włączyć w konfiguracji).
• Obsługa PlaceholderAPI na platformach opartych na Bukkit (rejestruje placeholdery, takie jak pieniądze gracza na stronie oraz placeholdery związane ze sklepem/głosami).
• Jeden plik .jar działa na wielu obsługiwanych platformach serwerowych (z buildami legacy dla bardzo starych serwerów).
• Zachowanie sterowane konfiguracją (plik konfiguracyjny kontroluje placeholdery i opcje integracji).

🧩 Dla kogo jest ta wtyczka

• Dla właścicieli serwerów prowadzących witrynę Azuriom, którzy potrzebują synchronizacji sklepu, głosów lub kont w grze.
• Dla sieci używających proxy (Bungee/Velocity) lub konfiguracji jednoserwerowych na serwerach z rodziny Bukkit.
• Dla administratorów, którzy chcą placeholderów gotowych do PlaceholderAPI, wypełnianych danymi z ich witryny.

🏗️ Przykładowe zastosowania

• Wyświetlanie salda gracza z witryny Azuriom na czacie lub tablicach wyników za pomocą PlaceholderAPI.
• Automatyczne przyznawanie przedmiotów lub rang w grze po dokonaniu zakupu w sklepie Azuriom.
• Przyznawanie nagród za głosy na serwerze, gdy wtyczka głosów na stronie zarejestruje głos.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR wtyczki AzLink odpowiedni dla twojej platformy i umieść go w katalogu plugins/ serwera (lub jego odpowiedniku na danej platformie).
• Uruchom ponownie serwer, aby załadować wtyczkę.
• Sprawdź komunikaty startowe w konsoli serwera, aby potwierdzić, że AzLink został poprawnie zainicjalizowany.

📦 Zależności

• PlaceholderAPI — obsługiwane i opcjonalne na serwerach opartych na Bukkit do rejestracji placeholderów.
• Do działania integracji wymagana jest instancja witryny Azuriom (wtyczka komunikuje się z witryną).

🧾 Konfiguracja

• AzLink tworzy i używa pliku konfiguracyjnego, w którym włączasz/wyłączasz funkcje takie jak placeholdery sklepu i głosów oraz podajesz dane logowania do swojej witryny Azuriom.
• Rejestrację placeholderów dla funkcji sklepu i głosów można przełączać w konfiguracji na serwerach rodziny Bukkit.

🧠 Uwagi techniczne

• Obsługiwane platformy serwerowe obejmują serwery z rodziny Bukkit (Bukkit, Spigot, Paper, Folia) oraz kilka platform proxy/alternatywnych (BungeeCord, Velocity, Sponge). Istnieją porty z loaderami mod/forge (Fabric/Forge/NeoForge) dla środowisk modded.
• Wtyczka jest open source i wydana na licencji MIT.
• Oficjalne wydania i changelogi są publikowane przez projekt Azuriom i utrzymywane w repozytorium AzLink.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli prowadzisz witrynę Azuriom i potrzebujesz utrzymywanego łącznika, który udostępni w grze funkcje sterowane przez stronę (sklep, głosy, dane konta, placeholdery), AzLink oferuje konfigurowalny, wieloplatformowy pomost integrujący te systemy bez potrzeby tworzenia własnych rozwiązań.