Paano Gumawa ng Minecraft Mod: Mula Fabric Project, Java Code, hanggang JAR Build

Ang gabay na ito ay lumilikha ng mod na nag-output ng log sa unang pagtakbo batay sa Minecraft Java Edition 26.2 at Fabric. Ito ay isang beginner's example na sinusundan hanggang sa punto kung saan nakikilala ng loader ang mod file at naisasagawa ang Java code na isinulat mo. Ang mga Bedrock add-on, Forge, at NeoForge project ay may ibang istruktura, kaya huwag silang pagsasamahin sa isang project.

1. Paghahanda ng Development Environment

Inirerekomenda ng kasalukuyang 26.2 documentation ng Fabric ang JDK 25. Sa halip na i-install lamang ang Java runtime environment, mag-install ng JDK para sa development at ihanda ang IntelliJ IDEA o VS Code. Suriin ang Java na aktwal na ginagamit gamit ang command sa ibaba sa terminal. Ang Project SDK at Gradle JVM ng IDE ay dapat ding tumuro sa parehong bersyon. Para sa paglikha ng mga lumang bersyon tulad ng 1.21.1, baguhin nang sabay ang pagpili ng bersyon sa itaas ng dokumentasyon at ang bersyon ng generator, at sundin ang mga kinakailangan sa JDK para sa bersyong iyon.

java -version
javac -version

2. Paggawa ng Project sa Fabric Generator

1. Buksan ang opisyal na Template Mod Generator ng Fabric.
2. Itakda ang Mod Name sa TroubleMaker Hello, Mod ID sa tmhello, at Package Name sa com.ascgame.tmhello.
3. Itugma ang bersyon ng Minecraft sa 26.2. Hindi na kailangang magdagdag ng mga advanced na opsyon tulad ng Kotlin o hiwalay na data generation sa unang halimbawa.
4. I-download ang ZIP at i-extract ito sa isang simpleng path tulad ng C:/Projects/TMHello. Ang project folder ay depende sa iyong aktwal na operating system.
5. Buksan ang build.gradle o ang project root sa IDE at maghintay hanggang matapos ang Gradle importing. Panatilihin ang mga bersyon ng Loader, Loom, at API na itinakda ng generator.

3. Pag-unawa sa Ginagawa ng mga File

Ang src/main/java ay para sa karaniwang Java code, ang src/main/resources/fabric.mod.json ay para sa mod ID, entry class, at dependency declarations, at ang gradle.properties ay para sa mga bersyon at project settings. Depende sa generator, ang client code ay maaaring nahahati sa src/client/java. Binabago lamang ng halimbawang ito ang karaniwang initialization code. Huwag kusang tanggalin ang lahat ng setting file o i-overwrite ang mga setting ng ibang bersyon mula sa internet.

4. Pagsulat ng Aking Initialization Class

Hanapin ang nagawang karaniwang ModInitializer implementation file at baguhin ito sa sumusunod na istruktura. Kung pinalitan mo ang pangalan ng file ng TMHello.java, itugma rin ang package folder at pangalan ng klase. Dahil gumagamit ito ng mga log ng SLF4J, maaari mong suriin kung naganap ang initialization nang walang item registration API na madaling magbago sa iba't ibang bersyon ng laro.

package com.ascgame.tmhello;

import net.fabricmc.api.ModInitializer;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class TMHello implements ModInitializer {
    public static final String MOD_ID = "tmhello";
    private static final Logger LOG = LoggerFactory.getLogger(MOD_ID);

    @Override
    public void onInitialize() {
        LOG.info("TroubleMaker: my first Fabric mod is ready.");
    }
}

Habang pinapanatili ang iba pang nilalaman ng fabric.mod.json, suriin kung tinutukoy ng entrypoints.main ang buong pangalan ng klase sa itaas. Ang nasa ibaba ay hindi ang buong file kundi ang bahaging susuriin. Huwag palitan ang mga umiiral nang mixin o setting ng client nang buo.

{
  "entrypoints": {
    "main": ["com.ascgame.tmhello.TMHello"]
  }
}

5. Development Run at Final File Build

1. Mula sa project root, patakbuhin ang gradlew.bat runClient para sa Windows, o ./gradlew runClient para sa macOS/Linux.
2. Hanapin ang pariralang TroubleMaker sa development client console o sa run/logs/latest.log. Ito ay isang halimbawa na lumalabas nang isang beses sa panahon ng initialization bago pumasok sa mundo.
3. Lumabas sa laro at lumikha ng deployment file gamit ang gradlew.bat build para sa Windows, o ./gradlew build para sa macOS/Linux.
4. Suriin ang pangkalahatang distribution JAR sa build/libs. Huwag gumamit ng mga development file na may sapat na sources o dev sa pangalan bilang pangkalahatang distribution.
5. Ilagay ang JAR sa mods folder ng hiwalay na Fabric instance ng parehong bersyon ng Minecraft. Kung ang nabuong dependency ay may kasamang Fabric API, i-install ito ayon sa parehong bersyon.
6. Patakbuhin gamit ang aktwal na launcher at suriin kung ang parehong parirala ay naka-print sa logs/latest.log ng instance.

6. Mga Karaniwang Error at Pagbawi

Para sa Unsupported class file version, suriin muna ang bersyon ng Java; para sa entry class loading error, suriin ang hindi pagkakatugma ng package, pangalan ng klase, at mga entrypoint. Kung tahimik ito pagkatapos ilagay sa mods folder, suriin din kung inilagay mo ito sa ibang instance ng launcher. Ang halimbawang ito ay hindi nagdaragdag ng save data, kaya maaari mong lumabas sa laro at alisin ang JAR para ihambing. Kapag nagdadagdag ng mga item o bloke sa hinaharap, basahin ang dokumentong Fabric First Item ng target na bersyon at iangkop ang file path at registration API sa bersyong iyon.

7. Impormasyong Isasama Kapag Ibinabahagi

Isulat sa README ang Mod ID, sinusuportahang bersyon ng Minecraft, mga kundisyon ng Loader at Fabric API, mga kinakailangan sa JDK, mga tampok ng halimbawa, at kung paano ito alisin. Paghiwalayin ang pinagmulan ng code at ang distribution JAR, at huwag isama ang pangunahing laro o mga mod file ng ibang lumikha. Ipamahagi ang paunang bersyon na may bersyon tulad ng 1.0.0 pagkatapos kumpirmahin na ang log ay aktwal na lumalabas sa pangkalahatang launcher.

Orihinal na Dokumento at Pamantayan sa Pag-verify

Ito ay isang gabay para sa nagsisimula na isinulat ng koponan ng operasyon ng TroubleMaker noong Oktubre 7, 2026, matapos suriin ang lumikha at opisyal na mga dokumento ng tool. Ang code at mga diagram ay aming sariling mga halimbawa para sa pagpapaliwanag at hindi mga resulta ng pag-verify ng aktwal na paglalaro ng laro sa server na ito. Mangyaring i-verify ito sa isang hiwalay na test save gamit ang bersyong tinukoy sa teksto bago ipamahagi. Ihambing ang mga pinakabagong bersyon at dependency ng bawat tool mula sa mga orihinal sa ibaba.

Fabric 개발 환경

Fabric 프로젝트 생성

Fabric 모드 빌드

Fabric 공식 생성기