---
title: find_object_component
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"]
---
## Возвращаемое значение

| Тип | Значение |
| --- | --- |
| [`none`](wiki:type-results) (MD action) | Тип описывает объявленный интерфейс, а не успешный игровой эффект. |

[Типы и методы](wiki:types)

## Атрибуты XML

[Как устроены типы схем](wiki:schema-types)

`libraries/common.xsd`

| Атрибут | Тип из схемы | Обязателен | По умолчанию / fixed |
| --- | --- | --- | --- |
| `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) | нет | не объявлено |
| `restorable` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `repairable` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `needsrepair` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `race` | [`race`](wiki:schema-race-129ce50d) | нет | не объявлено |
| `npctemplate` | [`expression`](wiki:schema-expression-b8bc0e4f) | нет | не объявлено |
| `entitytype` | [`entitytype`](wiki:schema-entitytype-50fb582a) | нет | не объявлено |
| `entityrole` | [`entityrole`](wiki:schema-entityrole-e1b70787) | нет | не объявлено |
| `controlpost` | [`controlpost`](wiki:schema-controlpost-7bcf4ba7) | нет | не объявлено |
| `controlentity` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `missionactor` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `representative` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `diplomat` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `temporaryentity` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `roomtype` | [`roomtypeexprlookup`](wiki:schema-roomtypeexprlookup-fa689a28) | нет | не объявлено |
| `hascontrolpanel` | [`controlpaneltypelookup`](wiki:schema-controlpaneltypelookup-7b2d65a5) | нет | не объявлено |
| `contested` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `contestedby` | [`factionexprlookup`](wiki:schema-factionexprlookup-6ea384ee) | нет | не объявлено |
| `hasgravidarobscuringregion` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `hashazardousregion` | [`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) | нет | не объявлено |
| `stationtype` | [`stationtypeexprlookup`](wiki:schema-stationtypeexprlookup-016b1c1a) | нет | не объявлено |
| `hasmasstraffic` | [`hasmasstraffic`](wiki:schema-hasmasstraffic-35f7baf1) | нет | не объявлено |
| `canclaimownership` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `tradestation` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `shipyard` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `wharf` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `equipmentdock` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `defencestation` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `recyclingfacility` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `factionheadquarters` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `planneddefencestation` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `plannedrecyclingfacility` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `plannedequipmentdock` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `plannedfactionheadquarters` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `plannedheadquarters` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `plannedpiratebase` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `plannedshipyard` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `plannedtradestation` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `plannedwharf` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `headquarters` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `piratebase` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `alwaysnormalzone` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `normalzone` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `tempzone` | [`booleanexpression`](wiki:schema-booleanexpression-1c6e91c7) | нет | не объявлено |
| `accessgrantedto` | [`factionexprlookup`](wiki:schema-factionexprlookup-6ea384ee) | нет | не объявлено |
| `accessrestrictedto` | [`factionexprlookup`](wiki:schema-factionexprlookup-6ea384ee) | нет | не объявлено |
| `jobspacefor` | [`expression`](wiki:schema-expression-b8bc0e4f) | нет | не объявлено |
| `locationtag` | [`expression`](wiki:schema-expression-b8bc0e4f) | нет | не объявлено |
| `locationtagany` | [`expression`](wiki:schema-expression-b8bc0e4f) | нет | не объявлено |
| `class` | [`classlookup`](wiki:schema-classlookup-a3b06fd2) | нет | не объявлено |
| `exactclass` | [`classlookup`](wiki:schema-classlookup-a3b06fd2) | нет | не объявлено |
| `object` | [`expression`](wiki:schema-expression-b8bc0e4f) | да | не объявлено |
| `append` | [`findappend`](wiki:schema-findappend-c485cc76) | нет | не объявлено |
| `multiple` | [`findmultiple`](wiki:schema-findmultiple-b94a146b) | нет | не объявлено |
| `required` | [`findrequired`](wiki:schema-findrequired-b9b6ae34) | нет | не объявлено |
| `recursive` | [`findrecursive`](wiki:schema-findrecursive-6e6926f0) | нет | не объявлено |
| `includeobjects` | [`findincludeobjects`](wiki:schema-findincludeobjects-9bf43173) | нет | не объявлено |
| `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). Там приведены самостоятельные учебные примеры. Исходные файлы проектов и фрагменты их внутренней реализации в этом справочнике не распространяются.