ปลั๊กอิน Minecraft Shopkeepers

🔌 เกี่ยวกับ Shopkeepers

Shopkeepers คือปลั๊กอิน Minecraft สำหรับ Bukkit/Spigot ที่ช่วยให้เจ้าของเซิร์ฟเวอร์สามารถวาง villager shopkeeper แบบปรับแต่งได้ ซึ่งขายไอเทมที่กำหนดไว้ในราคาที่กำหนดไว้ ปลั๊กอินนี้รองรับทั้ง admin shops (สต็อกไม่จำกัด) และ player shops ที่ดึงสต็อกจากคอนเทนเนอร์ และยังมี ShopkeepersAPI สำหรับการเชื่อมต่อกับ addon และส่วนขยายต่าง ๆ

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

ปลั๊กอินนี้มอบระบบร้านค้าแบบ NPC ภายในเกม เพื่อให้เซิร์ฟเวอร์มีร้านค้าแบบถาวรได้โดยไม่ต้องจัดการ chest ด้วยตนเองหรือใช้ร้านค้าที่ซับซ้อนด้วยคำสั่ง เหมาะสำหรับเศรษฐกิจของเซิร์ฟเวอร์ ร้านค้า roleplay และเซิร์ฟเวอร์ survival/SMP ที่ต้องการพ่อค้า NPC. ()

⚙️ คุณสมบัติ

• สร้าง villager shopkeeper แบบกำหนดเองพร้อม trade และราคาที่ระบุไว้
• admin shops ที่มีสินค้าสำรองไม่จำกัด
• player shops ที่ดึงไอเทมจากคอนเทนเนอร์ (chest) ที่เชื่อมต่ออยู่เพื่อใช้เป็นสต็อก
• ShopkeepersAPI สำหรับผู้พัฒนาปลั๊กอินในการ query และจัดการ shopkeeper แบบโปรแกรมได้
• ปรับแต่งไอเทม/item-data ภายในเกมและรองรับไฟล์ภาษา ผ่าน wiki ของโปรเจกต์และไฟล์ภาษา ()

🧩 เหมาะสำหรับใคร

• เซิร์ฟเวอร์ Survival และ SMP ที่ต้องการร้านค้าที่ NPC ดูแล
• เซิร์ฟเวอร์ roleplay หรือเศรษฐกิจที่ใช้ NPC villager เป็นพ่อค้า
• ผู้พัฒนาปลั๊กอินที่ต้องการ API เพื่อผสานพฤติกรรมร้านค้าเข้ากับระบบอื่น ๆ ()

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

• แอดมินสร้าง admin shop แบบไม่จำกัดเพื่อขายสินค้าที่เซิร์ฟเวอร์จัดให้
• ผู้เล่นเปิดร้านที่ขายไอเทมจาก chest ที่เชื่อมต่อโดยอัตโนมัติ
• นักพัฒนาสร้าง addon ที่แสดงรายการหรือแก้ไข shopkeeper โดยใช้ ShopkeepersAPI. ()

⌨️ คำสั่ง

(หมายเหตุ: ด้านบนแสดงเฉพาะคำสั่งที่มีการระบุไว้ในแหล่งข้อมูลทางการเท่านั้น) ()

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

📥 การตั้งค่า

• ดาวน์โหลดไฟล์ jar ของปลั๊กอินอย่างเป็นทางการแล้ววางลงในโฟลเดอร์ plugins/ ของเซิร์ฟเวอร์
• รีสตาร์ทเซิร์ฟเวอร์และตรวจสอบคอนโซลของเซิร์ฟเวอร์เพื่อยืนยันว่าปลั๊กอินถูกโหลดแล้ว

(นี่คือขั้นตอนการติดตั้งมาตรฐานสำหรับปลั๊กอิน Bukkit/Spigot และได้รับการสนับสนุนโดยเอกสารของโปรเจกต์) ()

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

• Shopkeepers เผยแพร่ภายใต้สัญญาอนุญาต GPL-3.0 และ repository ของโปรเจกต์มีโมดูล API (ShopkeepersAPI) และคำแนะนำการ build ()
• โปรเจกต์มี Maven artifacts และ API ที่เผยแพร่สำหรับนักพัฒนา addon; README อธิบายการใช้งาน repository และ coordinates ของ dependency สำหรับ API ()
• การแจกจ่ายอย่างเป็นทางการและการสนับสนุนจากชุมชนมีให้ผ่านหน้า resource ของ Spigot และเซิร์ฟเวอร์ Discord ของปลั๊กอิน ()

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

หากคุณต้องการ NPC merchants ที่ถาวรและปรับแต่งได้ พร้อมรองรับทั้ง admin shops และร้านค้าที่ผู้เล่นดูแล และต้องการ API เพื่อผสานร้านค้าเข้ากับปลั๊กอินอื่น ๆ Shopkeepers มีการใช้งานที่พิสูจน์แล้วสำหรับเซิร์ฟเวอร์ Bukkit/Spigot. ()