---
title: AddUITriggeredEvent
summary: Lua UI → Mission Director: enviar pantalla, control y una carga útil.
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/"]
---
## Valor devuelto

| Tipo | Significado |
| --- | --- |
| [`unknown`](wiki:type-results) | Aquí no se establece un contrato de retorno. Enviar un evento no demuestra que una acción MD haya finalizado. |

[Tipos y métodos](wiki:types)

## Forma observada


Capa: juego Lua UI. `screen` es la cadena que coincide con el receptor MD; `control` identifica la operación o el control; `payload` es un valor soportado cuya forma es validada por el receptor.




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

## Ejemplo


El lado MD coincide con la misma pantalla/control con `event_ui_triggered`. El contrato utilizado por este proyecto lee la carga útil de `event.param3`.




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



**Qué ocurre:** Un evento se envía con pantalla = "WikiBridge", control = "ping" y payload = "hello". Un receptor MD que coincida puede leerlo como event.param3; enviar solo no imprime un mensaje.

## Límites


Enviar no prueba que el receptor está listo, la acción está autorizada o el efecto ocurrió. Registrar el receptor de respuesta primero y utilizar un ID de solicitud para operaciones reconocidas. La serialización depende de los tipos de juego soportados; datos de usuario arbitrarios o el manejo de tiempo de ejecución de otro proceso no es un objeto listo para usar. Vea el completo [Ejemplo Lua ↔ MD](wiki:md-lua-bridge).