---
title: event_object_docked
summary: Se activa cuando atraca el objeto observado.
section: reference
kind: api
status: reference
updated: 2026-10-27
tags: ["API","X4"]
sources: ["https://wiki.egosoft.com/X%20Rebirth%20Wiki/Modding%20support/Mission%20Director%20Guide/","https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## Descripción

Se activa cuando atraca el objeto observado.

## Datos del evento

| Campo | Tipo / función | Significado |
| --- | --- | --- |
| `event.object` | [Objeto MD](wiki:type-md-values) | Objeto de atraque. |
| `event.param` | [Objeto MD](wiki:type-md-values) | Objeto Dock. |
| `event.param2` | [Zona MD](wiki:type-md-values) | Zona de atraque. |
| `event.param3` | [Bahía de atraque MD](wiki:type-md-values) | Atraque. |

Las etiquetas MD describen valores MD y roles semánticos de objetos, no tipos Lua. unknown indica que la fuente no declara la representación exacta; no garantiza nil. No se presuponen campos del evento que no estén enumerados.

## Ejemplo de suscripción

Inserte este fragmento independiente en el nodo cues apropiado de su script MD. Renombrar WikiWatch cuando se utilicen varios ejemplos. El reproductor debe tener una nave primaria válida cuando el oyente esté habilitado; administrar la vida útil del oyente al cambiar el objeto observado.

```xml
<cue name="WikiWatch" instantiate="true" namespace="this">
  <conditions>
    <event_object_docked object="player.primaryship" />
  </conditions>
  <actions>
    <set_value name="$Object" exact="event.object" />
    <set_value name="$Dock" exact="event.param" />
    <set_value name="$Zone" exact="event.param2" />
    <set_value name="$DockingBay" exact="event.param3" />
    <debug_text text="'Wiki: event_object_docked received'" />
  </actions>
</cue>
```

## Qué ocurre

Cada evento que coincide crea una instancia del manejador y copia los campos documentados a sus variables locales. Con la depuración de scripts activada, se espera esta marca de diagnóstico:

```text
Wiki: event_object_docked received
```

Es la salida esperada de un ejemplo didáctico independiente, no de una prueba completada en el juego. Las suscripciones observan eventos sin iniciar la acción de juego subyacente. Evita llenar el log con un mensaje por evento cuando se dispara con frecuencia.
## Filtros de suscripción XML

Estos atributos filtran eventos; no son los campos de datos del evento de la tabla anterior. [Tipos de esquema](wiki:schema-types).

`libraries/common.xsd`

| Atributo | Tipo de esquema | Requerido | Predeterminado / fijo |
| --- | --- | --- | --- |
| `chance` | [`expression`](wiki:schema-expression-b8bc0e4f) | no | no declarada |
| `comment` | [`comment`](wiki:schema-comment-c44bb2fd) | no | no declarada |
| `object` | [`expression`](wiki:schema-expression-b8bc0e4f) | no | no declarada |
| `group` | [`groupeventsource`](wiki:schema-groupeventsource-6492ab7b) | no | no declarada |
| `check` | [`checkeventsource`](wiki:schema-checkeventsource-7c8f079b) | no | no declarada |
| `dock` | [`container`](wiki:schema-container-a42d5197) | no | no declarada |
| `zone` | [`zone`](wiki:schema-zone-543e33c4) | no | no declarada |

## Valor devuelto

Es una condición de evento MD, no una función que devuelve una tupla Lua. Lee event.object/event.param en el contexto de acciones MD correspondiente.

## Evidencia del contrato

La correspondencia de campos se contrastó con las anotaciones common.xsd / md.xsd de X4 9.00 (611726). Solo se publican explicaciones propias y ejemplos independientes. La validez del XML por sí sola no demuestra un efecto en el juego.

[Tipos y métodos](wiki:types) · [Cues de MD](wiki:md-cues) · [Depuración](wiki:debugging)