Hướng dẫn plugin.yml
plugin.yml là tệp cấu hình cần thiết để tải plugin trên máy chủ Spigot, Paper và Bukkit. Công cụ này giúp bạn tạo một tệp định dạng YAML định nghĩa hành vi của plugin.
Các trường name, main và version là bắt buộc. name là một định danh duy nhất cho plugin của bạn và chỉ được sử dụng chữ cái, số và dấu gạch dưới. main là đường dẫn đầy đủ đến lớp chính của plugin và version là số phiên bản của plugin.
Các trường siêu dữ liệu tùy chọn bao gồm description, author, authors, contributors, website, prefix, load và api-version. Chúng cung cấp thông tin bổ sung về plugin và có thể ảnh hưởng đến cách máy chủ tải plugin.
Các lệnh và quyền được sử dụng để định nghĩa các chức năng mà plugin cung cấp và ai có thể truy cập chúng. Mỗi lệnh có thể có tên, mô tả, cách dùng, quyền và thông báo quyền. Quyền có thể có node, mô tả, giá trị mặc định và quyền con.
Câu hỏi thường gặp
Tôi nên đặt tệp plugin.yml ở đâu?
Tệp plugin.yml đã tạo phải được đặt trong thư mục gốc bên trong tệp JAR của plugin. Thông thường, điều này sẽ được xử lý tự động bởi quá trình xây dựng plugin của bạn.
Tại sao tôi nhận được lỗi "Spigot requires name to use only letters, numbers, and underscores (a-z A-Z 0-9 _)."?
Điều này có nghĩa là tên plugin của bạn chứa các ký tự không hợp lệ. Spigot chỉ cho phép chữ cái, số và dấu gạch dưới trong tên plugin. Không được sử dụng khoảng trắng, dấu gạch nối hoặc các ký tự đặc biệt khác.
Làm cách nào để chỉ định nhiều tác giả hoặc người đóng góp?
Nhập danh sách tên được phân cách bằng dấu phẩy vào trường "authors" hoặc "contributors". Trường "authors" sẽ ghi đè trường "author".
Làm cách nào để thêm bí danh cho lệnh?
Nhập danh sách bí danh được phân cách bằng dấu phẩy vào trường "aliases" của lệnh. Ví dụ: nhập "mycommand, mc" sẽ cho phép lệnh được thực thi bằng cả "mycommand" và "mc".