คู่มือ

วิธีทำปลั๊กอิน Spigot

อัปเดตเมื่อ 7 ตุลาคม 2569

ปลั๊กอิน Spigot ใช้ Bukkit/Spigot API จึงรันได้บน Spigot และทุก fork ของมัน รวมถึง Paper ทำให้เป็นตัวเลือกที่ครอบคลุมที่สุดเมื่อคุณไม่รู้ว่าปลั๊กอินจะไปรันที่ไหน คู่มือนี้ครอบคลุมโปรเจกต์ โค้ด และการบิลด์

ปรับตัวอย่างให้เข้ากับเซิร์ฟเวอร์ของคุณ

สร้างสิ่งนี้ด้วย Codexe

ทีละขั้นตอน

  1. 1.ตั้งค่า Java และเครื่องมือบิลด์

    ติดตั้ง JDK ที่ตรงกับเวอร์ชัน Minecraft ของคุณ (17, 21 หรือ 25) แล้วใช้ Maven หรือ Gradle

  2. 2.เพิ่ม Spigot API

    เพิ่ม spigot-api ของเวอร์ชันคุณจากรีโพสิทอรี Spigot ด้วยสโคป provided ใช้แค่ตอนคอมไพล์ ส่วนตอนรันเซิร์ฟเวอร์จะมีให้เอง

  3. 3.เขียนคำสั่งและ listener

    ลงทะเบียน CommandExecutor ด้วย getCommand("name").setExecutor(...) และ event listener ด้วย registerEvents

  4. 4.เขียน plugin.yml

    ชื่อ เวอร์ชัน คลาสหลัก api-version (ตั้งแต่ 1.13) คำสั่ง และสิทธิ์

  5. 5.บิลด์และติดตั้ง

    mvn package แล้วคัดลอก .jar จาก target/ ไปที่โฟลเดอร์ plugins/ ของเซิร์ฟเวอร์ แล้วรีสตาร์ต

เวอร์ชันเก่า (1.8 ถึง 1.12)

เซิร์ฟเวอร์มินิเกมหลายแห่งยังรัน 1.8 อยู่ API เก่ากว่า (ไม่มี api-version ชื่อ material ต่างกัน) ปลั๊กอินจึงต้องเขียนสำหรับเวอร์ชันนั้น ไม่ใช่ลอกจากบทสอนของ 1.21 Codexe จะถามเวอร์ชันและเขียนโค้ดสำหรับ API นั้น

ด้วย Codexe

อธิบายปลั๊กอินแล้วระบุ “Spigot” พร้อมเวอร์ชัน Codexe จะสร้างโปรเจกต์ Maven คอมไพล์ แก้ข้อผิดพลาด และให้คุณทดสอบบนเซิร์ฟเวอร์ทดสอบเวอร์ชันนั้นก่อนดาวน์โหลด

คำถาม

ฉันต้องใช้ BuildTools ไหม?

ต้องใช้เฉพาะเมื่อจะรันเซิร์ฟเวอร์ Spigot หรือใช้ NMS (โค้ดภายในของเซิร์ฟเวอร์) ถ้าจะคอมไพล์กับ API ปกติ แค่ dependency spigot-api ก็พอ

ปลั๊กอิน Spigot หรือปลั๊กอิน Paper?

Spigot ถ้าต้องรันได้ทุกที่ Paper ถ้าเซิร์ฟเวอร์ของคุณรัน Paper และอยากใช้ API เพิ่มเติมของมัน ดูวิธีทำปลั๊กอิน Paper

สร้างปลั๊กอิน Spigot

พรอมต์นี้จะเปิดขึ้นพร้อมส่งได้ทันที:

“ปลั๊กอิน Spigot 1.8.8 ชื่อ Kits: /kit <name> ให้ชุดไอเทมที่ปรับแต่งได้ พร้อมคูลดาวน์แยกตามคิต คิตกำหนดใน config.yml สิทธิ์ kits.<name> แยกตามคิต และคูลดาวน์บันทึกไว้แม้รีสตาร์ต”

สร้างสิ่งนี้ด้วย Codexe
วิธีทำปลั๊กอิน Spigot: ตั้งค่า เขียนโค้ด บิลด์ | Codexe