คู่มือ

วิธีแก้ข้อผิดพลาดของปลั๊กอิน Minecraft

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

เมื่อปลั๊กอินโหลดไม่ขึ้น เซิร์ฟเวอร์แทบจะบอกเหตุผลเสมอ: สาเหตุอยู่ในคอนโซลระหว่างเริ่มทำงาน ไม่กี่บรรทัดเหนือหรือใต้ชื่อปลั๊กอิน หัดอ่านส่วนนั้นของล็อกแล้วข้อผิดพลาดส่วนใหญ่จะแก้ได้ในนาทีเดียว นี่คือข้อผิดพลาดที่พบบ่อยและความหมาย

ระบุเวอร์ชันเซิร์ฟเวอร์ของคุณและสิ่งที่ปลั๊กอินควรทำ

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

ทีละขั้นตอน

1.เปิดล็อกตอนเริ่มทำงาน
อ่านคอนโซล หรือ logs/latest.log ในโฟลเดอร์เซิร์ฟเวอร์ ถ้าใช้แผงโฮสติ้ง ให้ใช้คอนโซลหรือตัวจัดการไฟล์ของแผง
2.ค้นหาชื่อปลั๊กอิน
หาข้อผิดพลาดแรกที่พูดถึงปลั๊กอินนั้น บรรทัดที่ขึ้นต้นด้วย [ERROR] หรือ [WARN] และ stack trace ที่ตามมาคือส่วนที่สำคัญ
3.อ่านบรรทัดแรกและบรรทัด "Caused by"
บรรทัดแรกบอกว่าอะไรล้มเหลว บรรทัด Caused by: สุดท้ายมักบอกว่าทำไม บรรทัดที่มีชื่อ package ของปลั๊กอินเองจะบอกว่าอยู่ตรงไหนในโค้ด
4.จับคู่กับรายการด้านล่าง
ข้อผิดพลาดตอนเริ่มทำงานส่วนใหญ่เป็นปัญหาเรื่องเวอร์ชัน Java หรือ dependency และข้อความจะบอกว่าเป็นเรื่องไหน
5.แก้ทีละอย่างแล้วรีสตาร์ต
เปลี่ยนทีละอย่าง รีสตาร์ต (ไม่ใช่ /reload) แล้วอ่านล็อกอีกครั้ง ข้อผิดพลาดจากปลั๊กอินตัวหนึ่งอาจทำให้ตัวอื่นเกิดข้อผิดพลาดตามไปด้วย

ข้อผิดพลาดที่พบบ่อย

สิ่งที่คุณเห็น	ความหมาย	วิธีแก้
`Unsupported API version 1.21`	`api-version` ของปลั๊กอินใหม่กว่าเซิร์ฟเวอร์ของคุณ	ใช้เวอร์ชันที่ตรงกับเซิร์ฟเวอร์ของคุณ หรืออัปเดตเซิร์ฟเวอร์
`Could not load 'plugins/X.jar'` พร้อม `Invalid plugin.yml` หรือ `Jar does not contain plugin.yml`	descriptor ของปลั๊กอินหายไปหรือมีข้อผิดพลาด YAML หรือไฟล์นั้นไม่ใช่ปลั๊กอิน	เช็กว่าคุณดาวน์โหลดตัวปลั๊กอิน ไม่ใช่ซอร์สโค้ด ม็อด หรือ zip ถ้าคุณบิลด์เอง ให้แก้ `plugin.yml`
`UnsupportedClassVersionError`, "class file version 65.0"	ปลั๊กอินต้องการ Java ที่ใหม่กว่าที่เซิร์ฟเวอร์ใช้อยู่ (61 = Java 17, 65 = Java 21, 69 = Java 25)	รันเซิร์ฟเวอร์ด้วย Java เวอร์ชันนั้น หรือบิลด์ปลั๊กอินใหม่สำหรับ Java ของคุณ
`NoClassDefFoundError` หรือ `ClassNotFoundException`	ไม่มีคลาสที่ปลั๊กอินต้องการ: ขาดปลั๊กอินที่เป็น dependency ไลบรารีไม่ได้ถูก shade เข้าไปใน .jar หรือ API นั้นไม่มีในเวอร์ชันนี้	ติดตั้งปลั๊กอินที่ระบุในข้อผิดพลาด (Vault, ProtocolLib) หรือใช้บิลด์สำหรับเวอร์ชันของคุณ
`Unknown/missing dependency plugins`	ปลั๊กอินที่อยู่ใน `depend` ไม่ได้ติดตั้งไว้	ติดตั้งไว้ใน `plugins/`
`Error occurred while enabling X (Is it up to date?)`	ปลั๊กอินโหลดแล้วแต่แครชใน `onEnable`	อ่านบรรทัด `Caused by`: มักเป็นข้อผิดพลาดของคอนฟิกหรือขาด dependency
`Ambiguous plugin name`	มีไฟล์ .jar ของปลั๊กอินเดียวกันสองไฟล์ใน `plugins/`	ลบตัวเก่าออก

ข้อผิดพลาดที่ไม่เกี่ยวกับการโหลด

ปลั๊กอินเป็นสีเขียวแต่คำสั่งขึ้นว่า "Unknown command": คำสั่งไม่ได้อยู่ใน plugin.yml หรือปลั๊กอินอื่นใช้ชื่อเดียวกัน
"I'm sorry, but you do not have permission": ผู้เล่นไม่มี permission node ดู node ที่หน้าของปลั๊กอินแล้วให้สิทธิ์ด้วยปลั๊กอินจัดการ permission ของคุณ
ข้อผิดพลาดหลังแก้ config.yml: YAML ต้องใช้ช่องว่าง ไม่ใช่แท็บ และต้องใส่เครื่องหมายคำพูดครอบข้อความที่ขึ้นต้นด้วย : หรือ &
ใช้ได้หลังรีสตาร์ต แต่พังหลัง /reload: ปลั๊กอินไม่รองรับ /reload ให้รีสตาร์ตแทน

เซิร์ฟเวอร์ของคุณต้องใช้ Java เวอร์ชันไหน

Minecraft 1.20.5 ขึ้นไปต้องใช้ Java 21 และ 26.x ต้องใช้ Java 25 ส่วน 1.18 ถึง 1.20.4 ต้องใช้ Java 17 รัน java -version ด้วย Java ตัวเดียวกับที่เซิร์ฟเวอร์ใช้ (บนแผงโฮสติ้ง มักเป็นการตั้งค่าชื่อ Docker image หรือ Java version) ปลั๊กอินที่บิลด์สำหรับ Java รุ่นเก่ารันบนรุ่นใหม่ได้ แต่กลับกันไม่ได้

การแก้ปลั๊กอินที่ทำด้วย Codexe

ปลั๊กอินที่ทำบน Codexe ถูกคอมไพล์สำหรับเวอร์ชันที่คุณเลือก และตรวจว่ามี plugin.yml ที่ถูกต้องก่อนจะพร้อม บนเซิร์ฟเวอร์ทดสอบ แท็บ ล็อก แสดงล็อกแบบสดพร้อมไฮไลต์ข้อผิดพลาด และ ส่งออกล็อก บันทึกเป็นไฟล์ได้ อธิบายสิ่งที่คุณเห็นในแชตของโปรเจกต์ ("ปลั๊กอินเป็นสีแดงใน /plugins และล็อกขึ้นว่า ...") แล้ว Codexe จะแก้โค้ดและบิลด์ใหม่ ถ้าการคอมไพล์ล้มเหลวกับไฟล์ที่ยังเหมือนตอนที่ Codexe ส่งมอบทุกประการ แก้ด้วย AI จะซ่อมให้ฟรี

คำถาม

ล็อกของเซิร์ฟเวอร์อยู่ที่ไหน?

logs/latest.log ในโฟลเดอร์เซิร์ฟเวอร์ สำหรับการรันครั้งปัจจุบัน การรันครั้งก่อนๆ อยู่ในโฟลเดอร์เดียวกันเป็นไฟล์ .log.gz

ปลั๊กอินตัวหนึ่งทำให้อีกตัวพังได้ไหม?

ได้: dependency ที่ขาดหรือพังจะหยุดทุกปลั๊กอินที่ต้องใช้มัน แก้ข้อผิดพลาดแรกในล็อกก่อนตัวอื่น

แชร์ล็อกของฉันปลอดภัยไหม?

ส่วนใหญ่ปลอดภัย แต่เช็กก่อน: ล็อกอาจมีที่อยู่ IP และในบางปลั๊กอินอาจมีรหัสผ่านฐานข้อมูลที่หลุดมาจากข้อผิดพลาด

บิลด์ปลั๊กอินที่พังใหม่สำหรับเซิร์ฟเวอร์ของคุณ

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

“ปลั๊กอิน Paper 1.21.4 ชื่อ SimpleWarps ที่แทนตัวเก่าของฉันซึ่งโหลดไม่ขึ้นแล้ว: /setwarp, /warp และ /delwarp พร้อมชื่อ, /warps แสดงรายการใน GUI, permission warps.admin สำหรับตั้งและลบ, วาร์ปบันทึกข้ามการรีสตาร์ต, ข้อความอยู่ใน config.yml”