Hướng dẫn

Cách làm plugin Paper

Cập nhật 7 tháng 10, 2026

Paper là phần mềm máy chủ Minecraft được dùng nhiều nhất cho plugin: nó chạy plugin Spigot và thêm một API lớn hơn, nhanh hơn. Một plugin Paper là một dự án Java (hoặc Kotlin) được biên dịch theo paper-api. Đây là những gì nó cần, bằng tay hoặc với một AI build giúp bạn.

Một ví dụ để bắt đầu.

Tạo thứ này với Codexe

Từng bước

  1. 1.Chọn phiên bản Minecraft

    Dùng phiên bản máy chủ của bạn đang chạy. Nó quyết định phiên bản Java: Java 17 trước 1.20.5, Java 21 từ 1.20.5, Java 25 cho 26.x.

  2. 2.Tạo dự án

    Một dự án Gradle hoặc Maven với phụ thuộc paper-api cho phiên bản đó, từ repository PaperMC, với phạm vi provided/compileOnly.

  3. 3.Viết lớp chính

    Một lớp kế thừa JavaPlugin, với onEnable() để đăng ký lệnh và listener.

  4. 4.Mô tả plugin cho máy chủ

    plugin.yml (name, version, main, api-version, commands, permissions). Paper cũng hỗ trợ paper-plugin.yml, với quy tắc nạp riêng.

  5. 5.Build và kiểm thử

    Build tệp .jar, đặt vào thư mục plugins/ của một máy chủ Paper thử nghiệm, khởi động và kiểm tra console xem có lỗi không.

Paper hay Spigot?

Mã viết cho Spigot API chạy được trên Paper, nhưng ngược lại thì không: Paper thêm các sự kiện và phương thức (ví dụ thành phần văn bản Adventure và nhiều API bất đồng bộ) mà Spigot không có. Hãy viết cho Paper nếu máy chủ của bạn chạy Paper; viết cho Spigot nếu plugin cũng phải chạy trên máy chủ Spigot.

Cách nhanh

Trên Codexe, chọn một plugin Bukkit/Spigot/Paper, ghi "Paper" và phiên bản trong yêu cầu, rồi mô tả nó làm gì. Codexe thiết lập dự án và đúng phiên bản Java, biên dịch, sửa lỗi build và cho bạn vào một máy chủ thử nghiệm Paper có cài plugin.

Các vấn đề thường gặp

  • UnsupportedClassVersionError: plugin được biên dịch bằng Java mới hơn phiên bản máy chủ đang chạy.
  • NoSuchMethodError / NoClassDefFoundError: plugin dùng một API không tồn tại trên phiên bản máy chủ, hoặc một phụ thuộc chưa được shade vào tệp .jar.
  • Plugin nạp được nhưng lệnh không làm gì: lệnh bị thiếu trong plugin.yml hoặc executor chưa được đăng ký.

Câu hỏi

Plugin Paper có chạy trên Purpur hay Folia không?

Purpur là một bản fork của Paper, nên plugin Paper chạy được ở đó. Folia thay đổi mô hình luồng: plugin phải được viết cho bộ lập lịch theo vùng của nó để chạy trên Folia.

Tôi có thể viết plugin Paper bằng Kotlin không?

Có. Codexe có thể tạo một dự án Kotlin Gradle với build.gradle.kts cho cùng Paper API.

Tạo plugin Paper ngay

Prompt này mở ra sẵn sàng để gửi:

“Một plugin Paper 1.21.4 tên Bounties: /bounty set <player> <amount> dùng nền kinh tế Vault, người giết nhận phần thưởng, /bounty list hiện top 10, tiền truy nã được lưu qua các lần khởi động lại, tin nhắn nằm trong config.yml.”

Tạo thứ này với Codexe
Cách làm plugin Paper (Minecraft) | Codexe