---
title: object - X4 schema type
summary: object: An expression whose interface expects an X4 object reference. Valid syntax does not establish that an object exists.
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/"]
---
## Meaning

object: An expression whose interface expects an X4 object reference. Valid syntax does not establish that an object exists.

An XSD type constrains XML, rather than declaring a Lua return or the payload type of event.param. A valid schema value does not prove a successful game effect.

## Schema structure

`libraries/common.xsd`

| Property | Value |
| --- | --- |
| Construction | `restriction` |
| Base type | [`expression`](wiki:schema-expression-b8bc0e4f) |

restriction narrows a base type; union accepts one of its branches; list describes whitespace-separated items. Enumeration values in one restriction are alternatives. Pattern syntax is XML Schema regex, not Lua patterns or JavaScript RegExp. Constraints inherited from the base type still apply.

## Example and result

```xml
<event_object_collided object="$Ship" otherobject="$Other" />
```

**What happens:** $Other must refer to an appropriate existing object. The condition filters collisions with it; it does not create a collision.

Object and group variables must already exist in the correct MD / AI context. These are learning fragments, not a complete runnable mission.

## Used by

| Element | Attribute | Schema |
| --- | --- | --- |
| [`add_ammo`](wiki:api-md-add-ammo-63c792ae) | `object` | `libraries/common.xsd` |
| [`add_cargo`](wiki:api-md-add-cargo-d6b6d899) | `object` | `libraries/common.xsd` |
| [`add_data`](wiki:api-md-add-data-9b287901) | `object` | `libraries/common.xsd` |
| [`add_money`](wiki:api-md-add-money-63d3a193) | `object` | `libraries/common.xsd` |
| [`add_player_discount`](wiki:api-md-add-player-discount-6074b9f2) | `object` | `libraries/common.xsd` |
| [`add_units`](wiki:api-md-add-units-23c4b9d6) | `object` | `libraries/common.xsd` |
| [`assign_control_entity`](wiki:api-md-assign-control-entity-64681450) | `object` | `libraries/common.xsd` |
| [`cancel_all_orders`](wiki:api-md-cancel-all-orders-eb6aa9b5) | `object` | `libraries/common.xsd` |
| [`collect_drop`](wiki:api-md-collect-drop-a3da2980) | `object` | `libraries/common.xsd` |
| [`collect_drop`](wiki:api-md-collect-drop-a3da2980) | `drop` | `libraries/common.xsd` |
| [`create_control_entity`](wiki:api-md-create-control-entity-14390534) | `object` | `libraries/common.xsd` |
| [`create_npc_template`](wiki:api-md-create-npc-template-a003e889) | `object` | `libraries/common.xsd` |
| [`create_order`](wiki:api-md-create-order-91246f05) | `object` | `libraries/common.xsd` |
| [`create_trade_computer`](wiki:api-md-create-trade-computer-1fac0bf4) | `object` | `libraries/common.xsd` |
| [`create_trade_offer`](wiki:api-md-create-trade-offer-d9bc6d87) | `seller` | `libraries/common.xsd` |
| [`create_trade_offer`](wiki:api-md-create-trade-offer-d9bc6d87) | `buyer` | `libraries/common.xsd` |
| [`create_trade_offer`](wiki:api-md-create-trade-offer-d9bc6d87) | `object` | `libraries/common.xsd` |
| [`create_trade_order`](wiki:api-md-create-trade-order-206b09fb) | `object` | `libraries/common.xsd` |
| [`destroy_object`](wiki:api-md-destroy-object-ec7b8e6e) | `object` | `libraries/common.xsd` |
| [`disable_collision_response`](wiki:api-md-disable-collision-response-b798ddae) | `object` | `libraries/common.xsd` |
| [`dismiss_control_entity`](wiki:api-md-dismiss-control-entity-d30a7464) | `object` | `libraries/common.xsd` |
| [`downgrade_software`](wiki:api-md-downgrade-software-3b6c1586) | `object` | `libraries/common.xsd` |
| [`drop_cargo`](wiki:api-md-drop-cargo-9784a5bc) | `object` | `libraries/common.xsd` |
| [`enable_collision_response`](wiki:api-md-enable-collision-response-aa9582fb) | `object` | `libraries/common.xsd` |
| [`event_object_collided`](wiki:api-mdevent-event-object-collided-ea144cb6) | `otherobject` | `libraries/common.xsd` |
| [`find_inventoryconsole_slot`](wiki:api-md-find-inventoryconsole-slot-223b58a4) | `object` | `libraries/common.xsd` |
| [`find_inventoryworkbench_slot`](wiki:api-md-find-inventoryworkbench-slot-67c4c9a5) | `object` | `libraries/common.xsd` |
| [`find_resource_area`](wiki:api-md-find-resource-area-d5916d00) | `ware` | `libraries/common.xsd` |
| [`get_control_entities`](wiki:api-md-get-control-entities-7228787c) | `object` | `libraries/common.xsd` |
| [`get_floor_position`](wiki:api-md-get-floor-position-9cd7638b) | `object` | `libraries/common.xsd` |
| [`install_software`](wiki:api-md-install-software-159ae6ae) | `object` | `libraries/common.xsd` |
| [`launch_countermeasures`](wiki:api-md-launch-countermeasures-8cb7ea27) | `object` | `libraries/common.xsd` |
| [`launch_drone`](wiki:api-md-launch-drone-298f41e6) | `object` | `libraries/common.xsd` |
| [`launch_lasertower`](wiki:api-md-launch-lasertower-3b6fb740) | `object` | `libraries/common.xsd` |
| [`launch_mine`](wiki:api-md-launch-mine-1d2ce655) | `object` | `libraries/common.xsd` |
| [`launch_navbeacon`](wiki:api-md-launch-navbeacon-9cf9ca1f) | `object` | `libraries/common.xsd` |
| [`launch_resourceprobe`](wiki:api-md-launch-resourceprobe-0a15bde2) | `object` | `libraries/common.xsd` |
| [`launch_satellite`](wiki:api-md-launch-satellite-512daf91) | `object` | `libraries/common.xsd` |
| [`leave_formation`](wiki:api-md-leave-formation-e5215803) | `object` | `libraries/common.xsd` |
| [`pause_spacesuit_oxygen`](wiki:api-md-pause-spacesuit-oxygen-b2e51c13) | `object` | `libraries/common.xsd` |
| [`reassign_existing_people`](wiki:api-md-reassign-existing-people-6f16647a) | `object` | `libraries/common.xsd` |
| [`reinitialise_control_entities`](wiki:api-md-reinitialise-control-entities-519dba57) | `object` | `libraries/common.xsd` |
| [`remove_ammo`](wiki:api-md-remove-ammo-41694ec0) | `object` | `libraries/common.xsd` |
| [`remove_build`](wiki:api-md-remove-build-a7205997) | `object` | `libraries/common.xsd` |
| [`remove_cargo`](wiki:api-md-remove-cargo-c02ea811) | `object` | `libraries/common.xsd` |
| [`remove_data`](wiki:api-md-remove-data-c32be45e) | `object` | `libraries/common.xsd` |
| [`remove_from_group`](wiki:api-md-remove-from-group-0e4a65e7) | `object` | `libraries/common.xsd` |
| [`remove_money`](wiki:api-md-remove-money-fc0e4ee1) | `object` | `libraries/common.xsd` |
| [`remove_npc_template`](wiki:api-md-remove-npc-template-cc6205ae) | `object` | `libraries/common.xsd` |
| [`remove_object_account`](wiki:api-md-remove-object-account-1557c0dd) | `object` | `libraries/common.xsd` |
| [`remove_object_commander`](wiki:api-md-remove-object-commander-c6c5dab9) | `object` | `libraries/common.xsd` |
| [`remove_player_discount`](wiki:api-md-remove-player-discount-39d14cb8) | `object` | `libraries/common.xsd` |
| [`remove_trade_offer`](wiki:api-md-remove-trade-offer-6e77e3db) | `object` | `libraries/common.xsd` |
| [`remove_units`](wiki:api-md-remove-units-9e26dde5) | `object` | `libraries/common.xsd` |
| [`safepos`](wiki:api-md-safepos-ce75fb7d) | `ignored` | `libraries/common.xsd` |
| [`set_ammo`](wiki:api-md-set-ammo-dde800a4) | `object` | `libraries/common.xsd` |
| [`set_entity_overrides`](wiki:api-md-set-entity-overrides-ae976120) | `entity` | `libraries/common.xsd` |
| [`set_entity_traits`](wiki:api-md-set-entity-traits-39475b7a) | `entity` | `libraries/common.xsd` |
| [`set_npc_template_role`](wiki:api-md-set-npc-template-role-9208789c) | `object` | `libraries/common.xsd` |
| [`set_object_account`](wiki:api-md-set-object-account-cf77fc30) | `object` | `libraries/common.xsd` |
| [`set_object_active`](wiki:api-md-set-object-active-3f5db808) | `object` | `libraries/common.xsd` |
| [`set_object_commander`](wiki:api-md-set-object-commander-f90a9d5e) | `object` | `libraries/common.xsd` |
| [`set_object_fleet_name`](wiki:api-md-set-object-fleet-name-8ed159bb) | `object` | `libraries/common.xsd` |
| [`set_object_hull`](wiki:api-md-set-object-hull-b5fc7ce6) | `object` | `libraries/common.xsd` |
| [`set_object_max_budget`](wiki:api-md-set-object-max-budget-f0b393e4) | `object` | `libraries/common.xsd` |
| [`set_object_min_budget`](wiki:api-md-set-object-min-budget-142a4d25) | `object` | `libraries/common.xsd` |
| [`set_object_min_hull`](wiki:api-md-set-object-min-hull-5d7a6421) | `object` | `libraries/common.xsd` |
| [`set_object_name`](wiki:api-md-set-object-name-41b4da60) | `object` | `libraries/common.xsd` |
| [`set_object_shield`](wiki:api-md-set-object-shield-3027fdca) | `object` | `libraries/common.xsd` |
| [`set_object_velocity`](wiki:api-md-set-object-velocity-42fde00a) | `object` | `libraries/common.xsd` |
| [`set_owner`](wiki:api-md-set-owner-db23a477) | `object` | `libraries/common.xsd` |
| [`set_room_locked`](wiki:api-md-set-room-locked-34d3f68b) | `room` | `libraries/common.xsd` |
| [`set_skill`](wiki:api-md-set-skill-b9c06b8d) | `object` | `libraries/common.xsd` |
| [`set_spacesuit_oxygen`](wiki:api-md-set-spacesuit-oxygen-4926a446) | `object` | `libraries/common.xsd` |
| [`set_turret_targets`](wiki:api-md-set-turret-targets-7fcd336d) | `object` | `libraries/common.xsd` |
| [`spawn_docked`](wiki:api-md-spawn-docked-8c1b6c68) | `dock` | `libraries/common.xsd` |
| [`start_script`](wiki:api-md-start-script-0e91a769) | `object` | `libraries/common.xsd` |
| [`teleport_player`](wiki:api-md-teleport-player-49723658) | `object` | `libraries/common.xsd` |
| [`uninstall_software`](wiki:api-md-uninstall-software-2fc2d363) | `object` | `libraries/common.xsd` |
| [`unpause_spacesuit_oxygen`](wiki:api-md-unpause-spacesuit-oxygen-e4d2f56b) | `object` | `libraries/common.xsd` |
| [`warp`](wiki:api-md-warp-f234d348) | `object` | `libraries/common.xsd` |


[All schema types](wiki:schema-types) · [Lua / MD value types](wiki:types)