---
title: Configuración modificada y API de UI existentes
summary: Cuándo usar una biblioteca de ajustes y cuándo construir una ventana personalizada.
section: ui
kind: guide
status: reference
updated: 2026-10-27
tags: ["X4","modding","ui","settings"]
sources: ["https://github.com/bvbohnen/x4-projects/tree/master/extensions/sn_mod_support_apis"]
---
## Una configuración no siempre necesita una ventana


Un conmutador, número o modo se puede usar una interfaz de configuración de extensiones compartidas. [ventana personalizada](wiki:create-ui). Una opción de terceros es X4 Mod Support APIs, `sn_mod_support_apis`: API de menú simple admite ajustes/construcción de menu, y API de cargador Lua ayuda a cargar e inicializar de forma retrasada.



## Distinguir la biblioteca del juego


`Register_OnLoad_Init` y MD `Simple_Menu_Options` pertenecen a esa biblioteca; no están garantizados en X4 limpio. Lea la documentación de la versión instalada, declare `content.xml` y `ui.xml` Las cosas, y esperen la preparación.



## Ruta de un ajuste


Definir un ID único, texto, tipo y por defecto; registrar un controlador de cambios; validar y almacenar el valor en el contexto apropiado. Los predeterminados no deben sobreescribir las opciones guardadas en cada carga. La reconstrucción del menú no debe repetir una operación costosa.



## Verificación


Prueba la primera apertura, cambiando el valor, reabriendo, guardando y cargando. Compruebe que faltan o son incompatibles las pérdidas por separado. Use la documentación actual de la biblioteca en lugar de un ejemplo no verificado para una versión anterior.



## Suscripciones a UIX


UI Extensions y HUD es una biblioteca diferente; no conflate sus ganchos con Simple Menu API. [Ejemplo de suscripción UIX](wiki:ui-hooks-and-top-menu) cubre argumentos, devoluciones, eliminando su suscripción y el límite compartido de top-menu. Compruebe la versión exacta de dependencia, no sólo su presencia.