Hướng dẫn

Cách làm plugin Spigot

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

Một plugin Spigot dùng API Bukkit/Spigot, nên chạy được trên Spigot và mọi bản fork của nó, kể cả Paper. Đó là lựa chọn rộng nhất khi bạn không biết plugin sẽ chạy ở đâu. Hướng dẫn này bao gồm dự án, mã và build.

Đổi ví dụ cho phù hợp với máy chủ của bạn.

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

Từng bước

  1. 1.Thiết lập Java và công cụ build

    Cài JDK khớp với phiên bản Minecraft của bạn (17, 21 hoặc 25) và dùng Maven hoặc Gradle.

  2. 2.Thêm Spigot API

    Thêm spigot-api cho phiên bản của bạn từ repository Spigot với phạm vi provided. Nó chỉ cần để biên dịch; máy chủ cung cấp nó khi chạy.

  3. 3.Viết lệnh và listener

    Đăng ký một CommandExecutor bằng getCommand("name").setExecutor(...) và các event listener bằng registerEvents.

  4. 4.Viết plugin.yml

    Tên, phiên bản, lớp chính, api-version (từ 1.13), lệnh và quyền.

  5. 5.Build và cài đặt

    mvn package, sau đó sao chép tệp .jar từ target/ vào thư mục plugins/ của máy chủ và khởi động lại.

Các phiên bản cũ (1.8 đến 1.12)

Nhiều máy chủ minigame vẫn chạy 1.8. API cũ hơn (không có api-version, tên vật liệu khác), nên plugin phải được viết cho phiên bản đó, không sao chép từ hướng dẫn 1.21. Codexe hỏi phiên bản và viết mã cho API đó.

Với Codexe

Hãy mô tả plugin và ghi "Spigot" kèm phiên bản. Codexe tạo dự án Maven, biên dịch, sửa lỗi, và cho bạn thử trên một máy chủ thử nghiệm của phiên bản đó trước khi bạn tải về.

Câu hỏi

Tôi có cần BuildTools không?

Chỉ để chạy một máy chủ Spigot hoặc dùng NMS (mã nội bộ của máy chủ). Để biên dịch theo API thông thường, phụ thuộc spigot-api là đủ.

Plugin Spigot hay plugin Paper?

Spigot nếu nó phải chạy ở mọi nơi; Paper nếu máy chủ của bạn chạy Paper và bạn muốn API bổ sung của nó. Xem cách làm plugin Paper.

Làm plugin Spigot

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

“Một plugin Spigot 1.8.8 tên Kits: /kit <name> tặng một bộ vật phẩm cấu hình được kèm thời gian hồi cho mỗi kit, kit định nghĩa trong config.yml, quyền kits.<name> cho từng kit, thời gian hồi được lưu qua các lần khởi động lại.”

Tạo thứ này với Codexe
Cách làm plugin Spigot: thiết lập, mã, build | Codexe