ปลั๊กอิน Minecraft CommandPanels

🔌 เกี่ยวกับ CommandPanels

CommandPanels เป็นปลั๊กอิน Minecraft ที่มีระบบ GUI/menu แบบ YAML สำหรับเซิร์ฟเวอร์ โดยเน้นที่แผงแบบ inventory, แผง dialog (form) และแผงที่รองรับ Floodgate สำหรับผู้เล่น Bedrock โปรเจกต์นี้มีตัวแก้ไขออนไลน์และรูปแบบที่เป็นโครงสร้างสำหรับสร้างเมนูแบบโต้ตอบที่ขับเคลื่อนด้วยข้อมูล ซึ่งสามารถรันคำสั่ง แสดง placeholder แบบไดนามิก และตอบสนองต่อ logic และ permission ได้

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

ปลั๊กอินนี้ออกแบบมาสำหรับผู้ดูแลเซิร์ฟเวอร์และนักพัฒนาที่ต้องการ GUI ที่ยืดหยุ่นและสั่งการได้ สำหรับร้านค้า ชุดของรางวัล ล็อบบี้ เครื่องมือม็อด หรือเวิร์กโฟลว์แบบกำหนดเอง โดยถูกสร้างมาเพื่อให้แผงสามารถรันคำสั่ง ตรวจสอบเงื่อนไข ทำแอนิเมชันให้ไอเท็ม และเปิดเผยข้อมูล session หรือข้อมูลถาวรเพื่อใช้ในระบบอื่นได้

⚙️ ฟีเจอร์

• แผง inventory พร้อมการโต้ตอบกับไอเท็ม การจัดวางช่อง และชุดแอนิเมชัน
• แผง dialog สำหรับฟอร์มที่มีโครงสร้างและการรับข้อมูลจากผู้เล่น
• รองรับแผง Floodgate เพื่อแสดงแผงที่ใช้งานร่วมกันได้กับผู้เล่น Bedrock (ผ่านการตั้งค่า Geyser/Floodgate)
• logic และเงื่อนไขแบบ inline (ตัวดำเนินการสไตล์ AND/OR/NOT) เพื่อควบคุมการแสดงผลและพฤติกรรม
• ระบบคำสั่ง/การกระทำ: hook ตอนเปิด/ปิด, การกระทำเมื่อคลิก, การกระทำเมื่อคลิกนอกแผง และการรันคำสั่งแบบมีเงื่อนไข
• รองรับ PlaceholderAPI และการอัปเดต placeholder แบบไดนามิกภายในแผง
• ข้อมูลแผงแบบ session และแบบถาวรที่เข้าถึงได้ข้ามแผงและคำสั่ง
• การอัปเดตเป็นระยะและตัวเฝ้าดู permission ที่สามารถสั่งให้วิเคราะห์ logic ใหม่ทั้งหมดเมื่อ permission เปลี่ยน
• ตัวแก้ไขออนไลน์พร้อมพรีวิว YAML แบบสดและการตรวจสอบโครงสร้าง

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

ผู้ดูแลและนักพัฒนาปลั๊กอินที่รันเซิร์ฟเวอร์สมัยใหม่ที่เข้ากันได้กับ Paper และต้องการเมนู GUI ที่ยืดหยุ่น: เซิร์ฟเวอร์ Survival/SMP, เครือข่ายมินิเกม, PvP hub และเซิร์ฟเวอร์ที่ต้องการอินเทอร์เฟซแอดมิน/ม็อดแบบกำหนดเอง

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

• สร้าง GUI สำหรับ kit หรือ shop ที่รันคำสั่งของเซิร์ฟเวอร์และต้องใช้ permission เฉพาะหรือยอดเศรษฐกิจตามที่กำหนด
• สร้างเมนูนำทาง hub ด้วยไอเท็มที่มีแอนิเมชันและการแสดงผลแบบมีเงื่อนไขตามแรงก์ของผู้เล่น
• ให้เมนูที่ใช้งานร่วมกับ Bedrock ได้โดยใช้แผงเวอร์ชันเฉพาะของ Floodgate

⌨️ Commands

(คำสั่งและ permission ของคำสั่งเหล่านี้อ้างอิงจากเอกสารทางการของ CommandPanels)

🔐 Permissions

| Permission | Description | Default | |---|---|---|---| | commandpanels.command | อนุญาตให้เข้าถึงคำสั่งพื้นฐาน /pa | true | | commandpanels.command.reload | อนุญาตให้โหลดปลั๊กอินใหม่ | op | | commandpanels.command.generate | เข้าถึงคำสั่งสร้างแผง | op | | commandpanels.command.version | อนุญาตให้ตรวจสอบเวอร์ชันปลั๊กอิน | true | | commandpanels.command.data | ให้สิทธิ์เข้าถึงการตั้งค่าข้อมูลแผง | op | | commandpanels.command.open | อนุญาตให้เปิดแผงด้วย /pa open | op | | commandpanels.command.open.other | อนุญาตให้เปิดแผงให้ผู้เล่นคนอื่น | op | | commandpanels.command.help | อนุญาตให้เข้าถึง /pa help | true |

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

📥 การตั้งค่า

• ดาวน์โหลดไฟล์ .jar ทางการของ CommandPanels และวางไว้ในโฟลเดอร์ plugins/ ของเซิร์ฟเวอร์
• เริ่มต้นเซิร์ฟเวอร์เพื่อสร้างข้อมูลของปลั๊กอิน
• หลังจากรันครั้งแรก ให้ตรวจสอบ plugins/CommandPanels สำหรับ config.yml และโฟลเดอร์ panels/ ที่มีไฟล์นิยามแผง

📦 Dependencies

• PlaceholderAPI — ตัวเลือกเสริม แต่แนะนำสำหรับ placeholder แบบไดนามิก
• Floodgate — ตัวเลือกเสริมสำหรับการรองรับแผง Bedrock (Floodgate)

🧾 การตั้งค่า

• แผงถูกกำหนดเป็นไฟล์ YAML ที่วางไว้ในไดเรกทอรี panels/ และรองรับโฟลเดอร์ย่อยเพื่อการจัดระเบียบ
• ปลั๊กอินจะสร้างแผงตัวอย่างหากลบไดเรกทอรี panels/ แล้วรีสตาร์ตปลั๊กอิน

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

• เอกสารทางการและรีลีสบอกว่า Paper และ Folia (fork ของ Paper) เป็นแพลตฟอร์มเซิร์ฟเวอร์ที่รองรับสำหรับรีลีส v4 รุ่นใหม่
• สายรีลีส v4 มุ่งเน้นไปที่เวอร์ชันเซิร์ฟเวอร์ Minecraft ล่าสุด; นิยามแผงรองรับ placeholder แบบไดนามิกและ logic แบบมีเงื่อนไขที่ถูกแยกวิเคราะห์ขณะรันไทม์
• ปลั๊กอินนี้เปิดเผย permission nodes และ API แบบอิงคำสั่งสำหรับการเปิดแผง; ยังสามารถฝังเป็นไลบรารีในปลั๊กอินอื่นได้โดยโหลด YAML ของแผงและเรียกใช้การกระทำเปิด

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

หากคุณต้องการระบบ GUI ที่มีโครงสร้างและสคริปต์ได้ รองรับข้อมูลแบบไดนามิก logic แบบมีเงื่อนไข ความเข้ากันได้กับ Bedrock และตัวแก้ไขออนไลน์ CommandPanels มอบแนวทางแบบ YAML-first ที่ผ่านการยืนยันแล้วและเหมาะกับเซิร์ฟเวอร์และเครือข่ายที่ใช้ Paper