---
title: Tu primer mod de X4
summary: Una extensión mínima con carpetas, content.xml, un script Mission Director y un plan de verificación.
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/"]
---
## Qué vas a crear


El pequeño `hello_x4` extensión escribe un mensaje al registro. XML y Mission Director son suficientes.



[Descargar estructura inicial del mod](download:hello_x4)



El ZIP incluye un configurado `content.xml`, los `md/HelloX4.xml` ejemplo, instrucciones en ruso e inglés, y carpetas para trabajos posteriores. Extraiga y mueva `hello_x4` en la `extensions` carpeta de la instalación X4 elegida. A continuación, siga los pasos a continuación para inspeccionar y cambiar los archivos.



> Este es un ejemplo de aprendizaje independiente. La estructura de archivo y XML se comprueban al construir el wiki; no se reclama una ejecución separada en el juego.



## Crear las carpetas


Colocar la extensión bajo el juego `extensions` directorio. X4 debe encontrar `content.xml` directamente debajo `hello_x4`, sin una carpeta anidada adicional. Utilice un perfil de instalación y prueba, y evite duplicados ID de extensión instalada.




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



Sólo `content.xml` y `md/HelloX4.xml` son necesarios para el primer lanzamiento. Las otras carpetas están vacías: `aiscripts` para AI, `assets` para los recursos y macros, `index` para los índices, `libraries` para las mesas y los parches, `t` para el texto, y `ui` para una interfaz futura. Quite cualquier que no necesite. `ui` la carpeta no registra Lua por sí misma; véase [configuración de la interfaz](wiki:create-ui).



## Describir la extensión


Establezca su propio autor y su ID único en el manifiesto. La dependencia de la versión que se muestra a continuación tiene como objetivo X4 9.00. Añada las pertenencias de terceros sólo cuando su extensión realmente necesite sus API o recursos.




```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>
```

## Añadir lógica de juego


Crea `md/HelloX4.xml`. `mdscript` y `cue` son nombres de elementos XML; `HelloX4` y `Hello` son sus identificadores. Las comillas internas en `text` se necesitan porque el atributo contiene una expresión MD con una cadena literal.




```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>
```

## Comprobar el inicio


Activar la extensión y reiniciar X4 cuando sea necesario. Usar un guardar de prueba o un juego nuevo, activar [registro de logs](wiki:debugging), encontrar `Hello, X4!` y compruebe si hay errores de importación. Una señal completa conserva su estado en un guardar; cargar un guardar existente no necesariamente repite el mensaje. Ver [persistencia](wiki:md-persistence).



## Siguiente paso


Lee [content.xml, IDs y drogodependencias](wiki:extension-manifest). Utiliza [mapa de temas](wiki:official-guide-map) elegir una tarea más.



Lee [ciclo de vida de cue](wiki:md-cues), entonces [Eventos Lua ↔ MD](wiki:md-lua-bridge). Utiliza [Parches diff XML](wiki:xml-patches) cambiar los datos de juego existentes.