---
title: 你的第一个 X4 模组
summary: 简单的扩展,有文件,content.xml,Mission Director脚本和验证计划.
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/"]
---
## 将要创建的内容


那些小 `hello_x4` 扩展写一个信息到日志. 现在XML和Mission Director就足够了.



[下载模组基础结构](download:hello_x4)



邮政包包含一个配置 `content.xml`, 其他 `md/HelloX4.xml` 其他类型的文件,例如俄语和英语指令, 提取它,然后移动. `hello_x4` 进入 `extensions` 您选择的X4安装文件. 然后按照下面的步骤检查和更改文件.



> 这是一个独立的学习例子. 在构建wiki时检查档案结构和XML;没有要求在游戏中进行单独运行.



## 创建文件


放放放在游戏的下面 `extensions` 文件目录. X4 必须找到 `content.xml` 直接下面 `hello_x4`, 没有额外的嵌套文件. 使用一个安装和测试配置文件,避免复制安装扩展ID.




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



只有 `content.xml` 和 `md/HelloX4.xml` 它们是第一次发射所需的. 其他文件是空的: `aiscripts` 对于AI, `assets` 资源和宏观, `index` 对指数, `libraries` 桌子和贴片, `t` 为了发送短信,以及 `ui` 对于未来的接口. 拿走你不需要的东西. 其他 `ui` 文件不自行注册Lua;见 [接口设置](wiki:create-ui).



## 描述扩展


在表中设置自己的作者和唯一的身份证. 下面显示的版本依赖性目标是X4 9.00. 只有当您的扩展实际上需要其API或资源时,只需添加第三方依赖性.




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

## 添加游戏逻辑


创建 `md/HelloX4.xml`. `mdscript` 和 `cue` 是XML元素名称; `HelloX4` 和 `Hello` 它们是你的身份证. 内部的引用 `text` 由于属性包含一个字符串字母的 MD 表达式,因此需要




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

## 检查启动


启动扩展,并在必要时重新启动X4. 使用测试保存或新游戏,启用 [日志记录](wiki:debugging), 找 `Hello, X4!` 检查进口错误. 完成的标志保持其保存状态;加载现有保存并不一定重复消息. 看到 [持久化](wiki:md-persistence).



## 下一步


阅读 [content.xml,身份证和依赖性](wiki:extension-manifest)。使用 [专题地图](wiki:official-guide-map) 选择一个进一步的任务.



阅读 [cue 生命周期](wiki:md-cues), 接着 [Lua ↔ MD 事件](wiki:md-lua-bridge)。使用 [XML diff 补丁](wiki:xml-patches) 改变现有游戏数据.