Qué vas a crear#

El pequeño hello_x4 extensión escribe un mensaje al registro. XML y Mission Director son suficientes.

Descargar estructura inicial del modZIP · X4 9.00+

El ZIP incluye un configurado content.xml, los md/HelloX4.xml ejemplo, instrucciones en ruso e inglés, y carpetas para trabajos posteriores. Extraiga y mueva hello_x4 en la extensions carpeta de la instalación X4 elegida. A continuación, siga los pasos a continuación para inspeccionar y cambiar los archivos.

Crear las carpetas#

Colocar la extensión bajo el juego extensions directorio. X4 debe encontrar content.xml directamente debajo hello_x4, sin una carpeta anidada adicional. Utilice un perfil de instalación y prueba, y evite duplicados ID de extensión instalada.

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

Sólo content.xml y md/HelloX4.xml son necesarios para el primer lanzamiento. Las otras carpetas están vacías: aiscripts para AI, assets para los recursos y macros, index para los índices, libraries para las mesas y los parches, t para el texto, y ui para una interfaz futura. Quite cualquier que no necesite. ui la carpeta no registra Lua por sí misma; véase configuración de la interfaz.

Describir la extensión#

Establezca su propio autor y su ID único en el manifiesto. La dependencia de la versión que se muestra a continuación tiene como objetivo X4 9.00. Añada las pertenencias de terceros sólo cuando su extensión realmente necesite sus API o recursos.

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>

Añadir lógica de juego#

Crea md/HelloX4.xml. mdscript y cue son nombres de elementos XML; HelloX4 y Hello son sus identificadores. Las comillas internas en text se necesitan porque el atributo contiene una expresión MD con una cadena literal.

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>

Comprobar el inicio#

Activar la extensión y reiniciar X4 cuando sea necesario. Usar un guardar de prueba o un juego nuevo, activar registro de logs, encontrar Hello, X4! y compruebe si hay errores de importación. Una señal completa conserva su estado en un guardar; cargar un guardar existente no necesariamente repite el mensaje. Ver persistencia.

Siguiente paso#

Lee content.xml, IDs y drogodependencias. Utiliza mapa de temas elegir una tarea más.

Lee ciclo de vida de cue, entonces Eventos Lua ↔ MD. Utiliza Parches diff XML cambiar los datos de juego existentes.