Plugin Minecraft DiscordSRV

🔌 Giới thiệu về DiscordSRV

DiscordSRV là một plugin Minecraft kết nối máy chủ Minecraft và máy chủ Discord. Nó chuyển tiếp chat trong game sang Discord (và tin nhắn Discord vào game), hỗ trợ liên kết tài khoản giữa tài khoản Minecraft và Discord, đồng thời cung cấp các hook đồng bộ cho vai trò/nhóm và nhiều sự kiện của máy chủ.

🎯 Mục đích

Mục đích cốt lõi của DiscordSRV là cung cấp một cầu nối đáng tin cậy, có thể cấu hình giữa máy chủ Minecraft và Discord, để cộng đồng có thể giao tiếp trên cả hai nền tảng, đội ngũ quản trị luôn được cập nhật và thông tin thành viên/vai trò được đồng bộ khi được thiết lập.

⚙️ Tính năng

• Đồng bộ chat hai chiều giữa các kênh Minecraft và Discord (có thể cấu hình theo từng kênh).
• Liên kết tài khoản Minecraft <-> Discord cho người chơi.
• Hook đồng bộ vai trò/nhóm (điểm tích hợp cho các plugin phân quyền như LuckPerms).
• Phát thông báo và tin nhắn staff từ Minecraft sang Discord.
• Lệnh để liên kết, kiểm tra trạng thái liên kết và các thao tác quản trị (reload, resync, debug).
• Nhiều tệp cấu hình cho ánh xạ kênh, ngôn ngữ/tin nhắn, đồng bộ và tính năng voice.
• Mã nguồn mở với trình theo dõi lỗi công khai và các bản phát hành.

🧩 Dành cho ai

• Chủ server và quản trị viên muốn thống nhất chat cộng đồng giữa Minecraft và Discord.
• Đội ngũ kiểm duyệt cần nhìn thấy sự kiện của server trên Discord.
• Các network dùng plugin permissions và muốn đồng bộ vai trò hoặc nhóm với Discord.

🏗️ Ví dụ sử dụng

• Chuyển tiếp chat Minecraft toàn cục hoặc theo kênh sang các kênh Discord cụ thể để người dùng ngoài server vẫn theo dõi được cuộc trò chuyện.
• Liên kết tài khoản người chơi với Discord ID để cấp role Discord hoặc xác minh người dùng giữa các nền tảng.
• Gửi log join/leave/console của server đến một kênh kiểm duyệt trên Discord.

⌨️ Lệnh

Lệnh con của người chơi:

Lệnh dành cho staff:

(Các lệnh đã lỗi thời liên quan đến hệ thống subscription cũ được ghi trong lịch sử nhưng đã bị xóa khỏi hoạt động hiện tại.)

🔐 Quyền

⚙️ Cài đặt

📥 Thiết lập

• Tải xuống file .jar chính thức của DiscordSRV từ nguồn phân phối chính thức (trang dự án / danh mục / bản phát hành).
• Đặt file jar vào thư mục plugins/ của server bạn cho một máy chủ tương thích với Bukkit/Spigot.
• Khởi động lại server và kiểm tra log console để xác nhận DiscordSRV đã được tải.
• Hoàn tất cấu hình ban đầu (bot token, ánh xạ kênh, tùy chọn liên kết) bằng các tệp cấu hình được tạo ra.

📦 Tệp cấu hình

DiscordSRV sử dụng nhiều tệp cấu hình; các tên tệp đã xác nhận gồm:

• config.yml
• messages.yml
• linking.yml
• synchronization.yml
• voice.yml
• alerts.yml

Chỉnh sửa các tệp thích hợp để thiết lập bot token Discord, ánh xạ kênh và cài đặt đồng bộ. Một số tính năng (đồng bộ vai trò/nhóm, tích hợp voice) cần thêm cấu hình.

🧠 Ghi chú kỹ thuật

• Mã nguồn và các bản phát hành được duy trì trên một kho lưu trữ công khai.
• Dự án được phát hành theo GPL-3.0.
• Các tích hợp tùy chọn đã xác nhận bao gồm LuckPerms (contexts/đồng bộ nhóm) và PlaceholderAPI (placeholders).
• Các lệnh và quyền được ghi trong tài liệu chính thức; các thao tác quản trị như resync và reload có tồn tại và có thể cần quyền operator.

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

Nếu bạn cần chat hai chiều ổn định, có thể cấu hình và liên kết tài khoản giữa server Minecraft và cộng đồng Discord, DiscordSRV cung cấp cầu nối, các hook tích hợp và các tệp cấu hình để vận hành những tính năng đó cùng với các plugin server phổ biến.