---
title: MD/AI engine events
summary: 36 API entries with return and parameter types.
section: reference
kind: guide
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"]
---
## Contents

[Types and methods](wiki:types). Parameter and result types refer to the stated X4 layer; unknown contracts are explicit.

## Player

| Call / event | Returns |
| --- | --- |
| [event_player_interaction](wiki:api-mdevent-event-player-interaction-f7377df5) | event data |

## UI and conversations

| Call / event | Returns |
| --- | --- |
| [event_conversation_finished](wiki:api-mdevent-event-conversation-finished-31ce806b) | event data |
| [event_conversation_next_section](wiki:api-mdevent-event-conversation-next-section-6daef6fe) | event data |
| [event_conversation_returned_to_section](wiki:api-mdevent-event-conversation-returned-to-section-015aa69d) | event data |
| [event_conversation_started](wiki:api-mdevent-event-conversation-started-f03035b6) | event data |
| [event_ui_triggered](wiki:api-mdevent-event-ui-triggered-42d57c8c) | event data |

## World and lifecycle

| Call / event | Returns |
| --- | --- |
| [event_boarding_operation_created](wiki:api-mdevent-event-boarding-operation-created-548984d4) | event data |
| [event_character_animation_finished](wiki:api-mdevent-event-character-animation-finished-8f6be6a0) | event data |
| [event_character_animation_started](wiki:api-mdevent-event-character-animation-started-32dbc6a4) | event data |
| [event_countermeasure_launched](wiki:api-mdevent-event-countermeasure-launched-aa0600f9) | event data |
| [event_cue_signalled](wiki:api-mdevent-event-cue-signalled-f5965070) | event data |
| [event_cutscene_started](wiki:api-mdevent-event-cutscene-started-e7781371) | event data |
| [event_cutscene_stopped](wiki:api-mdevent-event-cutscene-stopped-f23fd1e6) | event data |
| [event_game_loaded](wiki:api-mdevent-event-game-loaded-2f8b85b5) | event data |
| [event_game_saved](wiki:api-mdevent-event-game-saved-e4614da1) | event data |
| [event_long_range_scan_sent](wiki:api-mdevent-event-long-range-scan-sent-e232eb0a) | event data |
| [event_weapon_fired](wiki:api-mdevent-event-weapon-fired-36346bd2) | event data |

## Objects

| Call / event | Returns |
| --- | --- |
| [event_object_changed_true_owner](wiki:api-mdevent-event-object-changed-true-owner-d4bd10fc) | event data |
| [event_object_collided](wiki:api-mdevent-event-object-collided-ea144cb6) | event data |
| [event_object_destroyed](wiki:api-mdevent-event-object-destroyed-31ba2d1a) | event data |
| [event_object_dock_too_far](wiki:api-mdevent-event-object-dock-too-far-5a6ff60d) | event data |
| [event_object_docked](wiki:api-mdevent-event-object-docked-76ee1269) | event data |
| [event_object_docking_aborted](wiki:api-mdevent-event-object-docking-aborted-97c4753f) | event data |
| [event_object_docking_denied](wiki:api-mdevent-event-object-docking-denied-2f977468) | event data |
| [event_object_docking_impossible](wiki:api-mdevent-event-object-docking-impossible-f9c10915) | event data |
| [event_object_docking_queued](wiki:api-mdevent-event-object-docking-queued-034898e8) | event data |
| [event_object_order_cancelled](wiki:api-mdevent-event-object-order-cancelled-de014228) | event data |
| [event_object_order_finished](wiki:api-mdevent-event-object-order-finished-6bcd7797) | event data |
| [event_object_order_ready](wiki:api-mdevent-event-object-order-ready-e783d19a) | event data |
| [event_object_signalled](wiki:api-mdevent-event-object-signalled-5d5b1715) | event data |
| [event_object_undocked_from](wiki:api-mdevent-event-object-undocked-from-a9b8b9e5) | event data |
| [event_object_undocking_started](wiki:api-mdevent-event-object-undocking-started-887ea3ea) | event data |

## Trade and construction

| Call / event | Returns |
| --- | --- |
| [event_build_added](wiki:api-mdevent-event-build-added-e177e0e5) | event data |
| [event_build_cancelled](wiki:api-mdevent-event-build-cancelled-ab070aea) | event data |
| [event_build_finished](wiki:api-mdevent-event-build-finished-7629377f) | event data |
| [event_trade_completed](wiki:api-mdevent-event-trade-completed-6c57c245) | event data |