---
title: Cómo se organiza una extensión X4
summary: Las carpetas y capas de una extensión regular: datos de juego, naves, MD, Lua y localización.
section: start
kind: guide
status: reference
updated: 2026-10-22
tags: ["X4","modding","architecture"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## Capas de un mod regular


Una extensión puede contener datos, scripts de juego y código de la UI. Un cambio de propiedad necesita sólo un manifiesto y un diff XML específico. Añada otras capas cuando la tarea las requiera.



| Archivo o carpeta | Finalidad |
| --- | --- |
| `content.xml` | Identidad, descripción, versión y lúdicas |
| `assets/` | Buques, equipos, modelos y macros |
| `index/` | Registro de recursos |
| `libraries/` | Productos, recetas y otros datos |
| `md/` | Lógica de eventos Mission Director |
| `aiscripts/` | Comportamiento y parches de IA |
| `ui.xml`, `ui/` | Registro de la UI y Lua |
| `t/` | Texto y traducciones |


## Elija una ruta para su tarea


Comenzar con [propiedades del buque](wiki:editing-parameters), [una nueva variante de buque](wiki:adding-ship), [una ventana personalizada](wiki:create-ui), [un evento MD](wiki:md-cues) o [Texto localizado](wiki:localization). Un mod regular no requiere un servicio separado, transporte TCP o DLL nativo.



## UI y el efecto del juego


Lua construye la ventana y recibe la entrada; MD puede realizar la lógica del mundo. Enviar un evento, validar el objeto, realizar la acción, devolver el resultado real y luego actualizar la ventana. No ponga cada cambio del mundo en un callback de dibujo. El diagrama original de abajo ilustra ese flujo.




```text
Кнопка интерфейса
  → событие в MD
  → проверка объекта и выполнение действия
  → ответ в Lua
  → обновление окна
```

## Siguiente paso


¿Nuevo en programación? [cómo funciona el código de X4](wiki:x4-code-basics) y la [hoja de trucos de sintaxis](wiki:x4-language-cheatsheet). [Su primera extensión](wiki:first-extension) introduce el manifiesto. [Dependencias](wiki:compatibility) explica cómo separar sus archivos de DLC y recursos de terceros.