ข้ามไปที่เนื้อหา
แพลตฟอร์ม

ม็อด Fabric

ม็อด Fabric กับ Codexe สิ่งที่ควรใส่ในคำขอ เวอร์ชัน Minecraft และตัวโหลด การบิลด์ Gradle/Loom ทำงานอย่างไร (Java 21 สำหรับเป้าหมาย 1.20.1) mixin และปัญหาที่พบบ่อย

อัปเดตเมื่อ

ในหน้านี้
  1. สิ่งที่ควรใส่ในคำขอ
  2. สิ่งที่ Codexe สร้างให้
  3. การบิลด์ทำงานอย่างไร
  4. การตรวจสอบ
  5. ปัญหาที่พบบ่อย

Fabric คือตัวโหลดม็อดน้ำหนักเบาที่มักรองรับ Minecraft เวอร์ชันใหม่ได้เร็ว Codexe สร้างโปรเจกต์ Gradle ครบชุดโดยใช้ปลั๊กอิน Loom ของ Fabric

#สิ่งที่ควรใส่ในคำขอ

  • เวอร์ชัน Minecraft: "Fabric สำหรับ 1.20.1", "1.21.1" ถ้าไม่ระบุ จะใช้ 1.20.1
  • ม็อดเพิ่มอะไร: บล็อก ไอเทม เอนทิตี คำสั่ง ปุ่มลัด องค์ประกอบ HUD อธิบายการทำงานให้ละเอียด
  • ฝั่งไคลเอนต์หรือเซิร์ฟเวอร์: บอกว่าเป็นแบบไคลเอนต์อย่างเดียว (HUD ปุ่มลัด) เซิร์ฟเวอร์อย่างเดียว หรือทั้งสองฝั่ง
  • Dependency: มี Fabric API ให้อยู่แล้ว ระบุชื่อตัวอื่นๆ ด้วย (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 สร้างให้

  • build.gradle, gradle.properties (เวอร์ชันของ Minecraft, Yarn, ตัวโหลด และ Fabric API) และ settings.gradle
  • fabric.mod.json ที่แยก entrypoint ตามสภาพแวดล้อม (main, client)
  • การตั้งค่าและคลาส mixin เมื่อฟีเจอร์ต้องใช้
  • asset ได้แก่ ไฟล์ภาษา โมเดล และเท็กซ์เจอร์ชั่วคราว

#การบิลด์ทำงานอย่างไร

  • Codexe ล็อก Loom รุ่นเสถียรไว้ (เวอร์ชัน -SNAPSHOT เก่าๆ จะหายไปจากที่เก็บของ Fabric และทำให้บิลด์พัง)
  • ถ้าเวอร์ชันตัวโหลด Yarn หรือ Fabric API ที่ขอไม่มีอยู่จริง Codexe จะแทนที่ด้วยเวอร์ชันที่มีจริงสำหรับเวอร์ชัน Minecraft นั้น
  • Loom ต้องใช้ Java 21 ในการรัน Gradle สำหรับม็อด 1.20.1 (ซึ่งเป้าหมายคือ Java 17) Codexe จะรัน Gradle บน Java 21 แต่ม็อดของคุณยังคอมไพล์สำหรับ Java 17 JAR จึงใช้บนเซิร์ฟเวอร์ Java 17 ได้

การบิลด์ม็อดครั้งแรกใช้เวลานานกว่า (มักจะหลายนาที) เพราะ Loom ต้องดาวน์โหลด Minecraft และ mapping การบิลด์ม็อดจะหยุดหลัง 10 นาที

#การตรวจสอบ

ม็อดจะถูกคอมไพล์ก่อนจะพร้อม และ JAR ต้องมี fabric.mod.json (หรือ quilt.mod.json) การคอมไพล์พิสูจน์ว่าบิลด์ผ่าน ไม่ได้พิสูจน์ว่ารันได้โดยไม่แครช จึงควรทดสอบในไคลเอนต์

#ปัญหาที่พบบ่อย

อาการสาเหตุที่น่าจะเป็น
แครชบนเซิร์ฟเวอร์เฉพาะ (dedicated server) โดยพูดถึงคลาสฝั่งไคลเอนต์มีโค้ดฝั่งไคลเอนต์อยู่ใน entrypoint main ขอให้แชตย้ายไปไว้ใน entrypoint client
"Incompatible mods found" เวอร์ชัน Minecraft ไม่ตรงม็อดทำไว้สำหรับเวอร์ชัน Minecraft ที่ต่างจากเกมของคุณ ระบุเวอร์ชันให้ตรง
ไม่มี Fabric API ตอนรันติดตั้ง Fabric API ไว้ใน mods/ คู่กับม็อด
ม็อด Fabric | Codexe Docs