Плагін Minecraft AzLink

🔌 Про AzLink

AzLink — це плагін Minecraft, який з'єднує ігровий сервер або proxy із сайтом Azuriom. Він створює міст між середовищем роботи сервера та сайтом Azuriom, щоб синхронізувати дані, пов’язані з акаунтами, інтеграції магазину та голосувань, а також відкривати server-side placeholders для використання в плагінах і повідомленнях.

🎯 Призначення

Основне призначення плагіна — інтеграція сайту із сервером: підтримувати узгодженість акаунтів гравців і функцій, керованих сайтом (покупки в магазині, нагороди за голосування, видача нагород), між сайтом Azuriom і одним або кількома бекендами Minecraft-серверів чи proxy. Він створений для власників серверів, які мають сайт Azuriom і потребують підтримуваного, актуального конектора для внутрішньоігрових інтеграцій.

⚙️ Можливості

• Зв’язування Server↔Website для керування акаунтами та процесів автентифікації.
• Точки інтеграції для розширень магазину та голосувань Azuriom (можна увімкнути через конфігурацію).
• Підтримка PlaceholderAPI на платформах на базі Bukkit (реєструє placeholders, наприклад гроші гравця на сайті та placeholders, пов’язані з магазином/голосуваннями).
• Один .jar працює на кількох підтримуваних платформах серверів (із legacy-збірками для дуже старих серверів).
• Поведінка через конфігурацію (файл налаштувань керує placeholders і параметрами інтеграції).

🧩 Для кого це

• Власники серверів, які мають сайт Azuriom і потребують синхронізації магазину, голосувань або акаунтів у грі.
• Мережі, що використовують proxy (Bungee/Velocity), або одиночні сервери на серверах сімейства Bukkit.
• Адміністратори, яким потрібні placeholders, готові до PlaceholderAPI, заповнені даними з їхнього сайту.

🏗️ Приклади використання

• Відображати баланс гравця на сайті Azuriom у чаті або на табло через PlaceholderAPI.
• Автоматично видавати ігрові предмети або ранги після покупки через магазин Azuriom.
• Нараховувати нагороди за голосування на сервері, коли плагін голосувань на сайті фіксує голос.

⚙️ Встановлення

📥 Налаштування

• Завантажте офіційний JAR-плагін AzLink, відповідний вашій платформі, і помістіть його в каталог plugins/ сервера (або еквівалентний каталог на вашій платформі).
• Перезапустіть сервер, щоб завантажити плагін.
• Перевірте повідомлення під час запуску в консолі сервера, щоб переконатися, що AzLink успішно ініціалізовано.

📦 Залежності

• PlaceholderAPI — підтримується та є необов’язковим на серверах на базі Bukkit для реєстрації placeholders.
• Для роботи інтеграції потрібен екземпляр сайту Azuriom (плагін взаємодіє із сайтом).

🧾 Конфігурація

• AzLink створює та використовує файл конфігурації, у якому ви вмикаєте/вимикаєте функції, наприклад placeholders для магазину та голосувань, і вказуєте дані для підключення до вашого сайту Azuriom.
• Реєстрацію placeholders для функцій магазину та голосувань можна вмикати або вимикати в config на серверах сімейства Bukkit.

🧠 Технічні примітки

• Підтримувані серверні платформи включають сервери сімейства Bukkit (Bukkit, Spigot, Paper, Folia) та кілька proxy/альтернативних платформ (BungeeCord, Velocity, Sponge). Існують порти завантажувачів Mod/forge (Fabric/Forge/NeoForge) для модифікованих середовищ.
• Плагін є open-source і поширюється під ліцензією MIT.
• Офіційні релізи та changelog публікує проєкт Azuriom і підтримує репозиторій AzLink.

🤝 Коли цей плагін корисний

Якщо ви керуєте сайтом Azuriom і вам потрібен підтримуваний конектор, щоб показувати функції сайту в грі (магазин, голосування, дані акаунта, placeholders), AzLink надає налаштовуваний, мультиплатформений міст, який інтегрує ці системи без кастомної розробки.