Cài đặt, phiên bản và phạm vi dữ liệu
Nền tảng chính xác
Thông tin dưới đây lấy từ META-INF/neoforge.mods.toml và import Java thực tế:
| Thành phần | Yêu cầu |
|---|---|
| Minecraft | 1.21.1 |
| Loader | NeoForge |
| NeoForge tối thiểu | 21.1.65 |
| Java | Java 21 |
| Mod ID | guzhenren |
| Phiên bản metadata | 0.1 (bản test) |
File META-INF/mods.toml dành cho Forge 1.20.1 là metadata legacy còn sót từ MCreator. Code Java dùng net.neoforged.*; không cài bản này bằng Forge 1.20.1.
Dependency
neoforge.mods.toml đánh dấu các mod sau là tùy chọn:
- Pehkui.
- GeckoLib.
- Player Animator.
Tùy chọn trong metadata nghĩa là loader không bắt buộc chúng để qua bước kiểm tra dependency. Một số model, animation hoặc tính năng tương thích vẫn có thể hiển thị khác nếu thiếu mod hỗ trợ.
Cách cài
- Cài Java 21.
- Tạo profile Minecraft 1.21.1 với NeoForge 21.1.65 trở lên.
- Chép JAR
guzhenrenvào thư mụcmodscủa profile. - Nếu dùng các dependency tùy chọn, chọn đúng bản tương thích Minecraft 1.21.1/NeoForge.
- Khởi động game và kiểm tra mod
guzhenrenxuất hiện trong danh sách mod.
Phạm vi và độ tin cậy của wiki
- Source decompile: phản ánh JAR bản test
0.1; được ưu tiên cho registry ID, công thức JSON, slot GUI, biến và điều kiện code. - Tutorial cộng đồng: có thông tin của nhiều bản mới hơn; hữu ích cho chiến thuật nhưng có thể khác JAR đang phân tích.
- Khi hai nguồn mâu thuẫn, tài liệu phải ghi rõ “bản decompile” hoặc “theo tutorial”, không tự trộn số liệu.
- CFR 0.152 đánh dấu một số procedure là
Unable to fully structure code; các công thức trích từ những file này cần coi là dữ liệu đối chiếu, không phải bảo đảm tuyệt đối cho bản mod mới.
Lỗi thường gặp
| Hiện tượng | Kiểm tra |
|---|---|
| Game báo sai loader | Đang dùng Forge/Fabric thay vì NeoForge 1.21.1 |
| Báo sai Java | Chuyển runtime sang Java 21 |
| Không vào được server | Client và server phải có cùng JAR, loader và dependency cần thiết |
| Model/animation bất thường | Thử cài đúng bản GeckoLib/Player Animator mà modpack sử dụng |
| Wiki khác hành vi trong game | Xác định phiên bản JAR; tutorial có thể mô tả bản mới hơn metadata 0.1 |
