Plugin Minecraft CommandButtons

🔌 Giới thiệu CommandButtons

CommandButtons là một plugin Minecraft để gắn lệnh vào các tương tác với khối. Nó cho phép quản trị viên máy chủ gắn các bộ lệnh vào khối (nút bấm, biển, pressure plate hoặc các khối có thể nhấp), để các lệnh đó chạy khi người chơi tương tác với khối đã cấu hình. Plugin hỗ trợ chạy lệnh bằng console và/hoặc bằng người chơi đã kích hoạt khối, đồng thời cung cấp trình chỉnh sửa GUI trong game để quản lý các nút và thuộc tính của chúng.

🎯 Mục đích

Plugin này giải quyết việc tạo các phần tử thế giới tương tác thực hiện hành động quản trị hoặc gameplay mà không cần người chơi phải gõ lệnh. Các cách dùng phổ biến gồm bảng dịch chuyển, bảng chọn kit, hành động mua được, và các cơ chế tùy chỉnh được kích hoạt bởi tương tác với khối.

⚙️ Tính năng

• Gắn số lượng lệnh không giới hạn vào một command button duy nhất (lệnh console và lệnh người chơi).
• GUI trình chỉnh sửa trong game để tạo và sửa command buttons cùng vị trí của chúng.
• Cooldown theo từng người chơi và toàn cục; cooldown được giữ lại sau khi máy chủ khởi động lại.
• Tích hợp kinh tế tùy chọn qua Vault để thu phí người chơi khi dùng nút.
• Các node quyền tùy chỉnh để giới hạn việc dùng một số nút nhất định.
• Tin nhắn có thể tùy chỉnh thông qua tệp messages.
• Nhiều vị trí cho mỗi command button để một cấu hình có thể áp dụng cho nhiều khối.
• Các lệnh cơ bản để tạo, chỉnh sửa và tải lại dữ liệu plugin.

🧩 Dành cho ai

• Quản trị viên máy chủ và builder muốn có các phần tử thế giới có thể nhấp và chạy lệnh.
• Các máy chủ minigame và lobby cần menu tương tác hoặc bảng dịch chuyển/chọn kit.
• Các máy chủ dùng plugin kinh tế và muốn cơ chế trả phí theo lần dùng.

🏗️ Ví dụ sử dụng

• Một bảng dịch chuyển ở spawn, nơi mỗi nút đưa người chơi nhấp vào đến một đấu trường khác nhau.
• Một bức tường chọn kit: nhấn nút sẽ chạy một bộ lệnh để trao kit và gửi tin nhắn.
• Một hành động trả phí: nút trừ tiền trong game và chạy lệnh phần thưởng.

⌨️ Lệnh

🔐 Quyền

⚙️ Cài đặt

📥 Thiết lập

• Tải file jar chính thức của plugin và đặt 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 plugin đã tải đúng.
• Dùng các lệnh /commandbuttons được cung cấp để tạo và chỉnh sửa cấu hình nút trong game.

📦 Phụ thuộc

• Tùy chọn: Vault để bật tính năng thu phí kinh tế. Cần một plugin kinh tế tích hợp với Vault (ví dụ: EssentialsX economy) để dùng tính năng trả phí theo lần dùng.

🧠 Ghi chú kỹ thuật

• Plugin cung cấp trình chỉnh sửa GUI và tạo các tệp cấu hình/tin nhắn để tùy biến.
• Cooldown được giữ lại sau khi máy chủ khởi động lại.
• Hỗ trợ cả chế độ chạy lệnh bằng console và bằng người chơi; các lệnh chạy dưới dạng người chơi sẽ dùng quyền của người chơi đó (các lệnh cần quyền cao hơn quyền của người chơi sẽ không chạy khi được thực thi dưới dạng người chơi).
• Tính năng kinh tế cần Vault và một plugin kinh tế được hỗ trợ.

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

Hãy dùng CommandButtons khi bạn cần các hành động có thể cấu hình, gắn với vị trí, được kích hoạt bởi tương tác của người chơi (nút, biển, plate) với cooldown tích hợp, kiểm tra quyền và chi phí kinh tế tùy chọn, được quản lý qua trình chỉnh sửa trong game.