ปลั๊กอิน Minecraft AxRewards

🔌 เกี่ยวกับ AxRewards

AxRewards คือปลั๊กอิน Minecraft ที่มอบระบบรางวัลแบบเบาและปรับแต่งได้ ผู้ดูแลเซิร์ฟเวอร์กำหนดรางวัลด้วย cooldown แบบกำหนดเอง แสดงรางวัลผ่าน GUI ที่แก้ไขได้ และสั่งงานคำสั่งรับรางวัลเมื่อผู้เล่นกดรับรางวัล โปรเจกต์นี้ดูแลโดย Artillex-Studios และมีการจัดเก็บข้อมูลบนฐานข้อมูลพร้อมรองรับหลายเซิร์ฟเวอร์

🎯 จุดประสงค์

AxRewards แก้ความต้องการที่พบบ่อยสำหรับรางวัลผู้เล่นแบบกำหนดเวลา หรือแบบทำซ้ำได้ (เช่น รางวัลล็อกอินรายวันหรือรายสัปดาห์) พร้อมทั้งมี cooldown ที่ยืดหยุ่น การล็อกด้วย permission และการแสดงผลผ่าน GUI เหมาะสำหรับเซิร์ฟเวอร์ที่ต้องการระบบรางวัลแบบรวมศูนย์และปรับแต่งได้ โดยไม่ต้องพึ่งระบบแคชภายนอก

⚙️ ฟีเจอร์

• รางวัลที่ปรับแต่งได้พร้อม cooldown แบบกำหนดเอง (ระบุเป็นวินาที)
• เมนู GUI ที่แก้ไขได้สำหรับแสดงรางวัล; ไอเท็มใน GUI สามารถแสดงสถานะต่าง ๆ ได้ (รับได้ / รับไม่ได้ / ไม่มี permission)
• จัดเก็บในฐานข้อมูลพร้อมรองรับ H2, SQLite, MySQL และ PostgreSQL
• รองรับหลายเซิร์ฟเวอร์โดยไม่ต้องใช้ Redis
• GUI อัปเดตอัตโนมัติ (รีเฟรชเป็นระยะโดยไม่ต้องเปิดใหม่)
• สามารถล็อก rางวัลไว้หลัง permission ได้ (แต่ละรางวัลสามารถต้องใช้ permission)
• การกระทำเมื่อรับรางวัลถูกทำเป็นรายการคำสั่งของเซิร์ฟเวอร์ (รองรับ placeholder %player%)
• ผสานรวมกับ PlaceholderAPI และรองรับรูปแบบสีหลายแบบ

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

• เซิร์ฟเวอร์ Survival และ SMP ที่ต้องการรางวัลรับได้รายวัน/รายสัปดาห์/แบบกำหนดเอง
• ผู้ดูแลเซิร์ฟเวอร์ที่ต้องการการเก็บข้อมูลแบบถาวรผ่านฐานข้อมูลระหว่างการรีสตาร์ตหรือข้ามหลายเซิร์ฟเวอร์
• แอดมินที่ชอบการนำเสนอรางวัลผ่าน GUI และรางวัลที่ล็อกด้วย permission

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

• เสนอรางวัลล็อกอินรายวันที่ให้ไอเท็มหรือรันคำสั่งเมื่อกดรับ
• ให้รางวัล VIP รายสัปดาห์แบบจำกัดที่ต้องใช้ permission ของยศในการรับ
• รันรางวัลแบบคำสั่งที่ให้เงิน ไอเท็ม หรือสั่งงานคำสั่งเซิร์ฟเวอร์แบบกำหนดเองโดยใช้ %player%

⌨️ คำสั่ง

(แสดงเฉพาะคำสั่งที่ยืนยันในเอกสารทางการเท่านั้น)

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

📥 การตั้งค่า

• ดาวน์โหลดไฟล์ JAR ของปลั๊กอินและวางไว้ในโฟลเดอร์ plugins/ ของเซิร์ฟเวอร์สำหรับเซิร์ฟเวอร์ที่รองรับ Bukkit/Spigot/Paper
• เริ่มหรือรีสตาร์ตเซิร์ฟเวอร์เพื่อให้ปลั๊กอินสร้างโฟลเดอร์ข้อมูลและการตั้งค่าได้
• ไฟล์การตั้งค่าและเมนูจะอยู่ในโฟลเดอร์ปลั๊กอิน (เช่น plugins/AxRewards/menus)

📦 สิ่งที่ต้องมี

• PlaceholderAPI (การผสานรวมแบบเลือกใช้สำหรับ placeholder) — ยืนยันการรองรับแล้ว

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

• Backend ฐานข้อมูลที่ยืนยันแล้ว: H2, SQLite, MySQL, PostgreSQL
• ปลั๊กอินรองรับ PlaceholderAPI และรูปแบบสีที่ใช้ทั่วไป (รวมถึง MiniMessage และ legacy formats)
• GUI รีเฟรชอัตโนมัติ (auto-updating) โดยไม่ต้องให้ผู้เล่นเปิดใหม่
• รางวัลกำหนด cooldown เป็นวินาที; ตั้ง cooldown เป็น -1 จะทำให้รางวัลไม่รีเฟรชอีกเลย
• โปรเจกต์เป็น open-source และใช้สัญญาอนุญาต MIT
• ซอฟต์แวร์เซิร์ฟเวอร์และหัวข้อที่รองรับและยืนยันแล้ว ได้แก่ Bukkit, Spigot, Paper และ Folia
• ข้อกำหนดที่ยืนยันแล้ว: Java runtime รุ่นใหม่ (หมายเหตุของโปรเจกต์ระบุ Java 21 ขึ้นไปสำหรับรุ่นล่าสุด)

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

หากคุณต้องการระบบรางวัลที่ปรับแต่งได้ ควบคุมผ่าน GUI มีการจัดเก็บถาวรและรองรับข้ามเซิร์ฟเวอร์ AxRewards มอบเมนูที่แก้ไขได้ การจัดการ cooldown และการรับรางวัลผ่านคำสั่ง พร้อมทั้งผสานกับ PlaceholderAPI และฐานข้อมูลทั่วไป