Plugin Minecraft CommandPanels

🔌 Giới thiệu CommandPanels

CommandPanels là một plugin Minecraft cung cấp hệ thống GUI/menu dựa trên YAML cho máy chủ. Nó tập trung vào các panel dựa trên inventory, panel hội thoại (form), và các panel tương thích với Floodgate cho người chơi Bedrock. Dự án bao gồm một trình chỉnh sửa trực tuyến và một định dạng có cấu trúc để xây dựng các menu tương tác, dựa trên dữ liệu, có thể chạy lệnh, hiển thị placeholder động và phản hồi theo logic cũng như quyền hạn.

🎯 Mục đích

Plugin này dành cho quản trị viên máy chủ và nhà phát triển cần các GUI linh hoạt, có thể lập trình cho shop, kit, lobby, công cụ kiểm duyệt hoặc quy trình tùy chỉnh. Nó được thiết kế để các panel có thể thực thi lệnh, kiểm tra điều kiện, tạo hiệu ứng cho item và cung cấp dữ liệu phiên hoặc dữ liệu lưu lâu dài để dùng trong các hệ thống khác.

⚙️ Tính năng

• Panel inventory với tương tác item, bố cục slot và chuỗi hoạt ảnh.
• Panel hội thoại cho các form có cấu trúc và nhập liệu từ người chơi.
• Hỗ trợ panel Floodgate để hiển thị các panel tương thích cho người chơi Bedrock (thông qua thiết lập Geyser/Floodgate).
• Logic và điều kiện inline (toán tử kiểu AND/OR/NOT) để kiểm soát khả năng hiển thị và hành vi.
• Hệ thống lệnh/hành động: hook mở/đóng, hành động nhấp, hành động nhấp bên ngoài và thực thi lệnh có điều kiện.
• Hỗ trợ PlaceholderAPI và cập nhật placeholder động bên trong panel.
• Dữ liệu panel theo phiên và dữ liệu lưu lâu dài có thể truy cập xuyên suốt giữa các panel và lệnh.
• Cập nhật định kỳ và một bộ theo dõi quyền hạn có thể kích hoạt phân tích lại toàn bộ logic khi quyền thay đổi.
• Trình chỉnh sửa trực tuyến với xem trước YAML trực tiếp và kiểm tra cấu trúc.

🧩 Dành cho ai

Dành cho quản trị viên và nhà phát triển plugin đang vận hành các máy chủ hiện đại tương thích Paper, cần các menu GUI linh hoạt: máy chủ Survival/SMP, mạng minigame, hub PvP và các máy chủ cần giao diện quản trị/kiểm duyệt tùy chỉnh.

🏗️ Ví dụ sử dụng

• Tạo GUI kit hoặc shop chạy lệnh máy chủ và yêu cầu quyền cụ thể hoặc số dư kinh tế.
• Xây dựng menu điều hướng hub với item có hoạt ảnh và khả năng hiển thị có điều kiện dựa trên cấp bậc người chơi.
• Cung cấp menu tương thích Bedrock bằng các biến thể panel dành riêng cho Floodgate.

⌨️ Commands

(Các lệnh và quyền của chúng được lấy từ tài liệu chính thức của CommandPanels.)

🔐 Permissions

| Permission | Description | Default | |---|---|---|---| | commandpanels.command | Cho phép truy cập lệnh cơ bản /pa. | true | | commandpanels.command.reload | Cho phép tải lại plugin. | op | | commandpanels.command.generate | Truy cập lệnh tạo panel. | op | | commandpanels.command.version | Cho phép kiểm tra phiên bản plugin. | true | | commandpanels.command.data | Cho phép cấu hình dữ liệu panel. | op | | commandpanels.command.open | Cho phép mở panel bằng /pa open. | op | | commandpanels.command.open.other | Cho phép mở panel cho người chơi khác. | op | | commandpanels.command.help | Cho phép truy cập /pa help. | true |

⚙️ Cài đặt

📥 Thiết lập

• Tải file .jar chính thức của CommandPanels và đặt nó vào thư mục plugins/ của máy chủ.
• Khởi động máy chủ để tạo dữ liệu plugin.
• Sau lần chạy đầu tiên, kiểm tra plugins/CommandPanels để xem config.yml và thư mục panels/ chứa các file định nghĩa panel.

📦 Dependencies

• PlaceholderAPI — tùy chọn nhưng được khuyến nghị cho placeholder động.
• Floodgate — tùy chọn cho hỗ trợ panel Bedrock (Floodgate).

🧾 Cấu hình

• Các panel được định nghĩa dưới dạng file YAML đặt trong thư mục panels/. Hỗ trợ các thư mục con để sắp xếp.
• Plugin sẽ tạo các panel mẫu nếu thư mục panels/ bị xóa rồi plugin được khởi động lại.

🧠 Ghi chú kỹ thuật

• Tài liệu chính thức và các bản phát hành cho biết Paper và Folia (nhánh của Paper) là các nền tảng máy chủ được hỗ trợ cho các bản phát hành v4 hiện đại.
• Dòng phát hành v4 tập trung vào các phiên bản máy chủ Minecraft mới hơn; định nghĩa panel hỗ trợ placeholder động và logic có điều kiện được phân tích ở thời gian chạy.
• Plugin cung cấp các node quyền và API dựa trên lệnh để mở panel; nó cũng có thể được nhúng như một thư viện trong các plugin khác bằng cách tải YAML panel và gọi các hành động mở.

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

Nếu bạn cần một hệ thống GUI có cấu trúc, có thể script, hỗ trợ dữ liệu động, logic có điều kiện, tương thích Bedrock và trình chỉnh sửa trực tuyến, CommandPanels cung cấp một cách tiếp cận dựa trên YAML đã được xác nhận và phù hợp với các máy chủ và mạng lưới dùng Paper.