Cara Membuat Mod Factorio: Menambahkan Item, Resep, dan Nama Menggunakan Lua

Di Factorio 2.0, kita akan menambahkan item latihan tm-practice-plate yang dibuat dari dua plat besi. Ini adalah contoh pembuatan langsung prototipe item, resep kerajinan, dan lokal untuk dibaca ke dalam folder mod. Ini didasarkan pada mod dasar yang tidak bergantung pada aset Space Age dan menggunakan peta uji terpisah alih-alih penyimpanan pabrik yang sudah ada.

1. Menyiapkan Folder Mod dan File

Folder tempat file yang dapat dieksekusi berada dan folder data pengguna di Factorio mungkin berbeda. Temukan folder mods di lokasi data pengguna pada dokumentasi resmi. Instalasi Windows umum menggunakan %APPDATA%/Factorio/mods, tetapi konfigurasi portabel dan khusus berbeda. Cadangkan file penyimpanan dan pengaturan mod yang ada, lalu buat folder tm-practice_1.0.0.

tm-practice_1.0.0/
  info.json
  data.lua
  locale/
    en/strings.cfg
    ko/strings.cfg

2. Menyatakan Kompatibilitas di info.json

name adalah pengidentifikasi internal mod dan harus cocok dengan bagian depan nama folder. version harus cocok dengan _1.0.0 pada folder. factorio_version dikunci ke 2.0 agar tidak bingung dengan struktur untuk 1.1. Prototipe game dasar dapat digunakan karena kondisi base pada dependencies.

{
  "name": "tm-practice",
  "version": "1.0.0",
  "title": "TroubleMaker Practice Plate",
  "author": "TroubleMaker",
  "factorio_version": "2.0",
  "dependencies": ["base >= 2.0.0"],
  "description": "An original item and recipe tutorial."
}

3. Memasukkan Item dan Resep ke data.lua

Salin prototipe item dari plat besi default dan berikan nama baru serta ukuran tumpukan. Ikon merujuk pada jalur internal game dasar yang Anda miliki, sehingga gambar game tidak diduplikasi ke dalam ZIP. Bahan (ingredients) dan hasil (results) dari resep ditulis dalam format type/name/amount eksplisit Factorio 2.0. Tetapkan enabled=true agar dapat ditemukan di peta uji tanpa memerlukan pembukaan teknologi terpisah.

local plate = table.deepcopy(data.raw.item["iron-plate"])
plate.name = "tm-practice-plate"
plate.order = "a[tm-practice-plate]"
plate.stack_size = 100

data:extend({
  plate,
  {
    type = "recipe",
    name = "tm-practice-plate",
    enabled = true,
    energy_required = 1,
    ingredients = {
      {type = "item", name = "iron-plate", amount = 2}
    },
    results = {
      {type = "item", name = "tm-practice-plate", amount = 1}
    }
  }
})

4. Menambahkan Nama Tampilan dengan Lokal

Masukkan teks di bawah ini ke locale/ko/strings.cfg. Cocokkan nama prototipe secara persis di bagian item-name dan recipe-name. Jika string Lua dan kunci lokal berbeda, ID internal atau Unknown key mungkin akan ditampilkan.

[item-name]
tm-practice-plate=연습용 철판

[recipe-name]
tm-practice-plate=연습용 철판 제작

[item-description]
tm-practice-plate=모드 제작 학습용 아이템입니다.

Di locale/en/strings.cfg, masukkan frasa bahasa Inggris Anda sendiri seperti Practice plate, Make practice plate, An item for modding practice dengan struktur kunci yang sama. Simpan file sebagai UTF-8. Menyimpan .cfg sebagai format JSON tidak akan terbaca.

5. Mengaktifkan Mod dan Memverifikasi Pembuatan

1. Jalankan game dan aktifkan TroubleMaker Practice Plate di Mods.
2. Saat game dimulai ulang untuk membaca mod, pastikan tidak ada pesan kesalahan.
3. Mainkan di sandbox baru atau peta uji dan siapkan plat besi.
4. Temukan resep plat besi latihan di menu kerajinan dan pastikan 2 plat besi berubah menjadi 1 item.
5. Bandingkan apakah nama dan deskripsi muncul sebagai frase lokal masing-masing dalam pengaturan bahasa Korea dan Inggris.
6. Keluar sepenuhnya dari game, nonaktifkan mod, dan periksa konfigurasi default di peta uji terpisah.

6. Urutan Membaca Kesalahan

Ketika pemuatan mod berhenti, temukan kesalahan pertama di factorio-current.log. Periksa ejaan iron-plate dan dependensi base terlebih dahulu untuk kesalahan yang menyatakan prototipe tidak ada, dan format results serta ingredients untuk kesalahan resep. Jika mod tidak ada dalam daftar, periksa apakah jalur info.json berada di dalam dua lapisan folder. Ikonnya sama, jadi tidak apa-apa jika penampilannya mirip dengan plat besi default; itu bukan bug. Lebih mudah melakukan pengujian setelah langkah ini berhasil jika Anda menambahkan ikon Anda sendiri, pembukaan teknologi, dan keseimbangan.

7. Penghapusan dan Berbagi

Menghapus mod yang menambahkan item dapat menyebabkan item tersebut hilang dari penyimpanan. Jangan langsung mematikannya pada penyimpanan pabrik yang penting; periksa pada salinan yang dicadangkan. ZIP yang dibagikan harus dibuat agar hanya berisi satu folder tm-practice_1.0.0 dan mencocokkan name serta version. Nyatakan ketentuan saat diuji dengan mod lain, game 2.0 yang didukung, dan dependensi base yang digunakan. Setelah pembaruan game, periksa kembali tiga hal: pemuatan, pembuatan, dan tampilan nama, lalu tingkatkan versi distribusi.

Dokumentasi Asli dan Kriteria Verifikasi

Ini adalah panduan pengantar yang ditulis oleh tim operasional TroubleMaker dengan memeriksa pembuat dan dokumentasi alat resmi pada 7 Oktober 2026. Kode dan diagram adalah contoh buatan sendiri untuk penjelasan dan tidak memverifikasi permainan aktual dari game tersebut di server ini. Distribusikan setelah memeriksa dalam penyimpanan uji terpisah dengan versi yang ditentukan dalam teks utama. Bandingkan versi terbaru dan dependensi dari setiap alat dari sumber asli di bawah ini.

Factorio 2.0 모드 제작 튜토리얼

Factorio locale 공식 문서

Factorio recipe prototype

Factorio 모딩 문서