---
title: RegisterEvent
summary: Registrar una devolución de Lua, interpretar sus argumentos y protegerse de contextos obsoletos.
section: reference
kind: api
status: reference
updated: 2026-10-22
tags: ["X4","modding","register","event"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## Valor devuelto

| Tipo | Significado |
| --- | --- |
| [`unknown`](wiki:type-results) | El retorno del registro no está establecido. Los argumentos del callback dependen del evento concreto, no de RegisterEvent en sí. |

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

## Forma observada


Capa: juego Lua UI. `name` identifica el hecho recibido; `callback` procesa sus argumentos.




```lua
RegisterEvent(name, callback)
```

## Respuesta de ejemplo de MD


El primer argumento es ignorado intencionalmente en el ejemplo. La carga útil es el segundo argumento sobre esto `raise_lua_event` ruta. No aplique esa firma a cada evento interno del juego sin comprobar su contrato.




```lua
RegisterEvent("Wiki.Pong", function(_, payload)
    if payload ~= "pong" then
        return
    end
    -- Ответ распознан. При необходимости обновите своё состояние.
end)
```



**Qué ocurre:** Una devolución de llamada está registrada para Wiki.Pong. Con payload = "pong" llega al comentario; este ejemplo no tiene ninguna acción o salida impresa.

## Ciclo de vida


No instale un nuevo controlador en cada marco. Las llamadas de emergencia de adaptadores antiguos pueden necesitar una comprobación de la situación actual después de la sustitución. La validez de la instancia y la limpieza de ventanas deben seguir el ciclo de vida de la UI: [Lua UI](wiki:lua-ui).