Paano Gumawa ng Factorio Mod: Pagdaragdag ng mga Item, Recipe, at Pangalan gamit ang Lua

Sa Factorio 2.0, nagdaragdag kami ng item na pang-ensayo na tm-practice-plate na ginawa mula sa dalawang iron plate. Ito ay isang halimbawa ng direktang paglikha ng isang item prototype, crafting recipe, at locale upang basahin sa mod folder. Ito ay batay sa base mod na hindi umaasa sa mga asset ng Space Age at gumagamit ng hiwalay na test map sa halip na isang umiiral na factory save.

1. Paghahanda ng Mod Folder at mga File

Maaaring magkaiba ang folder kung nasaan ang executable file at ang folder ng user data sa Factorio. Hanapin ang folder na mods sa lokasyon ng user data sa opisyal na dokumentasyon. Karaniwang ginagamit ng mga pag-install sa Windows ang %APPDATA%/Factorio/mods, ngunit nag-iiba ang mga portable at custom na configuration. I-backup ang mga save file at umiiral na setting ng mod, pagkatapos ay gawin ang folder na tm-practice_1.0.0.

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

2. Pagdedeklara ng Compatibility sa info.json

Ang name ay ang panloob na identifier ng mod at dapat tumugma sa unang bahagi ng pangalan ng folder. Ang version ay dapat tumugma sa _1.0.0 ng folder. Ang factorio_version ay naka-lock sa 2.0 upang maiwasan ang pagkalito sa mga istruktura para sa 1.1. Dahil sa base condition sa dependencies, magagamit ang default game prototype.

{
  "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. Paglalagay ng mga Item at Recipe sa data.lua

Kopyahin ang item prototype ng default iron plate at bigyan ito ng bagong pangalan at stack size. Sinasalamin ng icon ang panloob na landas ng base game na mayroon ka, kaya ang mga imahe ng laro ay hindi kino-duplicate sa ZIP. Ang ingredients at results ng recipe ay isinusulat sa tahasang uri/pangalan/halaga (type/name/amount) na format ng Factorio 2.0. Itakda ang enabled=true upang mahanap ito sa test map nang hindi nangangailangan ng hiwalay na pag-unlock ng teknolohiya.

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. Paglalagay ng Display Name gamit ang Locale

Ilagay ang sumusunod na teksto sa locale/ko/strings.cfg. Tiyaking eksaktong tumutugma ang mga pangalan ng prototype sa mga seksyong item-name at recipe-name. Kung magkaiba ang Lua string at locale key, maaaring lumabas ang panloob na ID o Unknown key.

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

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

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

Sa locale/en/strings.cfg, maglagay ng mga sariling pariralang Ingles tulad ng Practice plate, Make practice plate, An item for modding practice na may parehong istruktura ng key. I-save ang file bilang UTF-8. Ang pag-save ng .cfg bilang JSON ay hindi magbabasa nito.

5. Pag-on sa Mod at Pag-verify ng Crafting

1. Patakbuhin ang laro at i-enable ang TroubleMaker Practice Plate sa Mods.
2. Kapag nag-restart ang laro upang basahin ang mod, tiyaking walang mga mensahe ng error.
3. Maglaro sa isang bagong sandbox o test map at ihanda ang mga iron plate.
4. Hanapin ang recipe ng practice iron plate sa crafting menu at kumpirmahing ang 2 iron plate ay nagiging 1 item.
5. Ihambing kung ang pangalan at paglalarawan ay lumalabas bilang kaukulang mga parirala ng locale sa mga setting ng Koreano at Ingles.
6. Tuluyang lumabas sa laro, i-disable ang mod, at suriin ang default configuration sa isang hiwalay na test map.

6. Ang Pagkakasunod-sunod ng Pagbasa ng mga Error

Kapag tumigil ang pag-load ng mod, hanapin ang unang error sa factorio-current.log. Suriin muna ang pagbaybay ng iron-plate at ang base dependency para sa isang error na nagsasabing nawawala ang prototype, at ang format ng results at ingredients para sa error sa recipe. Kung ang mod ay wala sa listahan, suriin kung ang landas ng info.json ay nasa loob ng dalawang patong ng folder. Pareho ang icon, kaya hindi ito bug kung ang hitsura ay kapareho ng default iron plate. Mas madaling subukan pagkatapos maging matagumpay ang hakbang na ito kung magdaragdag ka ng iyong sariling icon, pag-unlock ng teknolohiya, at balanse.

7. Pagtanggal at Pagbabahagi

Ang pag-alis ng isang mod na nagdagdag ng mga item ay maaaring maging sanhi ng pagkawala ng mga item na iyon sa save. Huwag itong direktang i-off sa isang mahalagang factory save; suriin ito sa isang naka-backup na kopya. Ang naibahaging ZIP ay dapat maglaman lamang ng isang tm-practice_1.0.0 folder at tumugma sa pangalan at bersyon nito. Tukuyin ang mga kundisyon kung saan ito nasubukan sa iba pang mga mod, ang suportadong laro 2.0, at ang ginamit na base dependency. Pagkatapos ng pag-update ng laro, suriin muli ang tatlong bagay: pag-load, crafting, at pagpapakita ng pangalan, at i-upgrade ang bersyon ng pamamahagi.

Orihinal na Dokumentasyon at Pamantayan sa Pag-verify

Ito ay isang panimulang gabay na isinulat ng koponan ng pagpapatakbo ng TroubleMaker sa pamamagitan ng pagsusuri sa lumikha at opisyal na dokumentasyon ng tool noong Oktubre 7, 2026. Ang code at mga diagram ay mga sariling halimbawa para sa paliwanag at hindi nagpapatunay sa aktwal na paglalaro ng naturang laro sa server na ito. Ipamahagi pagkatapos suriin sa isang hiwalay na test save gamit ang bersyon na tinukoy sa pangunahing teksto. Ihambing ang mga pinakabagong bersyon at dependency ng bawat tool mula sa mga orihinal na pinagmulan sa ibaba.

Factorio 2.0 모드 제작 튜토리얼

Factorio locale 공식 문서

Factorio recipe prototype

Factorio 모딩 문서