Plugin Minecraft SuperVanish

🔌 Giới thiệu SuperVanish

SuperVanish là một plugin Minecraft dành cho máy chủ Bukkit/Spigot, cho phép quản trị viên và nhân viên máy chủ trở nên hoàn toàn vô hình với những người chơi khác. Mục tiêu của nó là cung cấp trạng thái vanish không thể bị phát hiện, phù hợp cho việc quản lý và kiểm thử, đồng thời cung cấp API để các plugin khác tương tác với trạng thái vanish.

🎯 Mục đích

Mục đích cốt lõi của plugin là quản lý và giám sát hành chính: cho phép nhân viên đáng tin cậy quan sát hành vi người chơi mà không xuất hiện trong playerlist, tin nhắn vào/ra máy chủ, hoặc sự hiện diện trong thế giới đối với phần lớn người chơi. Nó dành cho chủ máy chủ, quản trị viên và nhà phát triển plugin cần một triển khai vanish đáng tin cậy.

⚙️ Tính năng

• Ẩn hoàn toàn người chơi đang vanish khỏi những người chơi khác (khả năng nhìn thấy trong thế giới).
• Ẩn người chơi đang vanish trong danh sách người chơi (tab) với giao diện có thể cấu hình cho người quan sát.
• Điều chỉnh số lượng người chơi online/server list được báo cáo khi ProtocolLib có sẵn.
• Mô hình phân quyền nhiều lớp để cấu hình chính xác ai có thể nhìn thấy ai.
• Giữ nguyên trạng thái vanish khi vào server, khởi động lại và tải lại.
• Các điểm tích hợp tùy chọn cần ProtocolLib cho những tính năng nâng cao dựa trên packet.
• Khuyến nghị tùy chọn cài OpenInv để cải thiện hành vi "silent chest".
• VanishAPI công khai cho các plugin khác: các phương thức để ẩn/hiện người chơi, truy vấn người chơi vô hình, và lắng nghe PlayerHideEvent/PlayerShowEvent.

🧩 Dành cho ai

• Máy chủ Survival và SMP cần công cụ quản lý ẩn danh.
• Máy chủ muốn có API vanish cho các plugin quản lý hoặc tiện ích khác.
• Quản trị viên cần quy tắc hiển thị có thể cấu hình và kiểm soát tablist.

🏗️ Ví dụ sử dụng

• Một quản trị viên trở nên vô hình để điều tra báo cáo phá hoại mà không cảnh báo nghi phạm.
• Một plugin truy vấn VanishAPI để loại trừ người chơi đang vanish khỏi cơ chế gameplay hoặc báo cáo.
• Người vận hành máy chủ ẩn sự hiện diện của mình trong các bài kiểm thử trực tiếp để mô phỏng điều kiện chỉ có người chơi.

⚙️ Cài đặt

📥 Thiết lập

• Tải file JAR plugin chính thức và đặt nó vào thư mục plugins/ của máy chủ.
• Khởi động lại máy chủ và kiểm tra log console để xác nhận SuperVanish đã được tải.
• Nếu dùng ProtocolLib cho các tính năng mở rộng, hãy cài đặt thêm ProtocolLib và khởi động lại.

📦 Phụ thuộc

• ProtocolLib (tùy chọn): cần cho các tính năng dựa trên packet như điều chỉnh số lượng người chơi và một số tính năng action-bar.
• OpenInv (khuyến nghị tùy chọn): cải thiện hành vi silent chest khi tương tác với inventory trong lúc vanish.

🧠 Ghi chú kỹ thuật

• Nền tảng: được triển khai như một plugin Bukkit/Spigot và cung cấp Java API cho các plugin khác.
• API: cung cấp VanishAPI với các phương thức để ẩn/hiện người chơi, kiểm tra trạng thái vanish, và lấy danh sách người chơi vô hình; bao gồm PlayerHideEvent và PlayerShowEvent cho các tích hợp dựa trên sự kiện.
• Tính bền vững: có thể trả về danh sách tất cả người chơi vô hình (online và offline) thông qua API; việc lấy tất cả người chơi vô hình có thể liên quan đến truy cập cơ sở dữ liệu và nên được dùng cẩn thận ngoài main thread.
• Giấy phép: phát hành theo giấy phép MIT và mã nguồn có sẵn trong kho lưu trữ của dự án.

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

Nếu bạn cần một triển khai vanish tích hợp với các plugin khác và hỗ trợ các quy tắc hiển thị tinh vi cho quản lý, SuperVanish cung cấp vanish có thể cấu hình, dựa trên API, với các tích hợp ProtocolLib/OpenInv tùy chọn để cải thiện hành vi.