---
title: find_ship
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`

| 属性 | 架构类型 | 要求 | 默认 / 固定 |
| --- | --- | --- | --- |
| `chance` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `weight` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `comment` | [`comment`](wiki:schema-comment-c44bb2fd) | 没有 | 没有申报 |
| `normalcluster` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `presentationcluster` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `venturercluster` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `explorationcluster` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `macro` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `owner` | [`owners`](wiki:schema-owners-6f0e3a8c) | 没有 | 没有申报 |
| `trueowner` | [`owners`](wiki:schema-owners-6f0e3a8c) | 没有 | 没有申报 |
| `coverowner` | [`owners`](wiki:schema-owners-6f0e3a8c) | 没有 | 没有申报 |
| `policefaction` | [`owners`](wiki:schema-owners-6f0e3a8c) | 没有 | 没有申报 |
| `negateownerfilter` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `tag` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `excluded` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `grouptag` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `shieldgrouptag` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `state` | [`componentstateexprlookup`](wiki:schema-componentstateexprlookup-ab71703f) | 没有 | 没有申报 |
| `integrated` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `invulnerable` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `hullinvulnerable` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `shieldinvulnerable` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `indestructible` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `checkoperational` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `functional` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `surfaceelement` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `module` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `known` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `knownto` | [`factionexprlookup`](wiki:schema-factionexprlookup-6ea384ee) | 没有 | 没有申报 |
| `isinliveview` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `destination` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `hastradeoffer` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `tradesknownto` | [`factionexprlookup`](wiki:schema-factionexprlookup-6ea384ee) | 没有 | 没有申报 |
| `canhavedynamicinterior` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `canhaveofferlocation` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `freemissionofferslot` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `freesignalleakslot` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `numfreeactorslots` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `freemissionactorslot` | [`freemissionactorslot`](wiki:schema-freemissionactorslot-70522aa4) | 没有 | 没有申报 |
| `masstraffic` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `regionobject` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `onlineobject` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `venture` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `visitor` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `walkable` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `haswalkableroom` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `locked` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `roompopulationtype` | [`roompopulationtypeexprlookup`](wiki:schema-roompopulationtypeexprlookup-ff3130df) | 没有 | 没有申报 |
| `building` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `busy` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `hasbuildingtask` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `hasfixedconstruction` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `hasstagedconstruction` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `canbebuiltby` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `canbebuiltbyany` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `canbuildfor` | [`factionexprlookup`](wiki:schema-factionexprlookup-6ea384ee) | 没有 | 没有申报 |
| `canbuildclass` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `canbuildships` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `canequipclass` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `cansupplyclass` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `canequipships` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `cansupplyships` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `canbuildequipment` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `canbuildmacro` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `waretransport` | [`waretransportlookup`](wiki:schema-waretransportlookup-7add9c14) | 没有 | 没有申报 |
| `weaponmode` | [`weaponmodelookup`](wiki:schema-weaponmodelookup-9f01ea8b) | 没有 | 没有申报 |
| `weapontype` | [`weapontypelookup`](wiki:schema-weapontypelookup-de2d587c) | 没有 | 没有申报 |
| `primarypurpose` | [`purposelookup`](wiki:schema-purposelookup-955966b0) | 没有 | 没有申报 |
| `deployable` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `datavault` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `landmark` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `deployablecategory` | [`deployablecategorylookup`](wiki:schema-deployablecategorylookup-c0f83070) | 没有 | 没有申报 |
| `mayattack` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `maybeattackedby` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `ishostileto` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `canbepickedup` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `commandeerable` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `unit` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `hascommander` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `hascontrolentity` | [`controlpost`](wiki:schema-controlpost-7bcf4ba7) | 没有 | 没有申报 |
| `capturable` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `accelerator` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `superhighwaygate` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `active` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `paused` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `pausedmanually` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `signalleaktype` | [`signalleaktypelookup`](wiki:schema-signalleaktypelookup-6261bbdb) | 没有 | 没有申报 |
| `extension` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `personalextension` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `covered` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `canbedismantled` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `canbetowed` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `reachablefrom` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `physicsareready` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `canbelivestreamed` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `internallystored` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `docked` | [`docked`](wiki:schema-docked-f8f22ee3) | 没有 | 没有申报 |
| `shiptype` | [`shiptypeexprlookup`](wiki:schema-shiptypeexprlookup-7c3b46ad) | 没有 | 没有申报 |
| `hasjob` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `job` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `validjobship` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `jobtags` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `requestedjobship` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `subordinatejobship` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `encounterid` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `encountership` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `class` | [`shipclasslookup`](wiki:schema-shipclasslookup-73b4e416) | 没有 | 没有申报 |
| `godshipentry` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `space` | [`spacelist`](wiki:schema-spacelist-5dce5422) | 没有 | 没有申报 |
| `append` | [`findappend`](wiki:schema-findappend-c485cc76) | 没有 | 没有申报 |
| `multiple` | [`findmultiple`](wiki:schema-findmultiple-b94a146b) | 没有 | 没有申报 |
| `required` | [`findrequired`](wiki:schema-findrequired-b9b6ae34) | 没有 | 没有申报 |
| `recursive` | [`findrecursive`](wiki:schema-findrecursive-6e6926f0) | 没有 | 没有申报 |
| `sortbydistanceto` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `sortbygatedistancefrom` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `sortbygatedistanceto` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `sortbyvalue` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `sortdescending` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | 没有 | 没有申报 |
| `sortlimit` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `name` | [`lvaluename`](wiki:schema-lvaluename-743c13fb) | 没有 | 没有申报 |
| `groupname` | [`groupname`](wiki:schema-groupname-27041f4e) | 没有 | 没有申报 |

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

## 示例与上下文

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