ปลั๊กอิน Minecraft QuickShop-Hikari

🔌 เกี่ยวกับ QuickShop-Hikari

QuickShop-Hikari คือปลั๊กอิน Minecraft ที่ทำระบบร้านซื้อ/ขายแบบใช้หีบ (ChestShops) ผู้เล่นสร้างและใช้งานร้านโดยการโต้ตอบกับหีบ; รูปแบบการเล่นส่วนใหญ่ไม่ต้องใช้คำสั่งใด ๆ เลย โปรเจกต์นี้ดูแลโดย QuickShop-Community และมุ่งเน้นความเข้ากันได้สมัยใหม่, ความปลอดภัยของข้อมูล, และการเชื่อมต่อเพิ่มเติมที่ขยายได้

🎯 จุดประสงค์

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

⚙️ ฟีเจอร์

• สร้างร้านซื้อและร้านขายโดยใช้หีบและป้าย (ร้านแบบใช้หีบ)
• รองรับข้อมูล NBT, enchantments, ความเสียหายของไอเท็ม, ข้อมูล potion, และไข่ม็อบ
• สลับเปิด/ปิดไอเท็มแสดงผลเสมือนเหนือร้านได้ (รองรับ ProtocolLib หรือ PacketEvents)
• รองรับหีบแบบไม่จำกัดและพฤติกรรมซื้อ/ขายแบบผสมใน double chest
• รองรับ blacklist พร้อมตัวเลือก permission สำหรับ bypass
• จัดการ permission แยกตามร้าน และสิทธิประโยชน์ของร้านระหว่างเจ้าของกับผู้เล่นคนอื่น
• รองรับ i18n สำหรับชื่อไอเท็มและ enchantment รวมถึงไวยากรณ์ MiniMessage สำหรับข้อความ
• รองรับ datasource แบบ H2 (ภายในเครื่อง) และ MySQL (ระยะไกล)
• มี integration hooks สำหรับปลั๊กอินป้องกันและยูทิลิตีที่ใช้กันทั่วไป (มีโมดูลความเข้ากันได้ให้)
• มี Developer API (ระบุ Maven/Gradle coordinates) สำหรับสอบถามข้อมูลร้านและเชื่อมต่อฟีเจอร์
• มี telemetry ของ bStats พร้อมตัวเลือก opt-out ผ่านการตั้งค่า

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

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

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

• ผู้เล่นใส่ไอเท็มลงในหีบและติดป้ายเพื่อขายเป็นกองให้ผู้เล่นคนอื่นโดยอัตโนมัติ
• แอดมินเปิดใช้ permission แยกตามร้าน เพื่อให้ผู้ดูแลสามารถจัดการร้านในโลกหรือภูมิภาคที่กำหนดได้
• เครือข่ายเซิร์ฟเวอร์ใช้การเก็บข้อมูลแบบ MySQL เพื่อให้ร้านคงอยู่ข้ามหลาย instance ของเซิร์ฟเวอร์

⌨️ คำสั่ง

หมายเหตุ: เอกสารของโปรเจกต์ระบุว่าการเล่นปกติของผู้เล่นไม่จำเป็นต้องใช้คำสั่ง; คำสั่งมีไว้สำหรับงานด้านผู้ดูแลเป็นหลัก

🔐 Permissions

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

📥 การตั้งค่า

• ดาวน์โหลดไฟล์ jar ของ QuickShop-Hikari อย่างเป็นทางการจากช่องทางจัดจำหน่ายของโปรเจกต์ (Modrinth/Spigot/GitHub releases)
• วางไฟล์ jar ลงในโฟลเดอร์ plugins/ ของเซิร์ฟเวอร์
• เริ่มเซิร์ฟเวอร์และตรวจสอบว่าปลั๊กอินถูกโหลดแล้ว (เอกสารแสดงการรันคำสั่ง qs ในคอนโซลเพื่อแสดง help/test output)

📦 Dependencies

การเชื่อมต่อที่ยืนยันแล้วว่าเป็นแบบจำเป็น/เสริมตามที่โปรเจกต์ระบุ:

• Vault (จำเป็นสำหรับการเชื่อมระบบเศรษฐกิจ)
• ปลั๊กอินเศรษฐกิจที่เข้ากันได้กับ Vault (มีตัวอย่างที่โปรเจกต์ให้ไว้)
• ProtocolLib หรือ PacketEvents (จำเป็นสำหรับไอเท็มแสดงผลเสมือน / การแปลเฉพาะผู้เล่น)
• LuckPerms (แนะนำสำหรับการจัดการ permission)

🧾 การตั้งค่า

• ปลั๊กอินจะสร้างและใช้ config.yml (เอกสารอ้างถึงคีย์ใน config.yml สำหรับโปรโตคอลการแสดงผลและการตั้งค่าความเป็นส่วนตัว)
• การเก็บข้อมูลรองรับ H2 แบบโลคัลหรือ MySQL ระยะไกล; มีตัวเลือกการตั้งค่าอยู่ในไฟล์คอนฟิกของปลั๊กอิน

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

• เอกสารทางการแนะนำให้รันบนเซิร์ฟเวอร์ที่ใช้ Paper และระบุว่าต้องใช้ Java 21
• โปรเจกต์มี Developer API และ Maven/Gradle coordinates สำหรับการใช้งานตอนคอมไพล์
• QuickShop-Hikari มีโมดูลความเข้ากันได้สำหรับปลั๊กอินภายนอก (เช่น WorldGuard, WorldEdit, OpenInv) ให้ดาวน์โหลดเป็นตัวเลือกเสริม
• Telemetry: ใช้ bStats; สามารถ opt-out ได้ผ่านการตั้งค่า config

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

หากคุณต้องการ marketplace ที่ขับเคลื่อนด้วยหีบ มองเห็นและใช้งานได้โดยผู้เล่น มีการเก็บข้อมูลแบบถาวร และควบคุมแยกตามร้าน (แทนร้านแบบ GUI หรือแบบใช้คำสั่งเท่านั้น) QuickShop-Hikari จะมอบการทำงานสมัยใหม่ที่ใช้ฐานข้อมูล พร้อม hook สำหรับปลั๊กอินเศรษฐกิจและการป้องกันที่ใช้กันทั่วไป