---
title: safepos
summary: X4 接口参考。类型只在明确说明的范围内得到确认。
section: reference
kind: api
status: reference
updated: 2026-10-26
tags: ["API","X4"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/","https://www.lua.org/manual/5.1/manual.html","https://luajit.org/ext_ffi_api.html"]
---
## 说明

X4 接口参考。类型只在明确说明的范围内得到确认。

## 返回值

| 类型 | 含义 |
| --- | --- |
| [`none`](wiki:type-results) (MD行动) | 类型描述了声明的界面,而不是证明成功的游戏效果. |

[类型与方法](wiki:types)

## XML 属性

[方案类型的运行方式](wiki:schema-types)

`libraries/common.xsd`

| 属性 | 架构类型 | 要求 | 默认 / 固定 |
| --- | --- | --- | --- |
| `allowyaxis` | [`boolean`](wiki:schema-boolean-bf84d3d6) | 没有 | 没有申报 |
| `radius` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `x` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `y` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `z` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `value` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `randomoffset` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `object` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `space` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `exact` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `list` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `min` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `max` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `profile` | [`profilelookup`](wiki:schema-profilelookup-a6f1cc04) | 没有 | 没有申报 |
| `scale` | [`inline:safepos@scale`](wiki:schema-inline-safepos-scale-f14f28cf) | 没有 | 没有申报 |
| `seed` | [`fixedrandomseed`](wiki:schema-fixedrandomseed-6fa38dae) | 没有 | 没有申报 |
| `autoadvanceseed` | [`autoadvancerandomseed`](wiki:schema-autoadvancerandomseed-1fb31fa3) | 没有 | 没有申报 |
| `ignored` | [`object`](wiki:schema-object-2958d416) | 没有 | 没有申报 |
| `includefiringrange` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `includeplotbox` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `ignoredangerousregions` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `comment` | [`comment`](wiki:schema-comment-c44bb2fd) | 没有 | 没有申报 |

`libraries/common.xsd`

| 属性 | 架构类型 | 要求 | 默认 / 固定 |
| --- | --- | --- | --- |
| `allowyaxis` | [`boolean`](wiki:schema-boolean-bf84d3d6) | 没有 | 没有申报 |
| `radius` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `angle` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `direction` | [`quadrantlookup`](wiki:schema-quadrantlookup-9a6dea27) | 没有 | 没有申报 |
| `direction2` | [`quadrantlookup`](wiki:schema-quadrantlookup-9a6dea27) | 没有 | 没有申报 |
| `directionobject` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `x` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `y` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `z` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `value` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `randomoffset` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `object` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `space` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `exact` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `list` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `min` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `max` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `profile` | [`profilelookup`](wiki:schema-profilelookup-a6f1cc04) | 没有 | 没有申报 |
| `scale` | [`inline:safepos@scale`](wiki:schema-inline-safepos-scale-f14f28cf) | 没有 | 没有申报 |
| `seed` | [`fixedrandomseed`](wiki:schema-fixedrandomseed-6fa38dae) | 没有 | 没有申报 |
| `autoadvanceseed` | [`autoadvancerandomseed`](wiki:schema-autoadvancerandomseed-1fb31fa3) | 没有 | 没有申报 |
| `ignored` | [`object`](wiki:schema-object-2958d416) | 没有 | 没有申报 |
| `includefiringrange` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `includeplotbox` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `ignoredangerousregions` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `comment` | [`comment`](wiki:schema-comment-c44bb2fd) | 没有 | 没有申报 |

MD 操作可以写入命名变量或改变游戏世界。这不是 Lua 返回值。输出变量取决于操作及其属性。

## 示例与上下文

看到 [语言基础](wiki:x4-code-basics), [类型和方法](wiki:types) 和 [Lua / MD事件](wiki:md-lua-bridge). 其他独立学习的例子. 没有项目源文件或私人实施碎片被分配到此引用.