Plugin Minecraft Tebex

🔌 Giới thiệu Tebex

Tebex là một plugin Minecraft kết nối máy chủ đang chạy với Tebex webstore để các giao dịch mua trực tuyến được tự động gửi vào trong game. Nó triển khai Tebex Plugin API chính thức và cung cấp khả năng xử lý đơn hàng ở phía server (items, ranks, commands, subscriptions) cho các nền tảng server được hỗ trợ.

🎯 Mục đích

Mục đích cốt lõi của Tebex là tự động hóa việc phân phối các giao dịch mua trong cửa hàng được tạo ở Tebex webstore. Chủ server dùng plugin để kết nối server game của họ với cửa hàng, thực thi các server command đã cấu hình khi giao dịch được hoàn tất, và cung cấp cho người chơi các liên kết mua hàng cùng thông tin liên quan đến cửa hàng ngay trong game.

⚙️ Tính năng

• Tự động xử lý đơn hàng: plugin kiểm tra Tebex và chạy các server command đã cấu hình để giao hàng khi người chơi đang online.
• Kết nối cửa hàng bằng secret key: kết nối server với cửa hàng bằng command secret key phía server.
• Các command trong game cho checkout và thông tin cửa hàng để tạo liên kết thanh toán hoặc xem dữ liệu cửa hàng.
• Các command dành cho admin và debug để gửi link, buộc kiểm tra, làm mới dữ liệu gói, và bật debug logging.
• Hỗ trợ nhiều nền tảng thông qua các bản build chính thức cho các server platform phổ biến.

🧩 Dành cho ai

• Chủ server bán items, ranks, hoặc subscriptions thông qua Tebex webstore.
• Quản trị viên cần xử lý tự động các giao dịch mua trực tuyến trên Bukkit/Spigot/Paper và các nền tảng được hỗ trợ khác.
• Các network muốn có một tích hợp chính thức, được duy trì giữa webstore và các game server của họ.

🏗️ Ví dụ sử dụng

• Một server bán các vật phẩm trang trí trong Tebex store và plugin tự động trao item cho người chơi khi họ tham gia lần tiếp theo.
• Một admin tạo liên kết thanh toán cho người ủng hộ bằng command trong game rồi gửi nó cho người chơi.
• Một giao dịch mua trong store chạy một command để thêm người chơi vào nhóm quyền hoặc cấp một subscription tạm thời.

⌨️ Commands

🔐 Quyền hạn

Tất cả command đều dùng một permission node khớp chính xác với tên command như được ghi trong tài liệu. Giá trị mặc định không được nêu trong tài liệu chính thức.

⚙️ Cài đặt

📥 Thiết lập

• Tải xuống bản build plugin chính thức cho nền tảng server của bạn.
• Đặt file JAR của plugin vào thư mục plugins/ của server (hoặc mods/ đối với các nền tảng modded được hỗ trợ).
• Khởi động lại server và kiểm tra console để xác nhận plugin đã được tải.
• Với tư cách là quản trị viên server, chạy command secret key để kết nối server với store của bạn.

📦 Phụ thuộc

• Không có phụ thuộc runtime nào được ghi trong hướng dẫn cài đặt chính thức. Việc build dự án cần một môi trường phát triển Java.

🧠 Ghi chú kỹ thuật

• Các bản build chính thức được cung cấp cho nhiều server platform và dự án được duy trì bởi đội ngũ Tebex.
• Plugin kiểm tra dịch vụ Tebex và chạy các server command đã cấu hình để xử lý giao dịch mua trên nền tảng server của bạn.
• Repository và các bản build chính thức được cấp phép theo GPL-3.0.

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

Nếu bạn vận hành một Tebex webstore và cần xử lý giao dịch mua ở phía server một cách đáng tin cậy, chính thức (items, ranks, hoặc commands), plugin Tebex cung cấp tích hợp và công cụ trong game để kết nối server của bạn với store và tự động hóa việc phân phối mà không cần scripting tùy chỉnh.