Cara Membuat Mod Terraria: Menambahkan Item dan Resep Crafting dengan tModLoader

Berdasarkan alur pengembangan versi stabil tModLoader Terraria 1.4.4, kita akan membuat token latihan yang terbuat dari 10 kayu. Anda akan mempelajari peran C# ModItem, tekstur PNG, dan CreateRecipe. Pastikan untuk menyiapkan lingkungan yang hanya menjalankan Terraria dasar secara terpisah dari dunia mod dan karakter tModLoader.

1. Persiapan dan Verifikasi Versi

Instal Terraria asli dan tModLoader asli, lalu jalankan pada cabang stabil yang sama. Periksa Basic Prerequisites dan persyaratan .NET SDK dari wiki pengembang. Panduan dasar saat ini menggunakan .NET 8.0 SDK dan Desktop Runtime saja tidak dapat menggantikan alat pengembangan. Jangan mencampur field item atau ModRecipe dari contoh 1.3 yang lama ke dalam kode terbaru. Buat karakter pengujian baru setelah membuat cadangan karakter, dunia, dan mod yang sudah ada.

2. Membuat Kerangka Mod di Dalam Game

1. Di menu utama tModLoader, pilih Workshop → Develop Mods → Create Mod.
2. Untuk ModName internal, gunakan nama unik tanpa spasi seperti TroubleMakerToken.
3. Masukkan nama tampilan (display name), pembuat, dan nama item dasar. Nama item dasar contoh ditentukan sebagai WorkshopToken.
4. Setelah dibuat, buka folder ModSources yang sebenarnya dari Open Sources di Develop Mods.
5. Buka .csproj yang dihasilkan dari folder TroubleMakerToken di IDE dan tunggu dependensi yang diperlukan diimpor.
6. Pada awalnya, jalankan Build + Reload sekali dengan status asli generator untuk memeriksa lingkungan pengembangan terlebih dahulu.

3. Mengubah Kelas Item

Ganti Content/Items/WorkshopToken.cs dengan struktur di bawah ini. Jika generator menggunakan jalur atau namespace yang berbeda, sesuaikan nama tersebut dan pastikan tidak ada dua kelas yang sama yang dibuat. ModItem mendefinisikan perilaku item baru dan SetDefaults mengatur ukuran, tumpukan maksimum (max stack), kelangkaan (rarity), dll.

using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace TroubleMakerToken.Content.Items;

public class WorkshopToken : ModItem
{
    public override void SetDefaults()
    {
        Item.width = 20;
        Item.height = 20;
        Item.maxStack = 9999;
        Item.value = Item.buyPrice(silver: 1);
        Item.rare = ItemRarityID.White;
    }

    public override void AddRecipes()
    {
        CreateRecipe()
            .AddIngredient(ItemID.Wood, 10)
            .AddTile(TileID.WorkBenches)
            .Register();
    }
}

4. Memasukkan PNG dan Teks Tampilan

Letakkan WorkshopToken.png di folder Content/Items yang sama. Ubah gambar latihan yang disertakan dalam generator atau gunakan PNG latar belakang transparan yang Anda gambar sendiri. Huruf besar/kecil nama file dan jalurnya harus cocok dengan nama kelas. Ukuran 20×20 adalah pengaturan tabrakan dan tampilan item, yang tidak berarti semua dimensi gambar asli harus sebesar angka tersebut. Contoh pertama akan lebih mudah memeriksa penjajarannya jika dimulai dengan gambar kotak kecil.

TroubleMakerToken/
  TroubleMakerToken.cs
  Content/Items/WorkshopToken.cs
  Content/Items/WorkshopToken.png
  Localization/en-US_Mods.TroubleMakerToken.hjson

tModLoader modern mengelola nama tampilan dan deskripsi dalam lokalisasi HJSON. Masukkan entri Items di bawah ini ke dalam file Lokalisasi yang dihasilkan atau ubah kunci yang sudah ada. Jangan menduplikasi root Mods yang sama di seluruh file, tetapi edit berdasarkan struktur generator.

Mods: {
  TroubleMakerToken: {
    Items: {
      WorkshopToken: {
        DisplayName: Workshop Token
        Tooltip: A token for learning how to create a mod.
      }
    }
  }
}

5. Membangun dan Mencobanya Secara Langsung

1. Simpan kode yang diubah dan jalankan Build + Reload dari Develop Mods.
2. Jika terjadi kesalahan, periksa nama file dan nomor baris dari kesalahan kompilasi pertama terlebih dahulu.
3. Periksa apakah mod Anda aktif di daftar mod dan masuk ke dunia pengujian baru.
4. Siapkan 10 kayu dan Work Bench, lalu buka menu crafting di sebelah Work Bench.
5. Buat (craft) Workshop Token dan periksa konsumsi kayu, tumpukan item, nama, dan deskripsinya.
6. Jika tekstur tidak terlihat, periksa jalur aktual dan huruf besar/kecil dari PNG, lalu jalankan Build + Reload lagi.

6. Kegagalan dan Solusi Paling Umum

Jika resep tidak terlihat, periksa apakah Anda berada di dekat work bench dan apakah Anda memasukkan ItemID.Wood serta TileID.WorkBenches dengan benar. Jika Anda mengubah namespace, bersihkan kelas duplikat dan sesuaikan jalur gambar juga. Mematikan mod akan membaca penyimpanan tanpa item mod, jadi jangan langsung menerapkannya pada penyimpanan permainan yang sebenarnya. Keluar dari game, nonaktifkan mod, dan bandingkan dengan dunia pengujian terpisah yang dicadangkan.

7. Pemeriksaan Sebelum Berbagi ke Workshop

Jelaskan keunikan ModName internal, versi stabil, bahan crafting dan persyaratan work bench, serta sumber gambar asli. Fitur Publish tModLoader adalah unggahan publik yang sebenarnya, jadi atur ZIP distribusi, README, dan hasil pengujian terlebih dahulu sebelum menggunakannya. Panduan ini menjelaskan proses pembuatan dan tidak mengunggah secara otomatis ke akun pembaca. Saat memodifikasi dan berbagi aset game dan mod item milik orang lain, ikuti izin dan ketentuan pembuat tersebut.

Dokumen Asli dan Kriteria Verifikasi

Panduan pengantar yang ditulis oleh tim manajemen TroubleMaker dengan memeriksa pembuat dan dokumentasi alat resmi pada 7 Oktober 2026. Kode dan diagram adalah contoh buatan sendiri untuk penjelasan dan bukan hasil verifikasi permainan aktual dari game tersebut di server ini. Distribusikan setelah memeriksa dalam penyimpanan pengujian terpisah dengan versi yang ditentukan dalam teks. Bandingkan versi terbaru dan dependensi per alat dari sumber asli di bawah ini.

tModLoader 기본 제작 가이드

tModLoader 제작 준비

tModLoader 자체 예제 모음

tModLoader 번역·표시 문구