Minecraft Servers HQ

ปลั๊กอิน Minecraft EconomyAPI

ข้อมูลเกี่ยวกับ EconomyAPI และเซิร์ฟเวอร์ที่พบ

SurvivalEconomyUtilityDeveloper APIServer Tools

🔌 เกี่ยวกับ EconomyAPI

EconomyAPI คือปลั๊กอินแกนหลักด้านเศรษฐกิจและการทำ API implementation ที่เดิมทีสร้างโดย onebone โดยเผยแพร่และแจกจ่ายสำหรับระบบนิเวศเซิร์ฟเวอร์สไตล์ Bedrock/PocketMine (PocketMine/Nukkit variants) และมีเป้าหมายเพื่อมอบแบ็กเอนด์สกุลเงินร่วมและเมธอดแบบโปรแกรมที่ปลั๊กอินอื่นเรียกใช้ได้

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

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

⚙️ ฟีเจอร์

  • เปิดเมธอด API แบบโปรแกรมสำหรับการตรวจสอบและอัปเดตยอดเงิน (ตัวอย่างในเอกสารมี accessor สไตล์ getInstance)
  • มีคำสั่งเศรษฐกิจสำหรับผู้เล่น เช่น balance, pay และการปรับเงินโดยแอดมิน
  • ส่งอีเวนต์และ hooks ที่ปลั๊กอินอื่นสามารถรับฟังเพื่อจัดการธุรกรรมได้
  • ถูกใช้อย่างแพร่หลายเป็น dependency/คอมโพเนนต์แกนหลักสำหรับ addon และส่วนขยายเศรษฐกิจของ PocketMine/Nukkit อื่น ๆ

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

  • นักพัฒนาเซิร์ฟเวอร์และปลั๊กอินที่ต้องการแบ็กเอนด์เศรษฐกิจร่วมบนซอฟต์แวร์เซิร์ฟเวอร์ Bedrock สไตล์ PocketMine/Nukkit
  • ผู้ดูแลเซิร์ฟเวอร์ Bedrock ขนาดเล็กถึงกลางที่พึ่งพาระบบปลั๊กอินซึ่งเชื่อมต่อกับ EconomyAPI

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

  • ปลั๊กอินร้านค้า หรือ marketplace อ่านและหักยอดเงินผู้เล่นผ่านการเรียก EconomyAPI
  • ปลั๊กอินประมูลหรือรางวัลมอบเงินโดยเรียกเมธอด add/reduce ของ API
  • เครือข่ายเซิร์ฟเวอร์ที่แจกปลั๊กอิน addon ซึ่งคาดหวังผู้ให้บริการเศรษฐกิจแบบกลางร่วมกัน

⌨️ คำสั่ง

CommandDescriptionPermissionAccess
/mymoneyแสดงยอดเงินปัจจุบันของคุณeconomyapi.command.mymoneyผู้เล่น
/seemoneyดูยอดเงินของผู้เล่นคนอื่นeconomyapi.command.seemoneyแอดมิน
/payจ่ายเงินให้ผู้เล่นคนอื่นไม่ได้ระบุผู้เล่น
/givemoneyให้เงินแก่ผู้เล่นeconomyapi.command.givemoneyแอดมิน
/takemoneyถอนเงินจากผู้เล่นeconomyapi.command.takemoneyแอดมิน
/setmoneyตั้งยอดเงินของผู้เล่นeconomyapi.command.setmoneyแอดมิน
/topmoneyแสดงตารางอันดับยอดเงินสูงสุดeconomyapi.command.topmoneyผู้เล่น

(คำสั่งและ permission nodes ด้านบนมาจากรายการ resource ของ PocketMine/Nukkit ที่เผยแพร่แล้ว; การใช้งานจริงอาจแตกต่างกันไปตาม build/fork)

🔐 สิทธิ์

PermissionDescriptionDefault
economyapipermission node พื้นฐานสำหรับฟีเจอร์ของ EconomyAPIไม่ได้ระบุ
economyapi.commandnode พื้นฐานสำหรับคำสั่งเศรษฐกิจไม่ได้ระบุ
economyapi.command.mymoneyอนุญาตให้ใช้ /mymoneyไม่ได้ระบุ
economyapi.command.seemoneyอนุญาตให้ดูยอดเงินของผู้เล่นคนอื่นไม่ได้ระบุ
economyapi.command.givemoneyอนุญาตให้ให้เงิน (ในหลายแพ็กเกจอยู่ระดับ operator)op
economyapi.command.takemoneyอนุญาตให้ถอนเงิน (ในหลายแพ็กเกจอยู่ระดับ operator)op
economyapi.command.setmoneyอนุญาตให้ตั้งยอดเงินของผู้เล่น (ในหลายแพ็กเกจอยู่ระดับ operator)op
economyapi.command.topmoneyอนุญาตให้ดูตารางอันดับยอดเงินไม่ได้ระบุ

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

📥 การตั้งค่า

  • ดาวน์โหลด build ปลั๊กอินอย่างเป็นทางการสำหรับ distribution ของเซิร์ฟเวอร์คุณ (PocketMine/Poggit หรือ build ชุมชนของ Nukkit)
  • วางไฟล์ปลั๊กอินที่ดาวน์โหลดไว้ในไดเรกทอรี plugins/ ของเซิร์ฟเวอร์
  • หยุดแล้วเริ่มเซิร์ฟเวอร์ใหม่ (restart) และตรวจสอบ output ของคอนโซลเพื่อยืนยันว่าปลั๊กอินถูกโหลดแล้ว

(รูปแบบแพ็กเกจที่แน่นอนอาจแตกต่างกันไปตาม distribution และ build; โปรดทำตามขั้นตอนการติดตั้งของ distribution ที่เลือก)

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

  • EconomyAPI ถูกแจกจ่ายในหลาย build/fork สำหรับระบบนิเวศ PocketMine และ Nukkit; build ต่างกันอาจมีคำสั่งหรือจุดเริ่มต้น API แตกต่างกันเล็กน้อย
  • ปลั๊กอินเปิดรูปแบบการเข้าถึงแบบโปรแกรมที่ addon อื่นใช้ (ตัวอย่างในเอกสารชุมชนแสดงการเรียกเช่น EconomyAPI::getInstance() หรือ EconomyAPI.getInstance().addMoney(...))
  • บางช่วงปลั๊กอินนี้เคยถูกระบุในช่องทางแจกจ่ายว่าอาจมีปัญหาเรื่องประสิทธิภาพหรือการดูแลรักษา; ควรพิจารณาสถานะการดูแลล่าสุดและทางเลือกที่เข้ากันได้เมื่อใช้งานบนเซิร์ฟเวอร์ production

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

หากเซิร์ฟเวอร์หรือระบบนิเวศ add-on ของคุณต้องการผู้ให้บริการเศรษฐกิจร่วมสำหรับเซิร์ฟเวอร์สไตล์ Bedrock/PocketMine/Nukkit, EconomyAPI จะมอบ API ที่ใช้อย่างแพร่หลายและชุดคำสั่งพื้นฐานสำหรับผู้เล่นที่ปลั๊กอินอื่น ๆ จำนวนมากเชื่อมต่อใช้งาน

เซิร์ฟเวอร์ที่มีปลั๊กอิน EconomyAPI

หน้าปลั๊กอิน EconomyAPI แสดงว่าเครื่องมอนิเตอร์พบปลั๊กอินนี้บนเซิร์ฟเวอร์ใด พร้อมแพลตฟอร์มและเวอร์ชันที่เกี่ยวข้อง

ปลั๊กอินอาจเพิ่มคำสั่ง เศรษฐกิจ การป้องกัน สิทธิ์ มินิเกม การเชื่อมต่อ หรือกลไกอื่น ๆ บทบาทจริงของ EconomyAPI ขึ้นอยู่กับการตั้งค่าของแต่ละเซิร์ฟเวอร์

ข้อมูลสร้างอัตโนมัติจากการตอบกลับทางเทคนิคของเซิร์ฟเวอร์ หากเซิร์ฟเวอร์ซ่อนรายชื่อปลั๊กอิน อาจไม่แสดงในส่วนนี้แม้ว่าจะใช้ EconomyAPI

ใช้รายชื่อเซิร์ฟเวอร์ที่มี EconomyAPI เพื่อเปรียบเทียบโปรเจกต์ ตรวจสอบเวอร์ชันที่เข้ากันได้ หรือหาตัวอย่างการใช้งานปลั๊กอินบนเซิร์ฟเวอร์สาธารณะ