Wie man einen Factorio-Mod erstellt: Gegenstände, Rezepte und koreanische Namen mit Lua hinzufügen

In Factorio 2.0 fügen wir einen Übungsgegenstand namens tm-practice-plate hinzu, der aus zwei Eisenplatten hergestellt wird. Dies ist ein Beispiel dafür, wie man einen Gegenstands-Prototypen, ein Herstellungsrezept und eine Lokalisierung direkt erstellt und als Mod-Ordner lädt. Es basiert auf dem Basis-Mod, ohne von Space Age-Inhalten abhängig zu sein, und verwendet eine separate Testkarte anstelle eines bestehenden Fabrik-Spielstands.

1. Mod-Ordner und Dateien vorbereiten

Bei Factorio können sich der Ordner der ausführbaren Datei und der Benutzerdatenordner unterscheiden. Suchen Sie den mods-Ordner im Benutzerdatenverzeichnis gemäß der offiziellen Dokumentation. Standardmäßige Windows-Installationen verwenden %APPDATA%/Factorio/mods, aber portable und benutzerdefinierte Konfigurationen variieren. Sichern Sie Ihre Speicherstände und bestehenden Mod-Einstellungen und erstellen Sie den Ordner tm-practice_1.0.0.

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

2. Kompatibilität in info.json deklarieren

name ist der interne Bezeichner des Mods und muss zum vorderen Teil des Ordnernamens passen. version muss mit _1.0.0 des Ordners übereinstimmen. factorio_version wird auf 2.0 festgelegt, um Verwechslungen mit der Struktur für 1.1 zu vermeiden. Aufgrund der base-Bedingung in dependencies können Sie Prototypen des Basisspiels verwenden.

{
  "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. Gegenstand und Rezept in data.lua einfügen

Kopieren Sie den Gegenstands-Prototypen der Standard-Eisenplatte und weisen Sie einen neuen Namen sowie eine Stapelgröße zu. Das Symbol verweist auf den internen Pfad des Basisspiels, den der Benutzer besitzt, sodass Spielbilder nicht in die ZIP-Datei kopiert werden. ingredients und results des Rezepts werden im expliziten Format type/name/amount von Factorio 2.0 geschrieben. Es wird auf enabled=true gesetzt, damit es in der Testkarte ohne zusätzliche Technologie-Freischaltungen gefunden werden kann.

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. Anzeigenamen mit locale vergeben

Fügen Sie den folgenden Text in locale/ko/strings.cfg ein. Stimmen Sie die Prototypennamen in den Abschnitten item-name und recipe-name genau ab. Wenn Lua-Zeichenketten und locale-Schlüssel abweichen, werden möglicherweise interne IDs oder Unknown key angezeigt.

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

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

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

Fügen Sie in locale/en/strings.cfg Ihre eigenen englischen Phrasen Practice plate, Make practice plate, An item for modding practice mit derselben Schlüsselstruktur ein. Speichern Sie die Datei als UTF-8. Wenn Sie .cfg im JSON-Format speichern, wird sie nicht gelesen.

5. Mod einschalten und Herstellung überprüfen

1. Starten Sie das Spiel und aktivieren Sie TroubleMaker Practice Plate unter Mods.
2. Stellen Sie sicher, dass keine Fehlermeldungen angezeigt werden, wenn das Spiel neu gestartet wird, um den Mod zu laden.
3. Spielen Sie in einem neuen Sandbox- oder Testkarten-Modus und bereiten Sie Eisenplatten vor.
4. Suchen Sie im Herstellungsmenü nach dem Übungs-Eisenplatten-Rezept und überprüfen Sie, ob 2 Eisenplatten in 1 Gegenstand umgewandelt werden.
5. Vergleichen Sie, ob Name und Beschreibung in den koreanischen und englischen Einstellungen als entsprechende locale-Phrasen angezeigt werden.
6. Beenden Sie das Spiel vollständig, deaktivieren Sie den Mod und überprüfen Sie die Grundkonfiguration auf einer separaten Testkarte.

6. Reihenfolge zum Lesen von Fehlern

Wenn das Laden des Mods stoppt, suchen Sie nach dem ersten Fehler in factorio-current.log. Bei einem Fehler, dass ein Prototyp fehlt, überprüfen Sie die Rechtschreibung von iron-plate und die base-Abhängigkeit; bei einem Rezeptfehler überprüfen Sie zuerst das results·ingredients-Format. Wenn der Mod nicht in der Liste ist, überprüfen Sie, ob sich der info.json-Pfad in zwei verschachtelten Ordnern befindet. Das Symbol ist identisch, daher ist es kein Bug, wenn das Aussehen mit der Standard-Eisenplatte übereinstimmt. Nachdem dieser Schritt erfolgreich war, ist es einfacher, eigene Herstellungssymbole, Technologie-Freischaltungen und die Balance für Tests hinzuzufügen.

7. Entfernung und Freigabe

Das Entfernen eines Mods, der Gegenstände hinzufügt, kann dazu führen, dass diese Gegenstände aus dem Spielstand verschwinden. Schalten Sie ihn nicht sofort in einem wichtigen Fabrik-Spielstand aus, sondern überprüfen Sie ihn auf einer gesicherten Kopie. Erstellen Sie die geteilte ZIP-Datei so, dass sie einen einzigen tm-practice_1.0.0-Ordner enthält, und stimmen Sie name·version ab. Geben Sie die Bedingungen an, die mit anderen Mods getestet wurden, das unterstützte Spiel 2.0 und die verwendete base-Abhängigkeit. Überprüfen Sie nach einem Spielupdate die drei Dinge Laden, Herstellen und Namensanzeige erneut und erhöhen Sie die Distributionsversion.

Originaldokument und Verifizierungskriterien

Dies ist eine Einführung, die vom TroubleMaker-Betriebsteam am 7. Oktober 2026 basierend auf der Ersteller- und offiziellen Werkzeugdokumentation verfasst wurde. Der Code und die Diagramme sind eigene Beispiele zur Erläuterung und stellen kein Ergebnis der Überprüfung des tatsächlichen Gameplays dieses Spiels auf diesem Server dar. Überprüfen Sie dies vor der Verteilung mit der im Text angegebenen Version in einem separaten Test-Spielstand. Vergleichen Sie die neuesten Versionen und Abhängigkeiten der einzelnen Werkzeuge im Original unten.

Factorio 2.0 모드 제작 튜토리얼

Factorio locale 공식 문서

Factorio recipe prototype

Factorio 모딩 문서