ปลั๊กอิน Minecraft WorldGuardExtraFlagsPlus

🔌 เกี่ยวกับ WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus เป็นส่วนขยายสำหรับปลั๊กอิน WorldGuard ที่เพิ่มธงของภูมิภาคและพฤติกรรมเพิ่มเติม โดยขยายระบบภูมิภาคของ WorldGuard ด้วยธงที่ยืนยันแล้วมากกว่า 40 รายการ เพื่อควบคุมการใช้ไอเทม การเทเลพอร์ต ขีดจำกัดการเข้า การคราฟต์ การชนของผู้เล่น การแลกเปลี่ยนกับชาวบ้าน และกฎเฉพาะของภูมิภาคอื่น ๆ

🎯 จุดประสงค์

ปลั๊กอินนี้ช่วยเติมช่องว่างของธงในตัวของ WorldGuard โดยให้การควบคุมแบบละเอียดเหนือการกระทำของผู้เล่นและนโยบายของภูมิภาค มีไว้สำหรับผู้ดูแลเซิร์ฟเวอร์ที่ต้องการปรับแต่งระดับภูมิภาคนอกเหนือจากแกนหลักของ WorldGuard เช่น การสร้างสนาม PvP ที่ป้องกันไว้ ล็อบบี้ พฤติกรรมของ hub หรือโซนการเล่นที่จำกัด

⚙️ ฟีเจอร์

• เพิ่มธงเพิ่มเติมกว่า 40 รายการ (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• ธงใหม่เฉพาะของ plus: disable-completely, disable-throw, entry-min-level, entry-max-level, player-count-limit, villager-trade, lightning-damage, disable-collision, inventory-craft, permit-workbenches, deny-item-drops, deny-item-pickup, allow-block-place, deny-block-place, allow-block-break, deny-block-break.
• ข้อความที่ปรับแต่งได้ซึ่งเก็บไว้ใน messages-wgefp.yml (มี cooldown ของข้อความเพื่อป้องกันสแปม)
• ฮุกการเชื่อมต่อแบบเลือกได้: รองรับ PlaceholderAPI สำหรับ placeholder แบบตัวเลข, ฮุก packet แบบเลือกได้ของ PacketEvents หรือ ProtocolLib เพื่อเพิ่มความครอบคลุมในการบล็อกไอเทมหรือการโจมตีบางประเภท
• การทำงานร่วมกับ EssentialsX: การปรับปรุงธง godmode และ fly จะปิด godmode/fly ของ EssentialsX เมื่อธงเหล่านั้นถูกปฏิเสธ
• รองรับ Folia และ handler ที่ปลอดภัยสำหรับ async เมื่อมีผล
• ตัวตรวจสอบการอัปเดตและธงทดลอง hide-players รวมถึงพฤติกรรมทดลอง chambered-enderpearl
• ธง console-command-repeat สำหรับรันคำสั่งคอนโซลซ้ำ ๆ ขณะที่ผู้เล่นยังอยู่ในภูมิภาค (ปิดไว้โดยค่าเริ่มต้น)

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

• เจ้าของและแอดมินเซิร์ฟเวอร์ที่ใช้ WorldGuard และต้องการควบคุมภูมิภาคได้แม่นยำยิ่งขึ้น
• เซิร์ฟเวอร์ Survival, SMP, hub/lobby และ PvP ที่ต้องการพฤติกรรมตามภูมิภาค
• เซิร์ฟเวอร์ที่ใช้ Paper หรือ Folia ซึ่งต้องการการรองรับแบบ async หรือแบบเฉพาะ fork

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

• จำกัดจำนวนผู้เล่นในภูมิภาคสนามด้วย player-count-limit
• บล็อกการใช้และการขว้างไอเทมบางชนิด (mace, trident, ender pearls) ในโซนกิจกรรมด้วย disable-completely และ disable-throw
• ป้องกันการคราฟต์ใน inventory (2x2) ในโซนปลอดภัยด้วย inventory-craft หรือบล็อกการใช้ workbench ด้วย permit-workbenches
• จำกัดการเข้าภูมิภาคตามระดับ XP ของผู้เล่นหรือค่าตัวเลขจาก PlaceholderAPI ด้วย entry-min-level / entry-max-level
• รันคำสั่งคอนโซลซ้ำ ๆ ขณะที่ผู้เล่นยังอยู่ในภูมิภาคด้วย console-command-repeat

⌨️ คำสั่ง

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

📥 การตั้งค่า

• ดาวน์โหลด JAR อย่างเป็นทางการและวางไว้ในไดเรกทอรี plugins/ ของเซิร์ฟเวอร์คุณพร้อมกับ WorldGuard
• หากอัปเกรดจาก WorldGuardExtraFlags รุ่นเก่า: ให้ลบ WorldGuardExtraFlags.jar เดิมก่อนเริ่มใช้งาน — ทั้งสองตัวไม่สามารถอยู่ร่วมกันได้
• รีสตาร์ตเซิร์ฟเวอร์และตรวจสอบคอนโซลของเซิร์ฟเวอร์เพื่อยืนยันว่าปลั๊กอินและธงของมันโหลดอย่างถูกต้อง

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

• จำเป็น: WorldGuard (โปรเจกต์นี้เป็นส่วนขยายของ WorldGuard)
• ทางเลือก / การเชื่อมต่อ: PlaceholderAPI (รองรับ placeholder แบบตัวเลข), PacketEvents หรือ ProtocolLib (การบล็อกแบบ packet ที่ดียิ่งขึ้น), EssentialsX (การเชื่อมต่อสำหรับพฤติกรรม godmode/fly)

🧾 การตั้งค่า

• ข้อความของปลั๊กอินถูกเก็บไว้ใน plugins/WorldGuard/messages-wgefp.yml และปรับแต่งได้ทั้งหมด โดยมีระบบ cooldown ของข้อความที่ตั้งค่าได้ผ่าน config ของปลั๊กอิน

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

• โปรเจกต์ประกาศ api-version: 1.21 และมุ่งเป้าไปที่อาร์ติแฟกต์ของ Paper API รุ่นใหม่; ได้มีการทำให้รองรับ Folia และยืนยันแล้ว
• bytecode ของ Java และการกำหนดเป้าหมาย API สอดคล้องกับสภาพแวดล้อมเซิร์ฟเวอร์ยุค 1.21 รุ่นใหม่
• ปลั๊กอินนี้แทนที่พฤติกรรมเก่า permit-completely ด้วย disable-completely เพื่อให้ความหมายของการบล็อกไอเทมกว้างขึ้น
• ฟีเจอร์บางอย่าง (เช่น การบล็อกกลไก spear lunge บางประเภทอย่างสมบูรณ์) จะทำงานเชื่อถือได้มากขึ้นเมื่อมี PacketEvents หรือ ProtocolLib
• ปลั๊กอินเปิดเผยธงจำนวนมากผ่านคำสั่งธงมาตรฐานของ WorldGuard (ตั้งค่าธงผ่านอินเทอร์เฟซธงของภูมิภาคใน WorldGuard)

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

หากคุณใช้งาน WorldGuard และต้องการธงของภูมิภาคเพิ่มเติมที่ยืนยันแล้วเพื่อควบคุมการใช้ไอเทม กฎการเข้าของผู้เล่น การคราฟต์ และพฤติกรรมอื่น ๆ แบบรายภูมิภาค — โดยเฉพาะบนเซิร์ฟเวอร์ Paper หรือ Folia — WorldGuard ExtraFlags Plus จะรวมความสามารถเหล่านั้นไว้ในระบบธงของ WorldGuard โดยไม่ต้องใช้ปลั๊กอินจัดการภูมิภาคแยกต่างหาก