---
title: Dein erster X4-Mod
summary: Eine minimale Erweiterung mit Ordnern, content.xml, einem Mission Director-Skript und einem Verifikationsplan.
section: start
kind: guide
status: example
updated: 2026-10-27
tags: ["X4","modding","first","extension"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## Was du erstellst


Die kleinen `hello_x4` erweiterung schreibt eine Nachricht an das protokoll. XML und Mission Director sind genug.



[Mod-Grundgerüst herunterladen](download:hello_x4)



Die ZIP enthält eine konfigurierte `content.xml`, die `md/HelloX4.xml` Beispiel, russische und englische Anweisungen, und Ordner für weitere Arbeiten. Extrahieren und verschieben `hello_x4` in der `extensions` Ordner der gewählten X4 Installation. Folgen Sie dann den Schritten unten, um die Dateien zu überprüfen und zu ändern.



> Dies ist ein unabhängiges Lernbeispiel. Archivstruktur und XML werden beim Aufbau des Wikis überprüft; ein separater In-Game-Lauf wird nicht beansprucht.



## Ordner erstellen


Legen Sie die Erweiterung unter das Spiel `extensions` verzeichnis. X4 muss finden `content.xml` direkt unter `hello_x4`, ohne einen zusätzlichen verschachtelten Ordner. Verwenden Sie ein Installations- und Testprofil und vermeiden Sie doppelte installierte Erweiterungs-IDs.




```text
hello_x4/
├── content.xml
├── README.txt
├── md/
│   └── HelloX4.xml
├── aiscripts/
├── assets/
├── index/
├── libraries/
├── t/
└── ui/
```



Nur `content.xml` und `md/HelloX4.xml` für den ersten Start benötigt werden. Die anderen Ordner sind leer: `aiscripts` für AI, `assets` für Ressourcen und Makros, `index` für Indizes, `libraries` für Tabellen und Patches, `t` für Text und `ui` für eine zukünftige Schnittstelle. Entfernen Sie alle, die Sie nicht benötigen. `ui` Ordner registriert Lua nicht von selbst; siehe [Einrichtung der Schnittstelle](wiki:create-ui).



## Beschreibung der Erweiterung


Stellen Sie Ihren eigenen Autor und eindeutige ID im Manifest. Die unten gezeigte Versionsabhängigkeit richtet sich nach X4 9.00. Fügen Sie Abhängigkeiten von Drittanbietern nur hinzu, wenn Ihre Erweiterung tatsächlich ihre APIs oder Ressourcen benötigt.




```xml
<?xml version="1.0" encoding="utf-8"?>
<content id="hello_x4" name="Hello X4" version="100"
         author="Your name" enabled="1" save="1"
         description="A minimal Mission Director example.">
  <dependency version="900" />
</content>
```

## Spiellogik hinzufügen


Erstelle `md/HelloX4.xml`. `mdscript` und `cue` sind XML-Elementenamen; `HelloX4` und `Hello` sind Ihre Kennungen. Die inneren Anführungszeichen in `text` werden benötigt, weil das Attribut einen MD-Ausdruck mit einem String-Wörtlichen enthält.




```xml
<?xml version="1.0" encoding="utf-8"?>
<mdscript name="HelloX4">
  <cues>
    <cue name="Hello">
      <actions>
        <debug_text text="'Hello, X4!'" />
      </actions>
    </cue>
  </cues>
</mdscript>
```

## Start prüfen


Aktivieren Sie die Erweiterung und starten Sie X4, wenn erforderlich. Verwenden Sie einen Test speichern oder ein neues Spiel, aktivieren [Protokollierung](wiki:debugging), finden `Hello, X4!` und überprüfen Sie auf Importfehler. Ein abgeschlossenes Queue behält seinen Zustand in einem Speichern; das Laden eines vorhandenen Save wiederholt nicht unbedingt die Nachricht. Siehe [Persistenz](wiki:md-persistence).



## Nächster Schritt


Lies [content.xml, IDs und Abhängigkeiten](wiki:extension-manifest). Verwende die [Themenkarte](wiki:official-guide-map) eine weitere Aufgabe zu wählen.



Lies [cue-Lebenszyklus](wiki:md-cues), dann [Lua ↔ MD: Ereignisse](wiki:md-lua-bridge). Verwende [XML-Diff-Patches](wiki:xml-patches) um vorhandene Spieldaten zu ändern.