---
title: AddUITriggeredEvent
summary: Lua UI → Mission Director: отправка screen, control и полезной нагрузки.
section: reference
kind: api
status: reference
tags: ["AddUITriggeredEvent","lua","md","events","API"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## Возвращаемое значение

| Тип | Значение |
| --- | --- |
| [`unknown`](wiki:type-results) | Контракт прямого результата здесь не установлен. Отправка события не доказывает выполнение действия MD. |

[Типы и методы](wiki:types)

## Используемая форма


**Слой:** Lua UI игры.



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



| Параметр | Роль |
| --- | --- |
| `screen` | Строка, совпадающая с screen обработчика MD |
| `control` | Строка операции или элемента управления |
| `payload` | Поддерживаемое значение запроса; форму проверяет получатель |


## Пример


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



**Что произойдёт:** Отправится событие с screen = "WikiBridge", control = "ping" и строкой payload = "hello". У подходящего MD-получателя эта строка доступна как event.param3; само событие ничего не печатает.



На стороне MD это принимает `event_ui_triggered` с теми же screen/control; полезная нагрузка читается из `event.param3` в используемом проектом контракте.



## Ограничения


Отправка не означает, что обработчик готов, действие разрешено или эффект выполнен. Для операции с ответом заранее зарегистрируйте получателя и передавайте свой ID запроса.



Реальная сериализация зависит от поддерживаемых игрой типов. Не передавайте произвольный userdata или runtime handle другого процесса как готовый объект.



Полный учебный обмен: [Lua ↔ MD](wiki:md-lua-bridge).