ปลั๊กอิน Minecraft eco

🔌 เกี่ยวกับ eco

eco คือไลบรารีสำหรับพัฒนา Spigot (ปลั๊กอิน Minecraft แบบแยกเดี่ยว) ที่ออกแบบมาเพื่อทำให้การพัฒนาปลั๊กอินง่ายขึ้น และมอบฟีเจอร์ฝั่ง engine ที่นำกลับมาใช้ซ้ำได้สำหรับปลั๊กอินอื่น ๆ มันมี API สำหรับคำสั่งและการตั้งค่า, ตัวเชื่อมสำหรับการจัดเก็บแบบถาวร, ระบบ GUI และไอเทมแบบกำหนดเอง รวมถึงการเชื่อมต่อกับบริการต่าง ๆ มากมาย เพื่อให้ผู้เขียนปลั๊กอินสามารถนำฟังก์ชันที่ใช้ร่วมกันกลับมาใช้ซ้ำ แทนที่จะต้องเขียนใหม่ทั้งหมด

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

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

⚙️ ฟีเจอร์

• API คำสั่งแบบทันสมัยและการแยกวิเคราะห์
• การแยกสีแบบ native พร้อมรองรับ hex / RGB / MiniMessage
• ระบบ config ที่รองรับ YAML, JSON และ TOML
• API สำหรับการจัดเก็บข้อมูลแบบถาวร พร้อม backend แบบ YAML, MySQL และ MongoDB
• API สำหรับ GUI และคอมโพเนนต์สำเร็จรูป
• ไอเทมแบบกำหนดเองและการจัดการ ItemStack ที่รวดเร็วมาก
• การแสดงไอเทมผ่าน packet และ packet event loop ที่เบา
• API AI ของ entity พร้อม mapping ของ NMS เกือบ 1:1
• Placeholder API และการเชื่อมต่อแบบ native (โครงการระบุไว้มากกว่า 30 การเชื่อมต่อ)
• การแยกชั้นราคา/เศรษฐกิจ (ระบบราคาที่รองรับปลั๊กอินเศรษฐกิจ, XP, ไอเทม)
• รองรับ bStats แบบ native และการตรวจสอบอัปเดตปลั๊กอิน
• ระบบ extension (ปลั๊กอินสำหรับปลั๊กอิน) และเครื่องมือ dependency-injection สำหรับนักพัฒนา

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

• ผู้พัฒนาปลั๊กอินที่สร้างปลั๊กอินเข้ากันได้กับ Spigot/Paper และต้องการเฟรมเวิร์กที่ใช้ซ้ำได้
• เจ้าของเซิร์ฟเวอร์ที่รันปลั๊กอินซึ่งพึ่งพา eco (ต้องติดตั้ง eco เป็น dependency)
• โปรเจ็กต์ที่ต้องการไอเทมแบบกำหนดเอง, GUI หรือเครื่องมือจัดการการเก็บข้อมูลและคำสั่งแบบรวมศูนย์

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

• นักพัฒนาสร้างแพ็กไอเทมแบบกำหนดเองที่ใช้ API ค้นหาไอเทมและ GUI ของ eco
• ปลั๊กอินใช้ API การจัดเก็บของ eco เพื่อรองรับทั้ง YAML ในเครื่องและ backend MongoDB ระยะไกลโดยไม่ต้องเขียนโค้ดซ้ำ
• ปลั๊กอินขนาดเล็กหลายตัวใช้ eco ร่วมกันเพื่อให้การจัดการคำสั่งและการแยกสีมีความสอดคล้องกัน

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

📥 การตั้งค่า

• ติดตั้ง eco เป็นปลั๊กอินบนเซิร์ฟเวอร์ใดก็ตามที่ต้องใช้ โดยวางไฟล์ JAR ลงในโฟลเดอร์ plugins/ ของเซิร์ฟเวอร์แล้วรีสตาร์ตเซิร์ฟเวอร์
• หากปลั๊กอินอื่นพึ่งพา eco ให้ประกาศใน plugin.yml ของปลั๊กอินนั้นภายใต้ depend: ด้วย - eco เพื่อให้เซิร์ฟเวอร์โหลด eco ก่อน

📦 Dependency (สำหรับผู้พัฒนาปลั๊กอิน)

• โครงการเผยแพร่ Maven repository และ Gradle coordinates สำหรับการใช้งานแบบ compile-only โครงการมี artifact ที่เผยแพร่แล้ว (เช่น group com.willfp และ tag เวอร์ชัน) เพื่อให้นักพัฒนาเพิ่ม eco เป็น dependency แบบ provided ระหว่าง build

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

• ซอฟต์แวร์เซิร์ฟเวอร์ที่รองรับ: โครงการทางการระบุว่ารองรับ Spigot, Paper, Purpur และ Folia
• เวอร์ชัน Minecraft ที่รองรับ: โครงการระบุว่ารองรับตั้งแต่ 1.21.4 เป็นต้นไป และ build รุ่นต่อไปมุ่งไปที่ซีรีส์ 1.21.x รุ่นใหม่
• Backend การจัดเก็บ: เฟรมเวิร์กมีตัวเชื่อม YAML, MySQL และ MongoDB ให้
• ไลเซนส์: eco เผยแพร่ภายใต้สัญญาอนุญาต MIT

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

หากคุณกำลังพัฒนาหลายฟีเจอร์หรือหลายปลั๊กอินที่มีความต้องการร่วมกัน (คำสั่ง, รูปแบบ config, ส่วนประกอบ GUI, การจัดเก็บ, ไอเทมแบบกำหนดเอง) eco จะช่วยลดงานที่ต้องทำซ้ำด้วยการมอบเฟรมเวิร์กที่ดูแลรักษาและการเชื่อมต่อที่ปลั๊กอินอื่นสามารถพึ่งพาได้