Plugin Minecraft WorldGuardExtraFlagsPlus

🔌 Giới thiệu về WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus là một tiện ích mở rộng cho plugin WorldGuard, cung cấp thêm các cờ vùng và hành vi bổ sung. Nó mở rộng hệ thống vùng của WorldGuard với hơn 40 cờ đã được xác nhận để kiểm soát việc sử dụng vật phẩm, dịch chuyển, giới hạn vào vùng, chế tạo, va chạm người chơi, giao dịch với dân làng và các quy tắc riêng theo vùng khác.

🎯 Mục đích

Plugin này lấp đầy những khoảng trống trong các cờ có sẵn của WorldGuard bằng cách cung cấp khả năng kiểm soát chi tiết các hành động của người chơi và chính sách theo vùng. Nó dành cho các quản trị viên máy chủ cần tùy chỉnh ở cấp vùng vượt ra ngoài lõi WorldGuard, chẳng hạn để xây dựng đấu trường PvP được bảo vệ, lobby, hành vi hub hoặc các khu vực chơi bị hạn chế.

⚙️ Tính năng

• Thêm hơn 40 cờ bổ sung (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Các cờ mới dành riêng cho 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.
• Thông báo tùy chỉnh được lưu trong messages-wgefp.yml (có thời gian chờ giữa các thông báo để tránh spam).
• Các hook tích hợp tùy chọn: hỗ trợ PlaceholderAPI cho placeholder dạng số, hook packet tùy chọn của PacketEvents hoặc ProtocolLib để cải thiện khả năng chặn một số vật phẩm/cuộc tấn công.
• Tích hợp EssentialsX: các cải tiến cho cờ godmode và fly sẽ vô hiệu hóa godmode/fly của EssentialsX khi các cờ đó bị từ chối.
• Hỗ trợ Folia và các handler an toàn với async khi áp dụng.
• Trình kiểm tra cập nhật và cờ thử nghiệm hide-players cùng hành vi thử nghiệm chambered-enderpearl.
• Cờ console-command-repeat để chạy lệnh console lặp lại trong khi người chơi còn ở trong vùng (mặc định tắt).

🧩 Dành cho ai

• Chủ và quản trị viên máy chủ đang chạy WorldGuard và cần kiểm soát vùng chính xác hơn.
• Các máy chủ Survival, SMP, hub/lobby và PvP cần hành vi dựa trên vùng.
• Các máy chủ dùng Paper hoặc Folia, nơi cần hỗ trợ async hoặc hỗ trợ riêng theo fork.

🏗️ Ví dụ sử dụng

• Giới hạn số người chơi trong một vùng đấu trường bằng player-count-limit.
• Chặn việc sử dụng và ném một số vật phẩm nhất định (mace, trident, ender pearls) trong khu vực sự kiện bằng disable-completely và disable-throw.
• Ngăn chế tạo trong inventory (2x2) ở khu an toàn bằng inventory-craft hoặc chặn dùng bàn chế tạo bằng permit-workbenches.
• Giới hạn người chơi vào vùng theo cấp XP hoặc một giá trị số từ PlaceholderAPI bằng entry-min-level / entry-max-level.
• Chạy lệnh console lặp lại trong khi người chơi vẫn ở trong vùng bằng console-command-repeat.

⌨️ Lệnh

⚙️ Cài đặt

📥 Thiết lập

• Tải JAR chính thức và đặt vào thư mục plugins/ của máy chủ cùng với WorldGuard.
• Nếu nâng cấp từ WorldGuardExtraFlags cũ: hãy xóa WorldGuardExtraFlags.jar cũ trước khi khởi động — hai plugin này không thể cùng tồn tại.
• Khởi động lại máy chủ và kiểm tra console để xác nhận plugin và các cờ của nó đã được tải đúng.

📦 Phụ thuộc

• Bắt buộc: WorldGuard (dự án này là một tiện ích mở rộng cho WorldGuard).
• Tùy chọn / Tích hợp: PlaceholderAPI (hỗ trợ placeholder số), PacketEvents hoặc ProtocolLib (chặn dựa trên packet tốt hơn), EssentialsX (tích hợp cho hành vi godmode/fly).

🧾 Cấu hình

• Thông báo của plugin được lưu trong plugins/WorldGuard/messages-wgefp.yml và có thể tùy chỉnh hoàn toàn; có hệ thống thời gian chờ giữa các thông báo có thể cấu hình qua file config của plugin.

🧠 Ghi chú kỹ thuật

• Dự án khai báo api-version: 1.21 và nhắm tới các artifact Paper API hiện đại; khả năng tương thích với Folia đã được triển khai và xác nhận.
• Bytecode Java và mục tiêu API phù hợp với các môi trường máy chủ thời kỳ 1.21 gần đây.
• Plugin thay thế hành vi cũ permit-completely bằng disable-completely để mở rộng ngữ nghĩa chặn vật phẩm.
• Một số tính năng (ví dụ chặn hoàn toàn một số cơ chế lao của giáo) đáng tin cậy hơn khi có PacketEvents hoặc ProtocolLib.
• Plugin cung cấp nhiều cờ thông qua các lệnh cờ chuẩn của WorldGuard (các cờ được đặt bằng giao diện cờ vùng của WorldGuard).

🤝 Khi nào plugin này hữu ích

Nếu bạn đang chạy WorldGuard và cần thêm các cờ vùng đã được xác nhận để kiểm soát việc sử dụng vật phẩm, quy tắc vào vùng của người chơi, chế tạo và các hành vi theo từng vùng khác — đặc biệt trên máy chủ Paper hoặc Folia — thì WorldGuard ExtraFlags Plus tập trung các khả năng đó ngay trong hệ thống cờ của WorldGuard mà không cần plugin quản lý vùng riêng.