---
title: AddUITriggeredEvent
summary: Lua UI → Mission Director: Bildschirm senden, steuern und eine Nutzlast.
section: reference
kind: api
status: reference
updated: 2026-10-22
tags: ["X4","modding","add","ui","triggered","event"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## Rückgabewert

| Typ | Bedeutung |
| --- | --- |
| [`unknown`](wiki:type-results) | Hier ist kein Rückgabevertrag geklärt. Das Senden eines Ereignisses beweist nicht, dass eine MD-Aktion abgeschlossen wurde. |

[Typen und Methoden](wiki:types)

## Vordruck


Ebene: Spiel Lua UI. `screen` ist die vom MD-Empfänger abgestimmte Zeichenfolge; `control` die Funktion oder die Kontrolle zu bestimmen; `payload` ist ein unterstützter Wert, dessen Form vom Empfänger validiert wird.




```lua
AddUITriggeredEvent(screen, control, payload)
```

## Beispiel


Die MD-Seite entspricht dem gleichen Bildschirm/Steuerung mit `event_ui_triggered`. Der Vertrag dieses Projekts liest die Nutzlast aus `event.param3`.




```lua
AddUITriggeredEvent("WikiBridge", "ping", "hello")
```



**Was geschieht:** Ein Ereignis wird mit dem Bildschirm = "WikiBridge", Steuerung = "ping" und Nutzlast = "hallo" gesendet. Ein passender MD-Empfänger kann es als event.param3 lesen; das Senden allein gibt keine Nachricht aus.

## Grenzen


Das Senden beweist nicht, dass der Empfänger bereit ist, die Aktion autorisiert ist oder der Effekt aufgetreten ist. Registrieren Sie zuerst den Antwortempfänger und verwenden Sie eine Request-ID für anerkannte Operationen. Serialisierung hängt von unterstützten Spieltypen ab; willkürliche Benutzerdaten oder der Runtime-Handle eines anderen Prozesses ist kein Ready-to-use-Objekt. [Lua ↔ MD: Beispiel](wiki:md-lua-bridge).