---
title: Mod-Einstellungen und bestehende UI-APIs
summary: Wann Sie eine Einstellungenbibliothek verwenden und wann Sie ein benutzerdefiniertes Fenster erstellen.
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"]
---
## Eine Einstellung braucht nicht immer ein Fenster


Ein Toggle, Nummer oder Modus Selektor kann eine gemeinsame Erweiterung Einstellungen Schnittstelle verwenden. Ein spezielles Panel kann eine [benutzerdefiniertes Fenster](wiki:create-ui). Eine Option von Drittanbietern ist X4 Mod Support APIs, `sn_mod_support_apis`: Einfache Menü-API unterstützt Einstellungen/Menü-Konstruktion, und Lua Loader API unterstützt das Laden und verzögerte Initialisierung.



## Distinguish die Bibliothek aus dem Spiel


`Register_OnLoad_Init` und MD `Simple_Menu_Options` gehören zu dieser Bibliothek; sie sind nicht in sauberen X4 garantiert. Lesen Sie die installierte Version Dokumentation, erklären `content.xml` und `ui.xml` Abhängigkeiten und warten auf die Bereitschaft.



## Die Route einer Einstellung


Definieren Sie eine eindeutige ID, Text, Typ und Default; registrieren Sie einen Change Handler; validieren und speichern Sie den Wert im entsprechenden Kontext. Defaults dürfen nicht gespeicherte Optionen bei jeder Last überschreiben. Menüwiederaufbau darf keine teure Operation wiederholen.



## Überprüfung


Testen Sie zuerst das Öffnen, Ändern des Wertes, Wiederöffnen, Speichern und Laden. Überprüfen Sie fehlende oder inkompatible Abhängigkeiten separat. Verwenden Sie die aktuelle Bibliotheksdokumentation und nicht ein verifiziertes Beispiel für eine ältere Version.



## UIX-Abonnements


UI Extensions und HUD ist eine andere Bibliothek; konfiziere ihre Hooks nicht mit Simple Menu API. [Beispiel für UIX-Abonnements](wiki:ui-hooks-and-top-menu) deckt Argumente, Rückgaben, das Entfernen Ihres Abonnements und das freigegebene Top-Menü-Limit ab. Überprüfen Sie die genaue Abhängigkeitsversion, nicht nur deren Präsenz.