Plugin Minecraft PvPManager

🔌 Giới thiệu về PvPManager

PvPManager là một plugin Minecraft dùng để quản lý hành vi player-versus-player và các quy tắc liên quan đến combat trên server. Nó kết hợp PvP toggles, combat tagging, chống combat-log, bảo vệ người chơi mới và nhiều hành vi khi kill/respawn vào một plugin có thể cấu hình, hướng tới quản trị viên server.

🎯 Mục đích

Mục đích cốt lõi của PvPManager là cung cấp các điều khiển tập trung, có thể cấu hình cho các tương tác PvP và những tình huống đặc biệt liên quan đến combat, ताकि chủ server có thể áp dụng các quy tắc nhất quán (bật/tắt PvP, phạt combat logging, bảo vệ người mới, kiểm soát phần thưởng/hình phạt khi kill và quản lý hạn chế combat).

⚙️ Tính năng

• Bật/tắt PvP theo từng người chơi, từng thế giới hoặc toàn server.
• Hệ thống combat tag với bộ đếm thời gian có thể cấu hình và chỉ báo trực quan (action bar/boss bar).
• Chống combat-log với các hình phạt có thể cấu hình (rớt inventory, rớt armor/exp, phạt tiền, giết người chơi, phát sóng/ghi log sự kiện).
• Bảo vệ người mới và bảo vệ khi respawn/teleport.
• Chống border-hopping (ngăn chạy vào khu an toàn khi đang bị tag) và các trigger chống kill-abuse.
• Vô hiệu hóa hành động khi đang combat (fly, đổi gamemode, commands, enderpearls, đặt block, v.v.).
• Tùy chọn xử lý inventory (giữ lại, làm rơi hoặc chuyển drop cho killer) và hỗ trợ auto-soup.
• Phần thưởng/phạt tiền và commands có thể thực thi khi kill.
• Tích hợp với PlaceholderAPI và hỗ trợ các plugin khu vực (WorldGuard, Towny) và Citizens; các tích hợp tùy chọn cho một số hành vi cụ thể.
• Telemetry và báo cáo sử dụng qua bStats.

🧩 Dành cho ai

• Các server Survival và SMP cần quy tắc PvP có thể cấu hình.
• Các server cần bảo vệ chống combat logging và an toàn cho người mới tham gia.
• Quản trị viên muốn có quy tắc kill/reward tích hợp và các PvP toggles đơn giản mà không cần nhiều plugin riêng lẻ.

🏗️ Ví dụ sử dụng

• Bật bảo vệ người mới cho những phiên chơi đầu tiên và chỉ cho phép PvP sau một khoảng thời gian có thể cấu hình.
• Tag người chơi khi combat và ngăn họ dùng teleport, commands hoặc vào khu an toàn cho đến khi tag hết hạn.
• Phạt những người chơi disconnect trong combat bằng cách làm rơi inventory hoặc áp dụng hình phạt do server định nghĩa.
• Tự động thưởng tiền cho killer hoặc thực thi commands tùy chỉnh khi kill.

⌨️ Commands

Ghi chú: các commands được liệt kê lấy từ tài liệu chính thức của plugin và trang resource. Các permission nodes cho từng command đã được dự án tài liệu hóa nhưng không được trình bày ở đây.

⚙️ Cài đặt

📥 Thiết lập

• Tải file JAR chính thức của plugin từ trang phân phối dành cho nền tảng của bạn.
• Đặt file JAR vào thư mục plugins/ trên server tương thích với Spigot/Paper.
• Khởi động lại server và kiểm tra console logs để xác nhận plugin đã được tải.

📦 Phụ thuộc

• PlaceholderAPI (tích hợp tùy chọn cho placeholders).
• Có sẵn tích hợp cho các plugin khu vực và NPC như WorldGuard, Towny và Citizens (tùy chọn, được dùng khi có mặt).

🧠 Ghi chú kỹ thuật

• Phần mềm server được xác nhận hỗ trợ gồm Spigot và Paper; dự án cũng liệt kê hỗ trợ Folia.
• Plugin cung cấp developer API và phát hành dev builds để kiểm thử.
• Dự án công bố source code và issue tracking trên repository công khai của mình và dùng bStats cho telemetry.
• Các phiên bản Minecraft đã test trải dài qua nhiều bản phát hành; chủ server nên xem tài liệu của plugin để biết chính xác khả năng tương thích với một phiên bản server cụ thể.

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

PvPManager hữu ích khi bạn cần một plugin duy nhất, có thể cấu hình để xử lý PvP toggles, combat tagging, phạt combat-log và bảo vệ người mới mà không phải ghép nhiều plugin riêng lẻ. Nó tập trung các quy tắc PvP phổ biến và cung cấp commands cho admin cùng các tích hợp để điều chỉnh hành vi theo nhiều kiểu server khác nhau.