Khắc phục sự cố
Lỗi nền tảng thường gặp
Cách xử lý lỗi khi chạy kết quả từ Codexe: plugin không nạp, mod bị crash, datapack không áp dụng, lỗi phân tích cú pháp Skript, và vì sao mod build bằng Java 21 cho Java 17.
Đã cập nhật
Trên trang này
#Plugin
| Triệu chứng | Cách xử lý |
|---|---|
Plugin không có trong /plugins | Tìm tên plugin trong nhật ký khởi động. "Invalid plugin.yml" hoặc "main class not found" nghĩa là tệp mô tả bị sai: hãy nhờ khung chat sửa plugin.yml. |
| "Unsupported API version" | Plugin được build cho API Minecraft mới hơn máy chủ của bạn. Hãy nói rõ phiên bản máy chủ và yêu cầu build lại cho phiên bản đó. |
NoClassDefFoundError nêu tên một plugin khác | Một phụ thuộc (Vault, PlaceholderAPI, …) chưa được cài. |
Chạy được sau khi khởi động lại, hỏng sau /reload | Nhiều plugin không hỗ trợ /reload. Hãy khởi động lại máy chủ. |
#Mod
| Triệu chứng | Cách xử lý |
|---|---|
| Game crash trên máy chủ chuyên dụng | Code chỉ dành cho client nằm trong code chung hoặc code chính. Hãy nhờ khung chat tách code client ra. |
| "Incompatible mod set" / sai phiên bản game | Mod nhắm tới một phiên bản Minecraft hoặc loader khác. Hãy nêu rõ cả hai. |
| Thiếu phụ thuộc khi khởi động (Fabric) | Cài Fabric API (và mọi phụ thuộc khác được liệt kê) vào mods/. |
#Vì sao mod của tôi build bằng Java 21 khi nó nhắm tới Java 17?
Với các phiên bản Minecraft trước 1.20.5, mod nhắm tới Java 17. Tuy nhiên, công cụ build của Fabric (Loom) chỉ chạy trên Java 21 trở lên. Codexe chạy Gradle bằng Java 21 trong khi vẫn biên dịch mod của bạn cho Java 17, nên tệp JAR chạy được trên máy chủ hoặc client Java 17. Điều đó là bình thường, và đó là lý do nhật ký build Fabric 1.20.1 có nhắc đến Java 21.
#Datapack
| Triệu chứng | Cách xử lý |
|---|---|
/datapack list không hiển thị datapack | Tệp ZIP phải chứa pack.mcmeta ở cấp trên cùng, đặt trong world/datapacks/. |
| Đã nạp nhưng một công thức chế tạo hoặc function không làm gì | Sai pack_format hoặc tên thư mục so với phiên bản của bạn. Hãy nêu chính xác phiên bản Minecraft. |
#Skript
| Triệu chứng | Cách xử lý |
|---|---|
Lỗi phân tích cú pháp khi /sk reload | Thường do thiếu add-on. Kiểm tra xem script dùng những add-on nào (hỏi khung chat nếu không chắc), rồi cài chúng. |
Một biểu thức như player's balance không tồn tại | Cài Vault và một plugin kinh tế. |