Chuyển đến nội dung
Bắt đầu

Dự án đầu tiên của bạn

Hướng dẫn từng bước một dự án đầu tiên thật, một plugin homes cho Paper, từ yêu cầu đến tệp JAR đã thử.

Đã cập nhật

Trên trang này
  1. Yêu cầu
  2. Điều gì xảy ra tiếp theo
  3. Xem kết quả
  4. Thay đổi một điều gì đó
  5. Build và thử nghiệm
  6. Tiếp theo

Hướng dẫn này tạo một plugin nhỏ nhưng thật, để bạn thấy mỗi giai đoạn một lần. Quy trình này áp dụng cho mọi loại dự án.

#Yêu cầu

Trên trang Tạo mới, chọn Plugin Bukkit/Spigot/Paper (Java) và viết:

Text
A Paper 1.21.4 plugin called SimpleHomes.
- /sethome saves the player's current location as their home (one home per player).
- /home teleports them there after a 3 second warm-up; moving cancels it.
- 30 second cooldown on /home, configurable in config.yml.
- Homes persist across restarts in a YAML file.
- Permissions: simplehomes.use (default true), simplehomes.bypasscooldown (default op).
- Messages configurable in config.yml, with color codes.

Hãy để ý những gì yêu cầu này chứa: nền tảng và phiên bản, từng lệnh và chức năng của nó, quy tắc thời gian, cách lưu trữ, quyền và những gì cần tùy chỉnh được. Chính những điều đó giúp kết quả đầu tiên dùng được ngay.

#Điều gì xảy ra tiếp theo

  1. Codexe lần lượt truyền các tệp: một pom.xml của Maven, lớp chính, các lớp lệnh và listener, plugin.yml và config.yml.
  2. Banner chuyển sang Đang kiểm tra dự án… rồi Đang build…. Codexe biên dịch plugin.
  3. Nếu trình biên dịch báo lỗi (ví dụ một import sai), bạn sẽ thấy Đang sửa một lỗi…. Codexe sửa code và build lại. Việc này không dùng token của bạn.
  4. Dự án chuyển sang Sẵn sàng.

#Xem kết quả

  • Mở plugin.yml và kiểm tra rằng các lệnh và quyền khớp với những gì bạn yêu cầu.
  • Mở config.yml: thời gian chờ và các tin nhắn phải có ở đó.
  • Đọc lướt lớp chính. Bạn không cần hiểu từng dòng, nhưng có thể nhận ra những chỗ thiếu rõ ràng.

#Thay đổi một điều gì đó

Trong khung chat của dự án, hãy gõ:

Text
Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.

Codexe sửa các tệp hiện có thay vì làm lại từ đầu. Các yêu cầu tiếp theo tốn ít hơn nhiều so với một dự án mới, vì chỉ những tệp bị ảnh hưởng mới được viết lại. Khi thay đổi chạm đến một dự án build được, Codexe sẽ xác minh lại.

#Build và thử nghiệm

Nhấn Biên dịch để chạy một bản build mới, rồi nhấn Tải JAR. Đặt tệp JAR vào thư mục plugins/ của máy chủ và khởi động lại. Thử từng lệnh, bao gồm cả các trường hợp biên (di chuyển trong lúc chờ dịch chuyển, thời gian chờ, một lần khởi động lại).

#Tiếp theo

Dự án đầu tiên của bạn | Codexe Docs