Plugin Minecraft EssentialsDiscord

🔌 Giới thiệu về EssentialsX Discord

EssentialsX Discord (được phát hành dưới dạng module EssentialsDiscord) là một module chính thức của EssentialsX, tích hợp máy chủ Minecraft với máy chủ Discord. Nó chạy như một plugin jar bên cạnh module lõi EssentialsX và kết nối với Discord qua bot token đã được cấu hình để chuyển tiếp chat, sự kiện và cung cấp các tương tác phía Discord được hỗ trợ bởi một API nhỏ.

🎯 Mục đích

Mục đích cốt lõi của module là hai phần: chuyển tiếp các chat/sự kiện Minecraft được chọn sang các kênh Discord và chuyển tiếp các tin nhắn/lệnh Discord được chọn vào máy chủ Minecraft. Nó dành cho quản trị viên máy chủ muốn có giao tiếp trực tiếp, có thể cấu hình và khả năng điều khiển từ xa giới hạn giữa Discord và một máy chủ Minecraft dùng EssentialsX.

⚙️ Tính năng

• Ánh xạ kênh có thể cấu hình cho các loại tin nhắn khác nhau (chat, join/leave, staff, v.v.).
• Chuyển tiếp chat Minecraft sang Discord và tùy chọn chuyển tiếp tin nhắn Discord vào chat Minecraft.
• Các slash command phía Discord có thể chạy lệnh console, gửi tin nhắn cho người chơi và hiển thị danh sách người chơi (có thể cấu hình và giới hạn theo vai trò).
• Hệ thống loại tin nhắn chi tiết và định dạng theo từng loại được xác định trong cấu hình plugin.
• API dành cho nhà phát triển để đăng ký loại tin nhắn tùy chỉnh và lệnh tương tác Discord thông qua API DiscordService được cung cấp.

🧩 Dành cho ai

• Chủ server dùng EssentialsX và muốn đồng bộ chat Discord ↔ Minecraft.
• Đội ngũ staff muốn các kênh staff riêng được nối với staff trong game.
• Nhà phát triển plugin muốn cung cấp các tương tác Discord đơn giản hoặc hook tin nhắn tùy chỉnh sang Discord.

🏗️ Ví dụ sử dụng

• Chuyển tiếp chat toàn cầu sang một kênh Discord riêng, đồng thời gửi các tin nhắn Discord dành riêng cho staff đến staff trong game.
• Cho phép các vai trò Discord đã xác minh chạy truy vấn hoặc lệnh server đã cấu hình qua slash command mà không công khai cho mọi người.
• Để plugin khác gửi thông báo có cấu trúc đến Discord bằng cách đăng ký một loại tin nhắn tùy chỉnh với API EssentialsX Discord.

⌨️ Lệnh

EssentialsX Discord cung cấp các slash command phía Discord có thể cấu hình (được đăng ký với Discord) thay vì các lệnh chat Minecraft thông thường. Các lệnh đó (ví dụ được nêu trong tài liệu chính thức) chạy từ Discord và có thể thực thi lệnh console, gửi tin nhắn cho người chơi hoặc hiển thị danh sách người chơi. Tính khả dụng của lệnh và các tính năng nâng cao được kiểm soát bằng cấu hình vai trò/ID trong file cấu hình plugin.

🔐 Quyền hạn

⚙️ Cài đặt

📥 Thiết lập

• Tải file jar của module EssentialsX Discord và đặt nó vào thư mục plugins/ của server cùng với file jar lõi EssentialsX.
• Khởi động server để tạo cấu hình của module, sau đó tắt server.
• Cấu hình bot token, ID kênh, message-types và thiết lập vai trò lệnh trong plugins/EssentialsDiscord/config.yml như tài liệu hướng dẫn, rồi khởi động lại.

📦 Phụ thuộc

• EssentialsX (lõi) — module chạy như một add-on cho bộ plugin EssentialsX.

🧠 Ghi chú kỹ thuật

• Module cung cấp một service API (DiscordService) để các plugin khác đăng ký loại tin nhắn tùy chỉnh và gửi tin nhắn đến các kênh Discord đã cấu hình.
• Các lệnh phía Discord được điều khiển bởi vai trò/ID được cấu hình trong file plugin thay vì các permission node chuẩn của Minecraft.
• Cấu hình kiểu quản trị (bot token, ID kênh, định dạng tin nhắn, ID vai trò lệnh) được thực hiện trong file cấu hình của module được tạo ở lần chạy đầu tiên.

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

Khi bạn cần giao tiếp hai chiều được quản lý và có thể cấu hình giữa cộng đồng Discord và một máy chủ Minecraft dùng EssentialsX (bao gồm các lệnh Discord giới hạn theo vai trò và hook cho nhà phát triển), EssentialsX Discord cung cấp một module tập trung để xử lý ánh xạ tin nhắn và một API nhỏ cho tích hợp.