ปลั๊กอิน Minecraft ItemJoin

🔌 เกี่ยวกับ ItemJoin

ItemJoin คือปลั๊กอิน Minecraft สำหรับมอบไอเทมแบบกำหนดเองที่ปรับแต่งได้สูงให้กับผู้เล่นโดยอัตโนมัติ ไอเทมสามารถมอบได้เมื่อเกิดอีเวนต์ เช่น join, first-join, respawn, world-switch, region-enter และ region-leave ปลั๊กอินนี้เน้นการกำหนดไอเทมที่ยืดหยุ่น (itemflags), อีเวนต์ทริกเกอร์ และคำสั่งที่ผูกกับไอเทม เพื่อให้เซิร์ฟเวอร์สามารถจัดเมนูล็อบบี้ ชุดเริ่มต้น หรือเครื่องมือที่ขึ้นกับบริบทได้โดยไม่ต้องใช้ม็อดฝั่งไคลเอนต์แบบกำหนดเอง

🎯 จุดประสงค์

ItemJoin แก้ปัญหาการมอบไอเทมแบบกำหนดเองหรือไอเทมโต้ตอบให้ผู้เล่นอย่างเชื่อถือได้ โดยผูกกับอีเวนต์ของเซิร์ฟเวอร์และโลกต่าง ๆ เหมาะสำหรับเซิร์ฟเวอร์ hub/lobby, เซิร์ฟเวอร์ minigame, เครือข่าย survival (ที่ต้องจำกัดไอเทมแยกตาม world) และเครือข่ายที่ต้องใช้เมนูที่ขับเคลื่อนด้วยไอเทมหรือไอเทมที่สั่งรันคำสั่งได้

⚙️ ฟีเจอร์

• มอบไอเทมตามทริกเกอร์ที่กำหนดค่าได้: join, first-join, respawn, world-switch, region-enter/exit และอีเวนต์ลักษณะเดียวกัน
• itemflags แยกต่อไอเทมที่เปลี่ยนพฤติกรรม (slot, overwrite, กฎ stack, การบล็อกการเคลื่อนย้าย/การเก็บ, ข้อจำกัด gamemode, โอกาสที่จะได้รับ, cooldowns)
• ItemCommands: แนบคำสั่งกับไอเทมและกำหนดบริบทการทำงาน (console, player, server, message) รวมถึงประเภทการกระทำ (คลิกซ้าย/ขวา, คลิกใน inventory, physical, multi-click)
• รองรับ PlaceholderAPI สำหรับชื่อ/lore ของไอเทมแบบไดนามิก และรองรับ placeholders
• รองรับหัวผู้เล่นแบบกำหนดเอง (textures และ owners แบบกำหนดเอง), รูปภาพบน map, tipped arrows, หนังสือ, banners, ดอกไม้ไฟ, การปรับแต่งเกราะหนัง และระดับ enchant แบบกำหนดเอง
• สามารถเลือกบล็อกการเคลื่อนย้ายไอเทมหรือการเก็บไอเทมใน world เฉพาะ และจำกัดไอเทมตามที่อยู่ IP หรือสถานะ first-join ได้
• ตัวสร้าง GUI ในเกมสำหรับสร้างชุดไอเทม และมีเวิร์กโฟลว์นำเข้า/สร้างในตัว
• API สำหรับปลั๊กอินอื่น: ใช้ได้ที่ me.RockinChaos.itemjoin.api.ItemJoinAPI

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

• เจ้าของเซิร์ฟเวอร์ที่ต้องการไอเทมล็อบบี้/hub อัตโนมัติหรือชุดเริ่มต้น
• ผู้ดูแล minigame และเครือข่ายที่ต้องการไอเทมเฉพาะ world หรือเข็มทิศเมนู
• นักพัฒนาที่ต้องการระบบไอเทมที่ hook ผ่าน API ได้

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

• มอบเข็มทิศเมนูให้ผู้เล่นตอน join ซึ่งจะรันคำสั่งต่างกันเมื่อคลิก
• ให้ชุดเริ่มต้นแบบครั้งเดียวตอน first-join พร้อมป้องกันการโอนย้ายไอเทมระหว่าง world ที่กำหนด
• สร้างไอเทมโต้ตอบที่รันคำสั่ง economy/shop พร้อม cooldowns และค่าใช้จ่าย

⌨️ คำสั่ง

หมายเหตุ: คำสั่งและคำสั่งย่อยเหล่านี้มาจากชุดคำสั่งที่มีเอกสารของปลั๊กอิน ปลั๊กอินยังมีคำสั่งย่อยเพิ่มเติมใน wiki และในผลลัพธ์ help ที่สร้างขึ้นด้วย

🔐 สิทธิ์

พฤติกรรมของสิทธิ์แบบเฉพาะไอเทมสามารถกำหนดค่าได้; การตรวจสอบสิทธิ์ของไอเทมถูกปิดไว้โดยค่าเริ่มต้น และต้องเปิดในคอนฟิกของปลั๊กอินจึงจะมีผล

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

📥 การตั้งค่า

• ดาวน์โหลดไฟล์ jar อย่างเป็นทางการของ ItemJoin และวางไว้ในโฟลเดอร์ plugins/ ของเซิร์ฟเวอร์
• ตรวจสอบให้แน่ใจว่าไม่มีไฟล์ jar ของ ItemJoin ซ้ำใน plugins/ (เช่น ItemJoin(1).jar)
• รีสตาร์ทเซิร์ฟเวอร์เพื่อให้ปลั๊กอินสร้างคอนฟิกและลงทะเบียนฟีเจอร์สำหรับเวอร์ชันเซิร์ฟเวอร์ของคุณ
• ตรวจสอบ log ของคอนโซลเพื่อยืนยันการโหลดปลั๊กอิน และอ่าน wiki ของปลั๊กอินสำหรับการตั้งค่าแบบละเอียด

📦 Dependencies

ปลั๊กอินไม่มีข้อกำหนด runtime แบบบังคับ แต่มีการระบุ soft-dependencies และการผสานรวมที่พบบ่อยหลายอย่าง (เป็นตัวเลือกและจะเปิดใช้งานเมื่อมีอยู่):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

เปิดใช้งานหรือกำหนดค่าการผสานรวมตามต้องการ; ปลั๊กอินสามารถทำงานได้โดยไม่ต้องมีสิ่งเหล่านี้ แต่ฟีเจอร์อย่าง placeholders, หัว/สกินแบบกำหนดเอง และ economy hooks จะต้องอาศัยปลั๊กอินที่เกี่ยวข้อง

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

• แพลตฟอร์ม: ยืนยันสำหรับเซิร์ฟเวอร์สไตล์ Spigot (Spigot, Bukkit, Paper, Purpur, Folia)
• ช่วง Minecraft ที่รองรับ/ทดสอบ: 1.8 ถึง 1.21
• ซอร์สโค้ดและ release ถูกเผยแพร่แล้ว และโปรเจกต์มี API ที่ me.RockinChaos.itemjoin.api.ItemJoinAPI ให้ปลั๊กอินอื่น hook ได้
• ใบอนุญาต: LGPL-3.0

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

หากคุณต้องการระบบที่ยืดหยุ่นและกำหนดค่าได้เพื่อมอบไอเทมที่รับรู้บริบทและโต้ตอบได้ให้ผู้เล่น (เมนู ชุดเริ่มต้น เครื่องมือเฉพาะ world) และต้องการ API สำหรับการผสานรวม ItemJoin ก็มีฟีเจอร์เหล่านี้พร้อมรองรับปลั๊กอิน placeholder และ skin ที่ใช้กันทั่วไป