ปลั๊กอิน Minecraft SuperVanish

🔌 เกี่ยวกับ SuperVanish

SuperVanish คือปลั๊กอิน Minecraft สำหรับเซิร์ฟเวอร์ Bukkit/Spigot ที่ทำให้ผู้ดูแลเซิร์ฟเวอร์และทีมงานสามารถหายตัวจากผู้เล่นคนอื่นได้อย่างสมบูรณ์ เป้าหมายคือมอบสถานะ vanish ที่ตรวจจับไม่ได้ เหมาะสำหรับการดูแลและทดสอบ พร้อมทั้งมี API ให้ปลั๊กอินอื่นสามารถโต้ตอบกับสถานะ vanish ได้

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

จุดประสงค์หลักของปลั๊กอินนี้คือการดูแลและติดตามเชิงผู้ดูแลระบบ: ให้ทีมงานที่เชื่อถือได้สามารถสังเกตพฤติกรรมผู้เล่นได้โดยไม่ปรากฏใน playerlist, ข้อความเข้า/ออก หรือการปรากฏตัวในโลกสำหรับผู้เล่นส่วนใหญ่ เหมาะสำหรับเจ้าของเซิร์ฟเวอร์ ผู้ดูแลระบบ และนักพัฒนาปลั๊กอินที่ต้องการการทำ vanish ที่เชื่อถือได้

⚙️ คุณสมบัติ

• ซ่อนผู้เล่นที่ vanish จากผู้เล่นคนอื่นทั้งหมดอย่างสมบูรณ์ (การมองเห็นในโลก)
• ซ่อนผู้เล่นที่ vanish ในรายการผู้เล่น (tab) พร้อมลักษณะที่กำหนดได้สำหรับผู้สังเกต
• ปรับจำนวนผู้เล่นออนไลน์/server list ที่รายงานเมื่อมี ProtocolLib
• ระบบสิทธิ์แบบหลายชั้นเพื่อกำหนดได้อย่างแม่นยำว่าใครสามารถเห็นใคร
• คงสถานะ vanish ไว้ระหว่างการเข้าเซิร์ฟเวอร์ การรีสตาร์ต และการรีโหลด
• จุดเชื่อมต่อแบบเลือกใช้ได้ที่ต้องมี ProtocolLib สำหรับฟีเจอร์ขั้นสูงที่อาศัย packet
• คำแนะนำแบบเลือกใช้ให้ติดตั้ง OpenInv เพื่อปรับปรุงพฤติกรรม "silent chest"
• VanishAPI แบบสาธารณะสำหรับปลั๊กอินอื่น: เมธอดสำหรับซ่อน/แสดงผู้เล่น, ตรวจสอบผู้เล่นที่มองไม่เห็น, และรับฟัง PlayerHideEvent/PlayerShowEvent

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

• เซิร์ฟเวอร์ Survival และ SMP ที่ต้องการเครื่องมือดูแลแบบล่องหน
• เซิร์ฟเวอร์ที่ต้องการ API vanish สำหรับปลั๊กอินดูแลหรือยูทิลิตีอื่นๆ
• ผู้ดูแลระบบที่ต้องการกฎการมองเห็นที่กำหนดค่าได้และควบคุม tablist

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

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

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

📥 การตั้งค่า

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

📦 สิ่งที่ต้องมี

• ProtocolLib (ตัวเลือก): จำเป็นสำหรับฟีเจอร์ที่อาศัย packet เช่น การปรับจำนวนผู้เล่นและฟีเจอร์ action-bar บางอย่าง
• OpenInv (คำแนะนำแบบเลือกใช้): ช่วยให้พฤติกรรม silent chest ดีขึ้นเมื่อโต้ตอบกับ inventory ในขณะที่ vanish

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

• แพลตฟอร์ม: ทำงานเป็นปลั๊กอิน Bukkit/Spigot และมี Java API สำหรับปลั๊กอินอื่น
• API: มี VanishAPI พร้อมเมธอดสำหรับซ่อน/แสดงผู้เล่น, ตรวจสอบสถานะ vanish, และดึงรายการผู้เล่นที่มองไม่เห็น; รวมถึง PlayerHideEvent และ PlayerShowEvent สำหรับการเชื่อมต่อแบบ event-driven
• การคงอยู่: สามารถส่งคืนรายการผู้เล่นที่มองไม่เห็นทั้งหมด (ทั้งออนไลน์และออฟไลน์) ผ่าน API; การดึงผู้เล่นที่มองไม่เห็นทั้งหมดอาจเกี่ยวข้องกับการเข้าถึงฐานข้อมูล และควรใช้อย่างระมัดระวังนอก main thread
• ใบอนุญาต: เผยแพร่ภายใต้สัญญาอนุญาต MIT และซอร์สโค้ดมีอยู่ใน repository ของโปรเจกต์

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

หากคุณต้องการการทำ vanish ที่ผสานกับปลั๊กอินอื่นได้และรองรับกฎการมองเห็นแบบละเอียดสำหรับการดูแล SuperVanish จะมอบ vanish ที่กำหนดค่าได้และขับเคลื่อนด้วย API พร้อมการเชื่อมต่อ ProtocolLib/OpenInv แบบเลือกใช้เพื่อให้การทำงานดีขึ้น