Plugin Minecraft AzLink

🔌 Giới thiệu về AzLink

AzLink là một plugin Minecraft kết nối máy chủ game hoặc proxy với website Azuriom. Nó cung cấp cầu nối giữa runtime của server và trang Azuriom để đồng bộ dữ liệu liên quan đến tài khoản, các tích hợp shop và vote, đồng thời cung cấp placeholder phía server để dùng trong plugin và tin nhắn.

🎯 Mục đích

Mục đích chính của plugin là tích hợp website với server: giữ cho tài khoản người chơi và các tính năng do website điều khiển (mua shop, phần thưởng vote, cấp thưởng) nhất quán giữa website Azuriom và một hoặc nhiều backend server Minecraft hoặc proxy. Plugin này dành cho chủ server đang vận hành website Azuriom và cần một connector được hỗ trợ, được duy trì cho các tích hợp trong game.

⚙️ Tính năng

• Kết nối Server↔Website cho quản lý tài khoản và luồng xác thực.
• Điểm tích hợp cho các extension shop và vote của Azuriom (có thể bật qua cấu hình).
• Hỗ trợ PlaceholderAPI trên các nền tảng dựa trên Bukkit (đăng ký các placeholder như tiền website của người chơi và các placeholder liên quan đến shop/vote).
• Một file .jar dùng được trên nhiều nền tảng server được hỗ trợ (có bản legacy cho các server rất cũ).
• Hành vi dựa trên cấu hình (file config điều khiển placeholder và các tùy chọn tích hợp).

🧩 Dành cho ai

• Chủ server có website Azuriom và cần đồng bộ shop, vote hoặc tài khoản trong game.
• Các network dùng proxy (Bungee/Velocity) hoặc thiết lập một server trên các server thuộc họ Bukkit.
• Quản trị viên muốn có các placeholder sẵn sàng cho PlaceholderAPI và được điền từ dữ liệu website của họ.

🏗️ Ví dụ sử dụng

• Hiển thị số dư trên website Azuriom của người chơi trong chat hoặc bảng điểm thông qua PlaceholderAPI.
• Tự động trao vật phẩm hoặc rank trong game khi có giao dịch mua qua shop Azuriom.
• Trao thưởng vote trên server khi plugin vote của site ghi nhận một lượt vote.

⚙️ Cài đặt

📥 Thiết lập

• Tải file JAR plugin AzLink chính thức phù hợp với nền tảng của bạn và đặt vào thư mục plugins/ của server (hoặc thư mục tương đương trên nền tảng của bạn).
• Khởi động lại server để nạp plugin.
• Kiểm tra các thông báo khởi động trong console server để xác nhận AzLink đã được khởi tạo đúng.

📦 Phụ thuộc

• PlaceholderAPI — được hỗ trợ và không bắt buộc trên các server dựa trên Bukkit để đăng ký placeholder.
• Cần có một website Azuriom để tích hợp hoạt động (plugin giao tiếp với site).

🧾 Cấu hình

• AzLink tạo và sử dụng một file cấu hình, nơi bạn bật/tắt các tính năng như placeholder cho shop và vote, đồng thời cung cấp thông tin đăng nhập kết nối tới website Azuriom của bạn.
• Việc đăng ký placeholder cho các tính năng shop và vote có thể bật/tắt trong config trên các server thuộc họ Bukkit.

🧠 Ghi chú kỹ thuật

• Các nền tảng server được hỗ trợ bao gồm các server thuộc họ Bukkit (Bukkit, Spigot, Paper, Folia) và một số nền tảng proxy/alternative (BungeeCord, Velocity, Sponge). Có các bản port loader Mod/forge (Fabric/Forge/NeoForge) cho môi trường modded.
• Plugin là mã nguồn mở và được phát hành theo giấy phép MIT.
• Các bản phát hành chính thức và changelog được dự án Azuriom công bố và được duy trì trong kho AzLink.

🤝 Khi nào plugin này hữu ích

Nếu bạn chạy website Azuriom và cần một connector được duy trì để đưa các tính năng từ website vào trong game (shop, vote, dữ liệu tài khoản, placeholder), AzLink cung cấp một cầu nối đa nền tảng, có thể cấu hình để tích hợp các hệ thống đó mà không cần phát triển riêng.