Plugin Minecraft MyCommand

🔌 Giới thiệu MyCommand

MyCommand là một plugin Minecraft để tạo lệnh tùy chỉnh, alias và các giao diện tương tác điều khiển bằng lệnh mà không cần viết Java. Plugin cung cấp hệ thống dựa trên YAML để định nghĩa các lệnh có thể chạy lệnh khác, gửi văn bản đã định dạng, mở GUI, kích hoạt script và tương tác với event.

🎯 Mục đích

MyCommand dành cho quản trị viên server cần các lệnh tùy chỉnh linh hoạt, phím tắt và giao diện admin/người chơi. Nó giải quyết nhu cầu thêm hành vi lệnh riêng (delay, warmup, cooldown, tab-completion, placeholders) và các tương tác GUI nhẹ mà không cần phát triển một plugin hoàn chỉnh.

⚙️ Tính năng

• Tạo lệnh và alias mới, có thể đăng ký cho tab completion.
• Chạy nhiều lệnh từ một lệnh tùy chỉnh duy nhất (thực thi bởi console hoặc người chơi).
• Delay, warmup và cooldown cho lệnh.
• Ghi đè lệnh khác hoặc cung cấp phím tắt/alias.
• Kích hoạt lệnh từ item, block, sign, book, NPC và item frame.
• Thành phần GUI: IconMenu dựa trên chest, ActionBar, BossBar, Title, Scoreboard, Anvil GUI và Sign GUI.
• Hỗ trợ placeholders và các điều kiện kiểu script cho hành vi động.
• Tích hợp kinh tế (tùy chọn qua Vault) và một số tính năng kinh tế độc lập.
• Hỗ trợ event người chơi (join/quit/death) và tác vụ theo lịch.
• Cơ sở dữ liệu người chơi tùy chỉnh dùng SQL tùy chọn và hỗ trợ nhiều file cho số lượng lệnh không giới hạn.
• Tính năng liên quan đến BungeeCord và một biến thể riêng cho phía Bungee để xử lý lệnh ở phía proxy.
• Yêu cầu HTTP (GET/POST) và hỗ trợ định dạng MiniMessage khi có sẵn.
• Dùng bStats để báo cáo số liệu.

🧩 Dành cho ai

• Server Survival và SMP muốn có lệnh và menu tùy chỉnh mà không cần code.
• Server thiên về admin hoặc kinh tế cần luồng shop/command tùy chỉnh.
• Mạng proxy cần hành vi lệnh tập trung hoặc ở phía proxy.
• Người vận hành server cần điều kiện kiểu script và placeholders cho đầu ra động.

🏗️ Ví dụ sử dụng

• Định nghĩa một lệnh duy nhất chạy chuỗi lệnh console để mở shop, đưa vật phẩm và ghi lại giao dịch.
• Tạo menu GUI punish/teleport bằng các mục chest GUI và prompt anvil/sign.
• Cung cấp alias ngắn ánh xạ tới các lệnh chuyển server BungeeCord dài hơn với tab completion.

⌨️ Commands

Tài liệu chính thức liệt kê các lệnh quản trị để quản lý plugin. Ví dụ được dự án ghi nhận bao gồm:

(Xem tài liệu lệnh chính thức của plugin để biết danh sách đầy đủ và cú pháp chính xác.)

🔐 Permissions

Dự án có tài liệu về các node permission cho các thao tác quản trị. Ví dụ từ danh sách permission chính thức gồm:

(Xem tài liệu permissions của plugin để có bản đồ permission đầy đủ.)

⚙️ 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 server.
• Khởi động hoặc khởi động lại server và kiểm tra log console để xác nhận plugin đã được tải.
• Nếu plugin không tải được, hãy kiểm tra rằng các plugin hỗ trợ bắt buộc/tùy chọn (xem Dependencies) đã có hoặc đã được cập nhật.

📦 Dependencies

• ProtocolLib — được ghi là quan trọng nếu plugin không tải hoặc cho một số tính năng.
• Vault — tùy chọn, cần cho tích hợp kinh tế.
• PlaceholderAPI — tùy chọn, để mở rộng hỗ trợ placeholders.

Chỉ cài các dependency đã được xác nhận cho các tính năng bạn muốn; nhiều tích hợp là tùy chọn.

🧠 Ghi chú kỹ thuật

• Plugin được cấu hình qua các file YAML và hỗ trợ nhiều file command để tránh giới hạn số lệnh.
• Có lưu trữ SQL cho cơ sở dữ liệu người chơi tùy chỉnh (tùy chọn) và hỗ trợ thiết lập nhiều file.
• Có một thành phần BungeeCord riêng để xử lý lệnh ở phía proxy.
• Dự án báo cáo số liệu qua bStats.
• Định dạng MiniMessage và hỗ trợ tab-completion có sẵn trong các môi trường được hỗ trợ.

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

Nếu bạn cần các lệnh tùy chỉnh linh hoạt, dựa trên file, scripting có điều kiện và luồng lệnh dựa trên GUI mà không cần viết Java, MyCommand cung cấp một nền tảng có thể cấu hình cho những nhu cầu đó và bổ sung tích hợp proxy cùng kinh tế khi cần.