Cách tạo bản mod Factorio: Thêm vật phẩm, công thức và tên bằng Lua

Trong Factorio 2.0, chúng ta sẽ thêm một vật phẩm luyện tập tm-practice-plate được làm từ hai tấm sắt. Đây là một ví dụ về việc trực tiếp tạo bản mẫu vật phẩm (prototype), công thức chế tạo và ngôn ngữ (locale) để đọc vào thư mục mod. Nó dựa trên bản mod gốc không phụ thuộc vào tài sản Space Age và sử dụng một bản đồ kiểm tra riêng biệt thay vì bản lưu nhà máy hiện có.

1. Chuẩn bị thư mục và tệp mod

Thư mục chứa tệp thực thi và thư mục dữ liệu người dùng trong Factorio có thể khác nhau. Tìm thư mục mods tại vị trí dữ liệu người dùng trong tài liệu chính thức. Cài đặt Windows thông thường sử dụng %APPDATA%/Factorio/mods, nhưng cấu hình di động và tùy chỉnh sẽ khác. Hãy sao lưu các tệp lưu và cài đặt mod hiện có, sau đó tạo thư mục tm-practice_1.0.0.

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

2. Khai báo khả năng tương thích trong info.json

name là định danh nội bộ của bản mod và phải khớp với phần đầu của tên thư mục. version phải khớp với _1.0.0 của thư mục. factorio_version được cố định ở 2.0 để tránh nhầm lẫn với cấu trúc cho 1.1. Bản mẫu trò chơi gốc có thể được sử dụng do điều kiện base trong 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. Thêm vật phẩm và công thức vào data.lua

Sao chép bản mẫu vật phẩm của tấm sắt mặc định và đặt cho nó một tên mới cùng kích thước chồng (stack size). Biểu tượng tham chiếu đường dẫn nội bộ của trò chơi gốc mà bạn có, vì vậy hình ảnh trò chơi không bị trùng lặp vào tệp ZIP. Các thành phần (ingredients) và kết quả (results) của công thức được viết theo định dạng type/name/amount rõ ràng của Factorio 2.0. Đặt enabled=true để có thể tìm thấy nó trên bản đồ kiểm tra mà không cần mở khóa công nghệ riêng biệt.

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. Thêm tên hiển thị bằng tệp ngôn ngữ

Đặt văn bản dưới đây vào locale/ko/strings.cfg. Khớp chính xác tên bản mẫu trong các phần item-name và recipe-name. Nếu chuỗi Lua và khóa ngôn ngữ khác nhau, ID nội bộ hoặc Unknown key có thể được hiển thị.

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

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

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

Trong locale/en/strings.cfg, hãy đặt các cụm từ tiếng Anh của riêng bạn như Practice plate, Make practice plate, An item for modding practice với cấu trúc khóa tương tự. Lưu tệp dưới dạng UTF-8. Lưu tệp .cfg dưới dạng JSON sẽ không đọc được.

5. Bật bản mod và xác minh quá trình chế tạo

1. Chạy trò chơi và bật TroubleMaker Practice Plate trong mục Mods.
2. Khi trò chơi khởi động lại để đọc bản mod, hãy đảm bảo không có thông báo lỗi nào.
3. Chơi trong một bản sandbox mới hoặc bản đồ kiểm tra và chuẩn bị các tấm sắt.
4. Tìm công thức tấm sắt luyện tập trong menu chế tạo và xác nhận rằng 2 tấm sắt biến thành 1 vật phẩm.
5. So sánh xem tên và mô tả có hiển thị dưới dạng các cụm từ ngôn ngữ tương ứng trong cài đặt tiếng Hàn và tiếng Anh hay không.
6. Thoát hoàn toàn trò chơi, tắt bản mod và kiểm tra cấu hình mặc định trong một bản đồ kiểm tra riêng biệt.

6. Thứ tự đọc lỗi

Khi quá trình tải mod dừng lại, hãy tìm lỗi đầu tiên trong factorio-current.log. Kiểm tra lỗi chính tả iron-plate và phần phụ thuộc base trước đối với lỗi cho biết thiếu bản mẫu, và định dạng results cùng ingredients đối với lỗi công thức. Nếu bản mod không có trong danh sách, hãy kiểm tra xem đường dẫn info.json có nằm bên trong hai lớp thư mục hay không. Biểu tượng là giống nhau, vì vậy việc ngoại hình giống với tấm sắt mặc định không phải là lỗi (bug). Sẽ dễ dàng hơn để kiểm tra sau khi bước này thành công nếu bạn thêm biểu tượng của riêng mình, mở khóa công nghệ và cân bằng.

7. Gỡ bỏ và chia sẻ

Gỡ bỏ bản mod đã thêm vật phẩm có thể làm cho các vật phẩm đó biến mất khỏi tệp lưu. Đừng tắt nó ngay lập tức trên tệp lưu nhà máy quan trọng; hãy kiểm tra trên bản sao lưu. Tệp ZIP được chia sẻ phải được tạo để chỉ chứa một thư mục tm-practice_1.0.0 và khớp với name cũng như version. Nêu rõ các điều kiện khi được thử nghiệm với các bản mod khác, trò chơi 2.0 được hỗ trợ và phần phụ thuộc base được sử dụng. Sau khi cập nhật trò chơi, hãy kiểm tra lại ba điều: tải, chế tạo và hiển thị tên, sau đó nâng cấp phiên bản phân phối.

Tài liệu gốc và tiêu chuẩn xác minh

Đây là hướng dẫn nhập môn do đội ngũ vận hành TroubleMaker viết bằng cách kiểm tra tài liệu công cụ chính thức và người tạo vào ngày 7 tháng 10 năm 2026. Mã và sơ đồ là các ví dụ tự tạo để giải thích và không xác minh kết quả chơi thực tế của trò chơi nói trên trên máy chủ này. Hãy phân phối sau khi kiểm tra trong một tệp lưu kiểm tra riêng với phiên bản được chỉ định trong văn bản chính. So sánh các phiên bản mới nhất và phần phụ thuộc của từng công cụ từ các nguồn gốc bên dưới.

Factorio 2.0 모드 제작 튜토리얼

Factorio locale 공식 문서

Factorio recipe prototype

Factorio 모딩 문서