---
title: event_boarding_operation_created
summary: 登舰行动创建时触发。创建行动不代表已成功夺取目标。
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/"]
---
## 说明

登舰行动创建时触发。创建行动不代表已成功夺取目标。

## 事件数据

| 字段 | 类型 / 用途 | 含义 |
| --- | --- | --- |
| `event.param` | [MD 登舰行动](wiki:type-md-values) | 新的登机行动. |

MD 标签描述 MD 值与对象的语义角色，并非 Lua 类型。unknown 表示来源未声明准确的表示方式，并不保证值为 nil。不要推断未列出的事件字段。

## 事件订阅示例

将此独立片段放入 MD 脚本中合适的 cues 节点。使用多个示例时，请为 WikiWatch 更名以免冲突。 

```xml
<cue name="WikiWatch" instantiate="true" namespace="this">
  <conditions>
    <event_boarding_operation_created />
  </conditions>
  <actions>
    <set_value name="$Operation" exact="event.param" />
    <debug_text text="'Wiki: event_boarding_operation_created received'" />
  </actions>
</cue>
```

## 运行效果

每次匹配的事件都会创建处理函数实例，并将已记录的字段复制到其局部变量。启用脚本调试后，预期出现以下诊断标记：

```text
Wiki: event_boarding_operation_created received
```

这是独立教学示例的预期输出，不是已完成的游戏测试。订阅只观察事件，不会触发对应的游戏操作。对于频繁触发的事件，请避免逐次记录日志造成刷屏。
## XML 订阅过滤条件

这些属性用于筛选事件，不是上表中的事件数据字段。 [架构类型](wiki:schema-types).

`libraries/common.xsd`

| 属性 | 架构类型 | 要求 | 默认 / 固定 |
| --- | --- | --- | --- |
| `chance` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `comment` | [`comment`](wiki:schema-comment-c44bb2fd) | 没有 | 没有申报 |

## 返回值

这是 MD 事件条件，而不是返回 Lua 元组的函数调用。请在对应的 MD 操作上下文中读取 event.object/event.param。

## 接口约定依据

字段映射已与本机 X4 9.00 (611726) 的 common.xsd / md.xsd 注释核对。本站仅发布独立编写的说明和示例。XML 有效并不能单独证明游戏效果。

[类型与方法](wiki:types) · [MD cue](wiki:md-cues) · [调试](wiki:debugging)