ปลั๊กอิน Minecraft PermissionsEx

🔌 เกี่ยวกับ PermissionsEx

PermissionsEx (PEX) คือปลั๊กอิน Minecraft ที่ให้ระบบจัดการ permission และกลุ่มแบบครบเครื่องสำหรับเซิร์ฟเวอร์และเครือข่าย proxy โดยมี API สำหรับนักพัฒนา รองรับการใช้งานบนหลายแพลตฟอร์ม และออกแบบมาให้ขยายต่อได้ด้วย datastore backend และ platform adapter ที่หลากหลาย

🎯 จุดประสงค์

PermissionsEx ถูกสร้างมาสำหรับผู้ดูแลเซิร์ฟเวอร์และนักพัฒนาปลั๊กอินที่ต้องการควบคุม permission nodes, ลำดับชั้นของกลุ่ม และการสอบถาม permission ขณะรันไทม์อย่างละเอียด รองรับทั้งการตั้งค่าแบบเซิร์ฟเวอร์เดียวและแบบหลายเซิร์ฟเวอร์/proxy ผ่าน build เฉพาะแพลตฟอร์มและ core ที่ไม่ผูกกับการใช้งานแบบใดแบบหนึ่ง

⚙️ คุณสมบัติ

• กำหนด permission node แบบละเอียดและจัดการกลุ่มได้
• API แบบโปรแกรมสำหรับปลั๊กอินในการ query และแก้ไข permission ขณะรันไทม์
• สถาปัตยกรรม datastore แบบเสียบเพิ่มได้ (รองรับการเพิ่มหรือทำ backend ใหม่)
• มีการใช้งานบนหลายแพลตฟอร์ม (Bukkit/Spigot/Paper, Sponge, BungeeCord/Waterfall, Velocity, Fabric)
• มี build artifact สำหรับการติดตั้งเฉพาะแพลตฟอร์ม และ artifact สำหรับพัฒนาเพื่อใช้เป็นไลบรารี

🧩 เหมาะกับใคร

• ผู้ดูแลเซิร์ฟเวอร์ที่ต้องการกลุ่ม permission ที่เป็นระบบและ inheritance
• เครือข่ายที่ใช้ proxy (BungeeCord/Waterfall, Velocity) และต้องการระบบ permission ที่สอดคล้องกันใน backend servers
• นักพัฒนาปลั๊กอินที่ต้องการ API สำหรับอ่านหรือแก้ไขข้อมูล permission แบบโปรแกรม

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

• สร้างกลุ่มตามบทบาท (admin, moderator, builder, default) พร้อมชุด permission ที่แตกต่างกัน
• เครือข่ายที่ใช้ proxy และใช้ build ของแพลตฟอร์มเพื่อให้การจัดการ permission สอดคล้องกันใน backend servers
• นักพัฒนาที่ผสานการตรวจ permission ลงในปลั๊กอินแบบกำหนดเองผ่าน PEX API

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

📥 การตั้งค่า

• ดาวน์โหลด build อย่างเป็นทางการของแพลตฟอร์ม (โปรเจ็กต์จะสร้าง .jar artifact สำหรับแพลตฟอร์มเซิร์ฟเวอร์ที่รองรับ)
• วางไฟล์ .jar ลงในโฟลเดอร์ plugins/ ของเซิร์ฟเวอร์สำหรับเซิร์ฟเวอร์แบบ Bukkit/Spigot/Paper (หรือโฟลเดอร์ plugin/mod ที่เหมาะสมสำหรับแพลตฟอร์มอื่น)
• รีสตาร์ทเซิร์ฟเวอร์และดูคอนโซลเพื่อยืนยันว่าปลั๊กอินถูกโหลดและสร้างโฟลเดอร์ config/data แล้ว

📦 Dependencies

• โดยค่าเริ่มต้น core repository ไม่ต้องใช้ runtime dependencies; มี build เฉพาะแพลตฟอร์มให้ใช้งานอยู่แล้ว (อย่าคิดเอาเองว่าต้องมีปลั๊กอินเพิ่มเติม เว้นแต่ build หรือเอกสารที่คุณเลือกจะระบุไว้)

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

• โปรเจ็กต์มี core แบบโมดูลาร์และการใช้งานเฉพาะแพลตฟอร์ม โดยแจกจ่ายเป็น artifact แยกสำหรับแพลตฟอร์มเซิร์ฟเวอร์และ proxy ที่ต่างกัน
• มี API และ artifact สำหรับ Maven/Gradle สำหรับนักพัฒนาที่ต้องการนำส่วนประกอบของ PEX ไปใช้ในโปรเจ็กต์อื่น
• ที่เก็บซอร์สโค้ดได้รับการดูแลแบบสาธารณะ และมี issue tracker พร้อมทรัพยากรเอกสารสำหรับการตั้งค่าและการพัฒนา

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

ถ้าคุณต้องการระบบ permission ที่แยก logic หลักออกจากการทำงานเฉพาะแพลตฟอร์ม และมี API สำหรับนักพัฒนา PermissionsEx จะมีประโยชน์ เพราะมันมี build เฉพาะแพลตฟอร์ม, datastore ที่ขยายได้, และการเข้าถึงข้อมูล permission แบบโปรแกรม