Wie man einen Terraria-Mod erstellt: Hinzufügen von Gegenständen und Handwerksrezepten mit tModLoader

Basierend auf dem Entwicklungsablauf der stabilen Version 1.4.4 von Terraria tModLoader erstellen wir einen Übungs-Token aus 10 Holzstücken. Du lernst die Rollen von C# ModItem, PNG-Texturen und CreateRecipe kennen. Bereite die Umgebung, in der nur das Hauptspiel von Terraria ausgeführt wird, und die Mod-Welt/-Charaktere von tModLoader getrennt voneinander vor.

1. Vorbereitung und Versionsprüfung

Installiere das originale Terraria und den originalen tModLoader und führe sie mit demselben stabilen Zweig aus. Überprüfe die Anforderungen für Basic Prerequisites und das .NET SDK im Entwickler-Wiki. Die aktuelle Standardanleitung verwendet das .NET 8.0 SDK, und die Desktop Runtime allein ersetzt keine Entwicklungswerkzeuge. Vermische keine alten 1.3-Beispiel-Item-Felder oder ModRecipe mit dem neuesten Code. Erstelle Backups deiner Charaktere, Welten und bestehenden Mods, bevor du einen neuen Testcharakter erstellst.

2. Erstellen des Mod-Grundgerüsts im Spiel

1. Wähle im tModLoader-Hauptmenü Workshop → Develop Mods → Create Mod.
2. Verwende für den internen ModName einen eindeutigen Namen ohne Leerzeichen wie TroubleMakerToken.
3. Gib den Anzeigenamen, den Autor und den Standard-Gegenstandsnamen ein. Der Standardname für das Beispielobjekt wird auf WorkshopToken festgelegt.
4. Öffne nach der Erstellung unter Develop Mods mit Open Sources den tatsächlichen ModSources-Ordner.
5. Öffne die generierte .csproj im Ordner TroubleMakerToken in deiner IDE und warte, bis die erforderlichen Abhängigkeiten geladen sind.
6. Führe zu Beginn einmal Build + Reload im ursprünglichen Generatorzustand aus, um die Entwicklungsumgebung zu überprüfen.

3. Modifizieren der Gegenstandsklasse

Ändere Content/Items/WorkshopToken.cs in die folgende Struktur. Wenn der Generator einen anderen Pfad oder Namespace verwendet hat, passe diesen an und stelle sicher, dass nicht zwei gleiche Klassen entstehen. ModItem definiert das Verhalten des neuen Gegenstands, und SetDefaults legt Größe, maximale Stapelgröße, Seltenheit usw. fest.

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. Hinzufügen von PNG und Anzeigetexten

Lege WorkshopToken.png in denselben Ordner Content/Items. Modifiziere das im Generator enthaltene Übungsbild oder verwende ein selbst gezeichnetes PNG mit transparentem Hintergrund. Groß-/Kleinschreibung des Dateinamens und der Pfad müssen mit dem Klassennamen übereinstimmen. 20×20 ist die Einstellung für Kollision und Anzeige des Gegenstands und bedeutet nicht zwangsläufig, dass alle Dimensionen des Originalbildes genau diese Zahl sein müssen. Das erste Beispiel kann mit einem kleinen quadratischen Bild begonnen werden, um die Ausrichtung leicht zu überprüfen.

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

Moderne tModLoader-Versionen verwalten Anzeigenamen und Beschreibungen in der HJSON-Lokalisierung. Füge die folgenden Items-Einträge in die generierte Lokalisierungsdatei ein oder bearbeite bestehende Schlüssel. Füge dieselbe Mods-Wurzel nicht doppelt in die gesamte Datei ein, sondern bearbeite sie basierend auf der Generatorstruktur.

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

5. Kompilieren und tatsächliches Herstellen

1. Speichere den geänderten Code und führe Build + Reload unter Develop Mods aus.
2. Wenn ein Fehler auftritt, überprüfe zuerst den Dateinamen und die Zeilennummer des ersten Kompilierungsfehlers.
3. Überprüfe in der Mod-Liste, ob dein Mod aktiviert ist, und betrete eine neue Testwelt.
4. Bereite 10 Holz und eine Werkbank (Work Bench) vor und öffne das Handwerksmenü neben der Werkbank.
5. Stelle den Workshop Token her, um Holzverbrauch, Gegenstandsstapel, Name und Beschreibung zu überprüfen.
6. Wenn die Textur nicht sichtbar ist, überprüfe den tatsächlichen Pfad und die Groß-/Kleinschreibung des PNGs und führe erneut Build + Reload aus.

6. Häufigste Fehler und Behebung

Wenn das Rezept nicht angezeigt wird, vergewissere dich, dass du dich in der Nähe einer Werkbank befindest und ItemID.Wood sowie TileID.WorkBenches korrekt eingegeben hast. Wenn du den Namespace geändert hast, bereinige doppelt generierte Klassen und passe den Bildpfad entsprechend an. Das Deaktivieren des Mods führt dazu, dass Speicherstände ohne die Mod-Gegenstände geladen werden; wende dies daher nicht direkt auf echte Spiel-Speicherstände an. Beende das Spiel, deaktiviere den Mod und vergleiche es mit einer separat gesicherten Testwelt.

7. Überprüfung vor dem Workshop-Teilen

Erkläre die Eindeutigkeit des internen ModName, die stabile Version, die Anforderungen an Handwerksmaterialien und Werkbank sowie die Herkunft des Originalbildes. Die Publish-Funktion von tModLoader ist ein echter öffentlicher Upload; bereite daher vor der Verwendung die Distributions-ZIP, die README und die Testergebnisse vor. Diese Anleitung erklärt den Erstellungsprozess und lädt nichts automatisch in das Konto des Lesers hoch. Beachte bei der Modifikation und Weitergabe von Spielressourcen oder Gegenstands-Mods anderer die Erlaubnis und Bedingungen des jeweiligen Erstellers.

Originaldokument und Überprüfungsstandards

Dies ist eine Einführungshilfe, die vom TroubleMaker-Betriebsteam am 7. Oktober 2026 auf Basis der offiziellen Werkzeug- und Erstellerdokumente verfasst wurde. Code und Diagramme dienen als eigene Beispiele zur Erklärung und stellen kein Ergebnis tatsächlicher Spielverifzierungen auf diesem Server dar. Überprüfe und verteile sie in einer separaten Testwelt mit den im Text angegebenen Versionen. Vergleiche die neuesten Versionen und Abhängigkeiten der einzelnen Werkzeuge in den folgenden Originalquellen:

tModLoader 기본 제작 가이드

tModLoader 제작 준비

tModLoader 자체 예제 모음

tModLoader 번역·표시 문구