ปลั๊กอิน Minecraft zAuctionHouse

🔌 เกี่ยวกับ zAuctionHouse

zAuctionHouse เป็นปลั๊กอิน Minecraft ที่นำเสนอ auction house แบบครบฟีเจอร์ให้ผู้เล่นสามารถลงขาย เรียกดู และซื้อไอเท็มได้ จุดเด่นคือการปรับแต่งได้สูง อินเทอร์เฟซแบบ GUI และรองรับระบบเศรษฐกิจหลายประเภท โปรเจกต์นี้ดูแลโดย GroupeZ-dev และใน repository กับเอกสารแสดงให้เห็นการเขียนใหม่ V4 ที่มุ่งเป้าไปยัง Java สมัยใหม่และสถาปัตยกรรมเซิร์ฟเวอร์รุ่นใหม่

🎯 จุดประสงค์

zAuctionHouse แก้ปัญหาการซื้อขายไอเท็มในเกมด้วยการมอบตลาดกลางที่ผู้เล่นสามารถสร้าง listing แบบซื้อทันที ทำการขายจำนวนมาก และเรียกดูคลังสินค้าแยกตามหมวดหมู่ได้ เหมาะสำหรับเซิร์ฟเวอร์ที่ต้องการ marketplace แบบรวมศูนย์พร้อมการตรวจสอบสำหรับแอดมินและการซิงก์ข้ามเครือข่ายแบบเลือกได้

⚙️ ฟีเจอร์

• Listing แบบซื้อทันที (buy-it-now) และเวิร์กโฟลว์แบบประมูลในกรณีที่รองรับ
• การขายแบบจำนวนมาก: ขายไอเท็มหลายชิ้นใน listing เดียว
• พรีวิว shulker box เพื่อให้ผู้ซื้อดูของข้างในก่อนตัดสินใจซื้อ
• การกรองตามหมวดหมู่ การจัดเรียงขั้นสูง และการแบ่งหน้า สำหรับ listing จำนวนมาก
• รองรับหลายระบบเศรษฐกิจ (Vault, PlayerPoints, CoinsEngine, สกุลเงินแบบไอเท็ม, XP/เลเวล)
• ระบบภาษีที่ปรับแต่งได้ และส่วนลดภาษีตาม permission
• การจ่ายเงินแบบรับอัตโนมัติหรือรับด้วยตนเอง และการแจ้งเตือนการขายแบบออฟไลน์
• ผสานรวมกับ zMenu เพื่อ GUI และเทมเพลตคลังสินค้าที่ปรับแต่งได้ทั้งหมด
• รองรับ PlaceholderAPI และ MiniMessage สำหรับข้อความที่มีรูปแบบและ placeholder
• เครื่องมือสำหรับแอดมิน: แผงแอดมิน, บันทึกการกระทำ, ประวัติธุรกรรม, การกู้คืนไอเท็ม และคำสั่งจัดการแคช
• ซิงก์หลายเซิร์ฟเวอร์ผ่าน Redis addon พร้อม distributed locking และ pub/sub
• ควบคุมไอเท็มแบบ blacklist/whitelist, ข้อจำกัดของโลก, ขีดจำกัด listing และราคา, และ transaction locking เพื่อป้องกัน race condition
• รองรับ Discord webhook สำหรับการแจ้งเตือนการขายพร้อม embed ที่ปรับแต่งได้

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

• เซิร์ฟเวอร์ Survival และ SMP ที่ต้องการ marketplace ที่ขับเคลื่อนโดยผู้เล่น
• เซิร์ฟเวอร์ Skyblock, Factions และเซิร์ฟเวอร์ที่เน้นเศรษฐกิจซึ่งต้องการระบบซื้อขาย
• เครือข่ายที่ต้องการ marketplace ที่ซิงก์กันระหว่างหลาย backend server
• ผู้ดูแลเซิร์ฟเวอร์ที่ต้องการ log สำหรับการตรวจสอบและเครื่องมือกู้คืนสำหรับแอดมิน

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

• ผู้เล่นลงขายของดรอปหายากหรือไอเท็มที่คราฟต์แล้วในราคาคงที่ เพื่อให้ผู้เล่นอื่นซื้อได้ทันที
• ผู้ดูแลเซิร์ฟเวอร์บังคับใช้กฎภาษีและส่วนลดภาษี VIP ผ่าน permission
• เครือข่ายหลายเซิร์ฟเวอร์ซิงก์ listing และการขายระหว่างเซิร์ฟเวอร์ hub และ backend โดยใช้ Redis addon

⌨️ คำสั่ง

(คำสั่งด้านบนอ้างอิงจากเอกสารทางการของโปรเจกต์และคู่มือ quick-start ใน repository)

🔐 สิทธิ์

(ระบุเฉพาะ node ของ permission ที่อ้างถึงอย่างชัดเจนในการตั้งค่าและเอกสารทางการเท่านั้น)

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

📥 การตั้งค่า

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

📦 ส่วนที่ต้องใช้ร่วมกัน

• ต้องมี: zMenu, PlaceholderAPI
• การเชื่อมต่อแบบเลือกใช้ / รองรับ: Vault, LuckPerms และ zAuctionHouse Redis addon สำหรับซิงก์หลายเซิร์ฟเวอร์

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

• โปรเจกต์นี้มุ่งเป้าไปที่ Java สมัยใหม่ (การเขียนใหม่ V4 มุ่งเป้าไปที่ Java 21) และใช้รูปแบบ repository / ORM ในสถาปัตยกรรม
• ซอฟต์แวร์เซิร์ฟเวอร์ที่แนะนำรวมถึง Paper และ fork ของ Paper; Folia และ fork ที่อิง Paper หลายตัวก็ถูกระบุว่ารองรับ
• เอกสารทางการและการเผยแพร่แสดงการรองรับ Minecraft 1.20 ไปจนถึง 1.21+ (โปรดตรวจสอบเอกสารโปรเจกต์เพื่อความเข้ากันได้ของ build ที่แน่นอนก่อนนำไปใช้จริง)

❓ คำถามที่พบบ่อย

• มีเวอร์ชันฟรีไหม?
  มี build เดโมฟรีให้ใช้งาน (โปรเจกต์มี release แบบฟรี/เดโมบนบางแพลตฟอร์ม) ขณะที่ release แบบเต็มที่รองรับจะเผยแพร่ผ่านช่องทางพรีเมียมของโปรเจกต์

🤝 ปลั๊กอินนี้เหมาะใช้เมื่อไร

ถ้าคุณต้องการ marketplace ที่ปรับแต่งได้ ใช้งานผ่าน GUI มีรองรับหลายระบบเศรษฐกิจ และซิงก์หลายเซิร์ฟเวอร์แบบเลือกได้ zAuctionHouse มอบการทำงานของ auction house ที่ดูแลต่อเนื่อง พร้อมการตรวจสอบสำหรับแอดมินและการปรับแต่ง GUI ผ่าน zMenu