---
title: 更新一个调整器:重要的X4 9.00变化
summary: 应在适应较早的例子时重新检查碰撞,资源和事件.
section: data
kind: guide
status: reference
updated: 2026-10-27
tags: ["X4","modding","x4","version","migration"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/Breaking%20Changes/","https://chemodun.github.io/x4/modding-support/game-changes/"]
---
## 建立版本


这篇文章是9点的. 官方版本或单独的betas的官方录像不会建立您安装的游戏中的行为.



## 检查这些区域


| 区域 | 九点变换 |
| --- | --- |
| 碰撞 | 重新改造旧 `.jcs`; 新输出与旧版本不兼容 |
| 资源 | 旧地区 `<resources>` 取代为 [资源领域](wiki:resource-areas) |
| `event_area_discovered` | 删除 |
| `event_build_started`, `event_player_build_started` | `param2` 通过 `param3` 建设任务 |
| `GetEfficiencyUpgrades()` | 退缩;返回空清单 |


官方表不包括出货的UI脚本变更. 让你比较你的菜单.



## 计划迁移


1. 列出您的调用方式实际使用的数据和呼叫.
2. 确定相关的变化,并单独保存旧工作源.
3. 进行对照两家设备的相关资源;确定具体的参考,签名或格式.
4. 在新游戏中测试一项操作,然后升级旧版本.
5. 使用 [版本目录包](wiki:version-catalogs) 在支持两款游戏时,不同文件.



## 记录结果


```text
Game: exact version + build
Changed part: one file or contract
Before: expected failure or old behavior
After: independently observed value/action
Save/load: pass, fail or not tested
```



这是一个报告模板,而不是证据. 建立成功或通过XML验证并不能建立碰撞,挖矿或事件行为. 对于模型,首先是 [官方Blender工具包](wiki:tool-blender).



## 进行比较8.00和9.00的API


[化学奥登的游戏变化](https://chemodun.github.io/x4/modding-support/game-changes/) 进行了对比 **8.00 (590967)** 和 **9.00 (611726)**. 其他它们不同于 [变化](https://chemodun.github.io/x4/changes/), 记录编辑到文档网站.



| 找出 | 适用模特作者的行动 |
| --- | --- |
| `find_asteroid_in_cluster`, `find_recyclable_in_cluster`, `get_highest_resource_yield` 删除 | 调查资源领域和新行动;不要机械地替代一个名称 |
| 具有的属性 `find_resource` 和 `find_closest_resource` 变化 | 比较9点的方案,特别是 `resourcearea` 及发现过器 |
| `GetRadarModuleName` 截止日期为9点 | 找出当前数据路线,而不是仅仅检查函数存在 |
| C API结构/功能名称变更 | 重新阅读声明,字段和输出缓冲区的大小 |


共同函数名称不会建立一个不变的C签名. 在两个添加/核心Lua文本中,没有全球需求. UIX 具有自己的发布历史,与X4分开. 适当的替换需要了解操作和验证结果.