---
title: 如何组织X4扩展
summary: 常规扩展的文件和层次:游戏数据,船只,MD,Lua和本地化.
section: start
kind: guide
status: reference
updated: 2026-10-22
tags: ["X4","modding","architecture"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## 常规模块的层


扩展可以包含数据,游戏脚本和UI代码. 属性变化只需要一个明示和一个针对性的XML差异. 任务需要它们时,添加其他层.



| 文件或文件 | 用途 |
| --- | --- |
| `content.xml` | 身份,描述,版本和依赖性 |
| `assets/` | 船舶,设备,模型和宏观 |
| `index/` | 资源登记 |
| `libraries/` | 商品,食谱和其他数据 |
| `md/` | Mission Director事件逻辑 |
| `aiscripts/` | 人工智能行为和补丁 |
| `ui.xml`, `ui/` | 用户界面登记和Lua |
| `t/` | 文本和翻译 |


## 选择一个路线


开始 [船舶的财产](wiki:editing-parameters), [一种新的船型](wiki:adding-ship), [个性窗口](wiki:create-ui), [一个 MD 事件](wiki:md-cues) 或 [局部化文本](wiki:localization). 其他常规的模特不需要单独的服务,TCP运输或本土DLL.



## 游戏效果


Lua构建窗口并接收输入; MD可以执行世界逻辑. 发送事件,验证对象,执行操作,返回实际结果,然后更新窗口. 不要把世界变化都变成一个回调. 下面的原始图表说明了这一流动.




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

## 下一步


编程新人? 阅读 [X4 代码的工作原理](wiki:x4-code-basics) 其他 [语法骗局表](wiki:x4-language-cheatsheet). [你的第一个延长](wiki:first-extension) 引入了明示. [依赖性](wiki:compatibility) 解释如何将文件与DLC和第三方资源分开.