---
title: groupeventsource - X4 架构类型
summary: groupeventsource: 事件源对象组表达式。对象组必须存在，但可以为空，成员也可以变化。check 属性不适用于组事件源。
section: reference
kind: guide
status: reference
updated: 2026-10-27
tags: ["XSD","schema","types"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/","https://www.w3.org/TR/xmlschema11-2/"]
---
## 含义

groupeventsource: 事件源对象组表达式。对象组必须存在，但可以为空，成员也可以变化。check 属性不适用于组事件源。

XSD 类型约束 XML，并不声明 Lua 返回值或 event.param 的数据类型。通过架构验证不能证明游戏效果已经发生。

## 架构结构

`libraries/common.xsd`

| 属性 | 值 |
| --- | --- |
| 构造方式 | `restriction` |
| 基础类型 | [`expression`](wiki:schema-expression-b8bc0e4f) |

restriction 收紧基础类型的限制；union 接受其中一个类型分支；list 描述由空白分隔的项目。同一个限制中的 enumeration 值互为可选项。pattern 使用 XML Schema 正则表达式，不是 Lua 模式或 JavaScript RegExp。从基础类型继承的约束仍然有效。

## 示例与结果

```xml
<event_object_collided group="$WatchedShips" />
```

**运行效果：** 此条件监视预先创建的 MD 组 $WatchedShips 中的事件源；它不是任意的 Lua 表。

对象与对象组变量必须已在正确的 MD / AI 上下文中创建。这些是教学片段，并非完整可运行的任务。

## 使用位置

| 元素 | 属性 | 架构 |
| --- | --- | --- |
| [`event_build_added`](wiki:api-mdevent-event-build-added-e177e0e5) | `group` | `libraries/common.xsd` |
| [`event_build_cancelled`](wiki:api-mdevent-event-build-cancelled-ab070aea) | `group` | `libraries/common.xsd` |
| [`event_build_finished`](wiki:api-mdevent-event-build-finished-7629377f) | `group` | `libraries/common.xsd` |
| [`event_character_animation_finished`](wiki:api-mdevent-event-character-animation-finished-8f6be6a0) | `group` | `libraries/common.xsd` |
| [`event_character_animation_started`](wiki:api-mdevent-event-character-animation-started-32dbc6a4) | `group` | `libraries/common.xsd` |
| [`event_countermeasure_launched`](wiki:api-mdevent-event-countermeasure-launched-aa0600f9) | `group` | `libraries/common.xsd` |
| [`event_long_range_scan_sent`](wiki:api-mdevent-event-long-range-scan-sent-e232eb0a) | `group` | `libraries/common.xsd` |
| [`event_object_changed_true_owner`](wiki:api-mdevent-event-object-changed-true-owner-d4bd10fc) | `group` | `libraries/common.xsd` |
| [`event_object_collided`](wiki:api-mdevent-event-object-collided-ea144cb6) | `group` | `libraries/common.xsd` |
| [`event_object_destroyed`](wiki:api-mdevent-event-object-destroyed-31ba2d1a) | `group` | `libraries/common.xsd` |
| [`event_object_dock_too_far`](wiki:api-mdevent-event-object-dock-too-far-5a6ff60d) | `group` | `libraries/common.xsd` |
| [`event_object_docked`](wiki:api-mdevent-event-object-docked-76ee1269) | `group` | `libraries/common.xsd` |
| [`event_object_docking_aborted`](wiki:api-mdevent-event-object-docking-aborted-97c4753f) | `group` | `libraries/common.xsd` |
| [`event_object_docking_denied`](wiki:api-mdevent-event-object-docking-denied-2f977468) | `group` | `libraries/common.xsd` |
| [`event_object_docking_impossible`](wiki:api-mdevent-event-object-docking-impossible-f9c10915) | `group` | `libraries/common.xsd` |
| [`event_object_docking_queued`](wiki:api-mdevent-event-object-docking-queued-034898e8) | `group` | `libraries/common.xsd` |
| [`event_object_order_cancelled`](wiki:api-mdevent-event-object-order-cancelled-de014228) | `group` | `libraries/common.xsd` |
| [`event_object_order_finished`](wiki:api-mdevent-event-object-order-finished-6bcd7797) | `group` | `libraries/common.xsd` |
| [`event_object_order_ready`](wiki:api-mdevent-event-object-order-ready-e783d19a) | `group` | `libraries/common.xsd` |
| [`event_object_signalled`](wiki:api-mdevent-event-object-signalled-5d5b1715) | `group` | `libraries/common.xsd` |
| [`event_object_undocked_from`](wiki:api-mdevent-event-object-undocked-from-a9b8b9e5) | `group` | `libraries/common.xsd` |
| [`event_object_undocking_started`](wiki:api-mdevent-event-object-undocking-started-887ea3ea) | `group` | `libraries/common.xsd` |
| [`event_weapon_fired`](wiki:api-mdevent-event-weapon-fired-36346bd2) | `group` | `libraries/common.xsd` |
| [`signal_objects`](wiki:api-md-signal-objects-053867ba) | `group` | `libraries/common.xsd` |


[所有架构类型](wiki:schema-types) · [Lua / MD 值类型](wiki:types)