---
title: entity - X4 架构类型
summary: entity: 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/"]
---
## 含义

entity: 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。从基础类型继承的约束仍然有效。

## 示例与结果

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

## 使用位置

| 元素 | 属性 | 架构 |
| --- | --- | --- |
| [`abort_scripts`](wiki:api-md-abort-scripts-393da6ee) | `entity` | `libraries/common.xsd` |
| [`add_inventory`](wiki:api-md-add-inventory-63e96ff6) | `entity` | `libraries/common.xsd` |
| [`remove_inventory`](wiki:api-md-remove-inventory-c0df5d23) | `entity` | `libraries/common.xsd` |
| [`set_entity_role`](wiki:api-md-set-entity-role-136a3503) | `entity` | `libraries/common.xsd` |
| [`set_entity_type`](wiki:api-md-set-entity-type-732921d1) | `entity` | `libraries/common.xsd` |
| [`set_skill`](wiki:api-md-set-skill-b9c06b8d) | `entity` | `libraries/common.xsd` |


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