Chuyển đến nội dung
Nền tảng

Mod Fabric

Mod Fabric với Codexe: những gì nên ghi trong yêu cầu, phiên bản Minecraft và loader, cách bản build Gradle/Loom hoạt động (Java 21 cho đích 1.20.1), mixin và các sự cố thường gặp.

Đã cập nhật

Trên trang này
  1. Nên ghi gì trong yêu cầu
  2. Codexe tạo ra gì
  3. Bản build hoạt động thế nào
  4. Xác minh
  5. Sự cố thường gặp

Fabric là một mod loader gọn nhẹ, thường hỗ trợ các phiên bản Minecraft mới rất nhanh. Codexe tạo một dự án Gradle hoàn chỉnh dùng plugin Loom của Fabric.

#Nên ghi gì trong yêu cầu

  • Phiên bản Minecraft: "Fabric cho 1.20.1", "1.21.1". Nếu không ghi, 1.20.1 sẽ được dùng.
  • Những gì mod thêm vào: khối, vật phẩm, thực thể, lệnh, phím tắt, thành phần HUD. Hãy mô tả hành vi thật chính xác.
  • Client hay máy chủ: nói rõ mod chỉ chạy ở client (HUD, phím tắt), chỉ ở máy chủ, hay cả hai.
  • Phụ thuộc: Fabric API đã được bao gồm. Hãy nêu tên các phụ thuộc khác (Cloth Config, Mod Menu…).
Text
A Fabric mod for 1.21.1: a "Magnet" item that pulls nearby dropped items to the player within 8 blocks while held in the offhand. Toggle with a keybind (default M). Crafting: iron ingots around a redstone block. English lang file and item model.

#Codexe tạo ra gì

  • build.gradle, gradle.properties (phiên bản Minecraft, Yarn, loader và Fabric API) và settings.gradle.
  • fabric.mod.json với các entrypoint chia theo môi trường (main, client).
  • Cấu hình và các lớp mixin khi tính năng cần đến.
  • Tài nguyên: tệp ngôn ngữ, model, texture tạm thời.

#Bản build hoạt động thế nào

  • Codexe cố định một bản phát hành Loom ổn định (các phiên bản -SNAPSHOT cũ biến mất khỏi kho của Fabric và làm hỏng bản build).
  • Nếu phiên bản loader, Yarn hoặc Fabric API được yêu cầu không tồn tại, Codexe thay bằng một phiên bản có thật cho phiên bản Minecraft đó.
  • Loom cần môi trường chạy Java 21 để chạy Gradle. Với một mod 1.20.1 (nhắm tới Java 17), Codexe chạy Gradle trên Java 21 trong khi mod của bạn vẫn được biên dịch cho Java 17. Tệp JAR chạy được trên máy chủ Java 17.

Bản build mod đầu tiên mất nhiều thời gian hơn (thường vài phút): Loom tải Minecraft và các mapping. Bản build mod dừng sau 10 phút.

#Xác minh

Mod được biên dịch trước khi Sẵn sàng, và tệp JAR phải chứa fabric.mod.json (hoặc quilt.mod.json). Việc biên dịch chứng minh mod build được, không chứng minh nó chạy mà không bị crash, nên hãy thử nó trong một client.

#Sự cố thường gặp

Triệu chứngNguyên nhân có thể
Crash trên máy chủ chuyên dụng, nhắc đến các lớp clientCode chỉ dành cho client nằm trong entrypoint main. Hãy nhờ khung chat chuyển nó sang entrypoint client.
"Incompatible mods found", sai phiên bản MinecraftMod nhắm tới một phiên bản Minecraft khác với game của bạn. Hãy ghi chính xác phiên bản.
Thiếu Fabric API khi chạyCài Fabric API vào mods/ cùng với mod.
Mod Fabric | Codexe Docs