ClassCastException
Ép kiểu thất bại: thường là xung đột phiên bản giữa plugin và core, hoặc hai plugin tranh nhau cùng một hệ thống.
Cập nhật 13 tháng 8, 2026
java.lang.ClassCastException: class org.bukkit.craftbukkit.v1_20_R3.entity.CraftPlayer
cannot be cast to class com.example.CustomPlayer
Mã đã mong đợi một loại đối tượng nhưng lại nhận được loại khác.
Nguyên nhân thường gặp
- Phiên bản plugin không khớp với core. Các lớp
v1_20_R3trong nội dung lỗi là dấu hiệu trực tiếp của việc ràng buộc phiên bản — Khả năng tương thích. - Hai plugin ghi đè cùng một hệ thống (ví dụ, cả hai đều can thiệp vào thực thể người chơi).
- Core hybrid: một mod và một plugin xử lý cùng một đối tượng theo cách khác nhau — Hybrid.
Cần làm gì
- Cập nhật plugin cho phiên bản core của bạn.
- Xác định plugin thứ hai đang làm việc với cùng hệ thống và gỡ bỏ một trong hai — Plugin làm hỏng máy chủ.
- Trên hybrid, hãy kiểm tra xem có mod tương đương với plugin đó không.
Nếu lỗi xảy ra khi khởi động
Plugin sẽ không tải được chút nào. Nếu lỗi xảy ra khi người chơi thực hiện hành động, một số chức năng sẽ không hoạt động và log sẽ tiếp tục phình to.
Hosting MinecraftMáy chủ của bạn chạy khi bạn offlineTạo máy chủ
