ปลั๊กอิน Minecraft EssentialsDiscord

🔌 เกี่ยวกับ EssentialsX Discord

EssentialsX Discord (แจกจ่ายในชื่อโมดูล EssentialsDiscord) เป็นโมดูลอย่างเป็นทางการของ EssentialsX ที่เชื่อมต่อเซิร์ฟเวอร์ Minecraft กับเซิร์ฟเวอร์ Discord โมดูลนี้ทำงานเป็น plugin jar ควบคู่ไปกับโมดูลหลักของ EssentialsX และเชื่อมต่อกับ Discord ผ่าน bot token ที่ตั้งค่าไว้เพื่อส่งต่อแชต เหตุการณ์ และมอบการโต้ตอบฝั่ง Discord ที่ขับเคลื่อนด้วย API ขนาดเล็ก

🎯 วัตถุประสงค์

วัตถุประสงค์หลักของโมดูลมีสองอย่าง: ส่งต่อแชต/เหตุการณ์ Minecraft ที่เลือกไปยังช่อง Discord และส่งต่อข้อความ/คำสั่ง Discord ที่เลือกไปยังเซิร์ฟเวอร์ Minecraft โมดูลนี้ออกแบบมาสำหรับผู้ดูแลเซิร์ฟเวอร์ที่ต้องการการสื่อสารโดยตรง ปรับแต่งได้ และการควบคุมระยะไกลแบบจำกัดระหว่าง Discord กับเซิร์ฟเวอร์ Minecraft ที่ใช้ EssentialsX

⚙️ ฟีเจอร์

• การแมปช่องที่ปรับแต่งได้สำหรับประเภทข้อความต่าง ๆ (แชต, join/leave, staff, ฯลฯ)
• ส่งต่อแชต Minecraft ไปยัง Discord และเลือกส่งต่อข้อความ Discord ไปยังแชต Minecraft ได้
• slash commands ฝั่ง Discord ที่สามารถรันคำสั่งคอนโซล ส่งข้อความถึงผู้เล่น และแสดงรายชื่อผู้เล่นได้ (ปรับแต่งได้และจำกัดด้วยบทบาท)
• ระบบประเภทข้อความแบบละเอียดและการจัดรูปแบบแยกตามประเภทที่กำหนดในคอนฟิกของปลั๊กอิน
• Developer API สำหรับลงทะเบียนประเภทข้อความแบบกำหนดเองและคำสั่งโต้ตอบ Discord ผ่าน API DiscordService ที่มีให้

🧩 เหมาะสำหรับใคร

• เจ้าของเซิร์ฟเวอร์ที่ใช้ EssentialsX และต้องการซิงค์แชต Discord ↔ Minecraft
• ทีม staff ที่ต้องการเชื่อมช่อง staff ส่วนตัวกับ staff ในเกม
• นักพัฒนา plugin ที่ต้องการเปิดใช้งานการโต้ตอบ Discord แบบง่าย ๆ หรือ message hooks แบบกำหนดเองไปยัง Discord

🏗️ ตัวอย่างการใช้งาน

• ส่งต่อแชตส่วนกลางไปยังช่อง Discord เฉพาะ พร้อมส่งข้อความ Discord สำหรับ staff เท่านั้นไปยัง staff ในเกม
• อนุญาตให้บทบาท Discord ที่ยืนยันแล้วรันคำสั่งหรือคำค้นหาบนเซิร์ฟเวอร์ที่กำหนดค่าไว้ผ่าน slash commands โดยไม่เปิดเผยต่อสาธารณะ
• ให้ปลั๊กอินอื่นส่งการแจ้งเตือนแบบมีโครงสร้างไปยัง Discord โดยลงทะเบียนประเภทข้อความแบบกำหนดเองผ่าน API ของ EssentialsX Discord

⌨️ คำสั่ง

EssentialsX Discord มี slash commands ฝั่ง Discord ที่ปรับแต่งได้ (ลงทะเบียนกับ Discord) แทนคำสั่งแชต Minecraft ทั่วไป คำสั่งเหล่านั้น (มีตัวอย่างในเอกสารทางการ) ทำงานจาก Discord และสามารถรันคำสั่งคอนโซล ส่งข้อความถึงผู้เล่น หรือแสดงรายชื่อผู้เล่นได้ ความพร้อมใช้งานของคำสั่งและฟีเจอร์ระดับสูงถูกควบคุมด้วยการตั้งค่าบทบาท/ID ในไฟล์คอนฟิกของปลั๊กอิน

🔐 สิทธิ์

⚙️ การติดตั้ง

📥 การตั้งค่า

• ดาวน์โหลดไฟล์ jar ของโมดูล EssentialsX Discord และวางไว้ในไดเรกทอรี plugins/ ของเซิร์ฟเวอร์พร้อมกับไฟล์ jar หลักของ EssentialsX
• เริ่มเซิร์ฟเวอร์เพื่อสร้างคอนฟิกของโมดูล แล้วหยุดเซิร์ฟเวอร์
• ตั้งค่า bot token, รหัสช่อง, message-types และการตั้งค่าบทบาทของคำสั่งใน plugins/EssentialsDiscord/config.yml ตามเอกสาร จากนั้นรีสตาร์ท

📦 การพึ่งพา

• EssentialsX (core) — โมดูลนี้ทำงานเป็น add-on สำหรับชุดปลั๊กอิน EssentialsX

🧠 หมายเหตุทางเทคนิค

• โมดูลนี้มี service API (DiscordService) เพื่อให้ปลั๊กอินอื่นลงทะเบียนประเภทข้อความแบบกำหนดเองและส่งข้อความไปยังช่อง Discord ที่ตั้งค่าไว้ได้
• คำสั่งฝั่ง Discord ถูกควบคุมด้วยบทบาท/ID ที่ตั้งค่าไว้ในไฟล์คอนฟิกของปลั๊กอิน แทนที่จะใช้ permission nodes มาตรฐานของ Minecraft
• การตั้งค่าแบบผู้ดูแลระบบ (bot token, รหัสช่อง, การจัดรูปแบบข้อความ, รหัสบทบาทของคำสั่ง) จะทำในไฟล์คอนฟิกของโมดูลที่สร้างขึ้นตอนรันครั้งแรก

🤝 ปลั๊กอินนี้มีประโยชน์เมื่อไร

เมื่อคุณต้องการการสื่อสารสองทางแบบจัดการได้และปรับแต่งได้ระหว่างชุมชน Discord กับเซิร์ฟเวอร์ Minecraft ที่ใช้ EssentialsX (รวมถึงคำสั่ง Discord ที่จำกัดด้วยบทบาทและ hook สำหรับนักพัฒนา) EssentialsX Discord จะให้โมดูลที่เน้นงานเฉพาะซึ่งจัดการการแมปข้อความและมี API ขนาดเล็กสำหรับการเชื่อมต่อ