---
title: macro - X4 架构类型
summary: macro: X4 属性架构类型：基础类型、约束与可选值。
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/"]
---
## 含义

macro: X4 属性架构类型：基础类型、约束与可选值。

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

## 架构结构

`libraries/common.xsd`

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

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

## 示例与结果

根据下面的属性页面进行文本示例. 单独从类型名称中推断一个通用可执行的例子.

## 使用位置

| 元素 | 属性 | 架构 |
| --- | --- | --- |
| [`add_ammo`](wiki:api-md-add-ammo-63c792ae) | `macro` | `libraries/common.xsd` |
| [`add_build_to_construct_ship`](wiki:api-md-add-build-to-construct-ship-ea0eff82) | `macro` | `libraries/common.xsd` |
| [`create_lockbox`](wiki:api-md-create-lockbox-b0c24714) | `macro` | `libraries/common.xsd` |
| [`create_object`](wiki:api-md-create-object-c1cb2a4c) | `macro` | `libraries/common.xsd` |
| [`create_signal_leak`](wiki:api-md-create-signal-leak-376ceb34) | `macro` | `libraries/common.xsd` |
| [`create_station`](wiki:api-md-create-station-1e683e8a) | `macro` | `libraries/common.xsd` |
| [`launch_drone`](wiki:api-md-launch-drone-298f41e6) | `macro` | `libraries/common.xsd` |
| [`launch_lasertower`](wiki:api-md-launch-lasertower-3b6fb740) | `macro` | `libraries/common.xsd` |
| [`launch_mine`](wiki:api-md-launch-mine-1d2ce655) | `macro` | `libraries/common.xsd` |
| [`launch_navbeacon`](wiki:api-md-launch-navbeacon-9cf9ca1f) | `macro` | `libraries/common.xsd` |
| [`launch_resourceprobe`](wiki:api-md-launch-resourceprobe-0a15bde2) | `macro` | `libraries/common.xsd` |
| [`launch_satellite`](wiki:api-md-launch-satellite-512daf91) | `macro` | `libraries/common.xsd` |
| [`remove_ammo`](wiki:api-md-remove-ammo-41694ec0) | `macro` | `libraries/common.xsd` |
| [`set_ammo`](wiki:api-md-set-ammo-dde800a4) | `macro` | `libraries/common.xsd` |


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