---
title: Actualizando un mod: cambios importantes en X4 9.00
summary: Colisiones, recursos y eventos para volver a comprobar cuando se adaptan ejemplos antiguos.
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/"]
---
## Establecer la versión


Este artículo tiene como objetivo 9.00. Las entradas oficiales para futuras versiones o apuestas individuales no establecen el comportamiento en su juego instalado.



## Recomprobar estas áreas


| Zona | 9.00 cambio |
| --- | --- |
| Colisiones | Reconvertir viejo `.jcs`; la nueva salida es incompatible con las versiones anteriores |
| Recursos | Región antigua `<resources>` sustituida por [Recursos](wiki:resource-areas) |
| `event_area_discovered` | Eliminado |
| `event_build_started`, `event_player_build_started` | `param2` es null; obtener la secuencia a través de la `param3` buildtask |
| `GetEfficiencyUpgrades()` | Depreciado; devuelve una lista vacía |


La tabla oficial no cubre todos los cambios enviados de la UI-script. Compare el menú real que engancha.



## Planifique su migración


1. Lista los datos y llama a tu mod realmente utiliza.
2. Identificar los cambios relevantes y preservar las viejas fuentes de trabajo por separado.
3. Comparar los recursos pertinentes de ambas instalaciones; fijar la referencia, firma o formato específicos.
4. Prueba una acción en un nuevo juego, luego actualiza un ahorro más antiguo.
5. Uso [catálogos de versiones](wiki:version-catalogs) para diferentes archivos cuando se soportan ambos juegos.



## Grabar el resultado


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



Esta es una plantilla de informe en lugar de evidencia. Construir con éxito o pasar la validación XML no establece la colisión, minería o comportamiento de eventos. [Conjunto de herramientas oficiales de Blender](wiki:tool-blender).



## Comparando las API 8.00 y 9.00


[Chem O’Dun's Game Changes](https://chemodun.github.io/x4/modding-support/game-changes/) compara referencias para **8.00 (590967)** y **9.00 (611726)**. Difiere de [Cambios](https://chemodun.github.io/x4/changes/), que registra las ediciones en el sitio de documentación.



| Conclusiones | Acción para un autor mod |
| --- | --- |
| `find_asteroid_in_cluster`, `find_recyclable_in_cluster`, `get_highest_resource_yield` eliminado | Investigar áreas de recursos y nuevas acciones; no sustituir mecánicamente un nombre |
| Atributos de `find_resource` y `find_closest_resource` cambiado | Compare el esquema 9.00, especialmente `resourcearea` y filtros de descubrimiento |
| `GetRadarModuleName` despreocupado en 9.00 | Buscar la ruta de datos actual en lugar de simplemente comprobar la existencia de la función |
| C Nombres de la estructura/función de API cambiados | Releer declaraciones, campos y tamaños de los buffers de salida |


Un nombre de función compartida no establece una firma C sin cambios. No es necesario que exista una necesidad global en ambos contextos de addons/core Lua. UIX tiene su propio historial de versiones, separado de X4. Un reemplazo correcto requiere entender la operación y verificar su resultado.