Cara Membuat Mod Minecraft: Dari Proyek Fabric, Kode Java, hingga Build JAR

Panduan ini membuat mod yang mencetak log pada saat dijalankan pertama kali berdasarkan Minecraft Java Edition 26.2 dan Fabric. Ini adalah contoh tingkat pemula yang mengikuti hingga titik di mana file mod dikenali oleh loader dan kode Java yang Anda tulis dieksekusi. Add-on Bedrock, serta proyek Forge dan NeoForge memiliki struktur yang berbeda, jadi jangan mencampurnya dalam satu proyek.

1. Menyiapkan Lingkungan Pengembangan

Dokumentasi Fabric 26.2 saat ini menyarankan JDK 25. Daripada hanya menginstal lingkungan runtime Java, instal JDK untuk pengembangan dan siapkan IntelliJ IDEA atau VS Code. Periksa Java yang sedang digunakan dengan perintah di bawah ini di terminal. SDK Proyek dan JVM Gradle IDE juga harus menunjuk ke versi yang sama. Untuk membuat versi lama seperti 1.21.1, ubah pemilihan versi di bagian atas dokumentasi dan versi generator secara bersamaan, serta ikuti persyaratan JDK untuk versi tersebut.

java -version
javac -version

2. Membuat Proyek di Generator Fabric

1. Buka Template Mod Generator resmi Fabric.
2. Atur Mod Name ke TroubleMaker Hello, Mod ID ke tmhello, dan Package Name ke com.ascgame.tmhello.
3. Sesuaikan versi Minecraft ke 26.2. Opsi lanjutan seperti Kotlin atau pembuatan data terpisah tidak perlu ditambahkan pada contoh pertama.
4. Unduh ZIP dan ekstrak ke jalur sederhana seperti C:/Projects/TMHello. Folder proyek ditentukan sesuai dengan sistem operasi Anda sebenarnya.
5. Buka build.gradle atau root proyek di IDE dan tunggu hingga pengimporan Gradle selesai. Pertahankan versi Loader, Loom, dan API yang ditentukan oleh generator.

3. Memahami Fungsi File

src/main/java adalah untuk kode Java umum, src/main/resources/fabric.mod.json adalah untuk ID mod, kelas entri, dan deklarasi dependensi, serta gradle.properties adalah untuk versi dan pengaturan proyek. Bergantung pada generator, kode klien dapat dibagi menjadi src/client/java. Contoh ini hanya mengubah kode inisialisasi umum. Jangan secara sewenang-wenang menghapus semua file pengaturan atau menimpa pengaturan versi lain dari internet.

4. Menulis Kelas Inisialisasi Saya

Temukan file implementasi ModInitializer umum yang dibuat dan ubah ke struktur berikut. Jika Anda mengubah nama file menjadi TMHello.java, sesuaikan juga folder paket dan nama kelasnya. Karena menggunakan log SLF4J, Anda dapat memeriksa apakah inisialisasi berhasil tanpa API pendaftaran item yang rentan berubah di versi game yang berbeda.

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.");
    }
}

Sambil mempertahankan konten lain dari fabric.mod.json, verifikasi bahwa entrypoints.main menunjuk ke nama lengkap kelas di atas. Bagian di bawah ini bukanlah seluruh file melainkan bagian yang harus diperiksa. Jangan mengganti mixins atau pengaturan klien yang ada secara keseluruhan.

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

5. Menjalankan Pengembangan dan Build File Akhir

1. Dari root proyek, jalankan gradlew.bat runClient untuk Windows, atau ./gradlew runClient untuk macOS/Linux.
2. Cari frasa TroubleMaker di konsol klien pengembangan atau run/logs/latest.log. Ini adalah contoh yang dicetak sekali selama inisialisasi sebelum memasuki dunia.
3. Keluar dari game dan buat file distribusi menggunakan gradlew.bat build untuk Windows, atau ./gradlew build untuk macOS/Linux.
4. Periksa JAR distribusi umum di build/libs. Jangan gunakan file pengembangan yang memiliki akhiran sources atau dev di namanya sebagai distribusi umum.
5. Masukkan JAR ke dalam folder mods dari instance Fabric terpisah dengan versi Minecraft yang sama. Jika dependensi yang dihasilkan menyertakan Fabric API, instal sesuai dengan versi yang sama.
6. Jalankan dengan peluncur aktual dan verifikasi apakah frasa yang sama tercatat di logs/latest.log pada instance tersebut.

6. Kesalahan Umum dan Pemulihan

Untuk Unsupported class file version, periksa versi Java terlebih dahulu; untuk kesalahan pemuatan kelas entri, periksa ketidakcocokan antara paket, nama kelas, dan entrypoints. Jika tidak ada respons setelah dimasukkan ke folder mods, periksa juga apakah Anda memasukkannya ke instance peluncur yang berbeda. Contoh ini tidak menambahkan data penyimpanan, sehingga Anda dapat keluar dari game dan menghapus JAR untuk membandingkannya. Saat menambahkan item atau blok di masa mendatang, baca dokumen Fabric First Item dari versi target dan sesuaikan jalur file serta API pendaftaran dengan versi tersebut.

7. Informasi yang Disertakan Saat Berbagi

Cantumkan Mod ID, versi Minecraft yang didukung, kondisi Loader dan Fabric API, persyaratan JDK, fitur contoh, dan cara menghapusnya di README. Pisahkan sumber kode dan JAR distribusi, serta jangan sertakan file game utama atau mod pembuat lain. Distribusikan versi awal dengan versi seperti 1.0.0 setelah memastikan bahwa log dicetak di peluncur umum yang sebenarnya.

Dokumen Asli dan Kriteria Verifikasi

Ini adalah panduan pemula yang ditulis oleh tim operasi TroubleMaker pada 7 Oktober 2026, setelah memeriksa pembuat dan dokumen alat resmi. Kode dan diagram adalah contoh kami sendiri untuk penjelasan dan bukan hasil verifikasi permainan aktual dari game ini di server ini. Harap verifikasi dengan versi yang ditentukan dalam teks pada simpanan pengujian terpisah sebelum mendistribusikannya. Bandingkan versi terbaru dan dependensi dari setiap alat dari sumber asli di bawah ini.

Fabric 개발 환경

Fabric 프로젝트 생성

Fabric 모드 빌드

Fabric 공식 생성기