Beschreibung#
Wird ausgelöst, wenn sich das beobachtete Objekt für eine freie Dockbucht einreiht.
Ereignisdaten#
| Feld | Typ / Bedeutung | Bedeutung |
|---|---|---|
event.object |
MD-Objekt | Angegebenes Objekt; hier werden keine zusätzlichen Param-Felder dokumentiert. |
MD-Bezeichnungen beschreiben MD-Werte und semantische Objektrollen, keine Lua-Typen. unknown bedeutet, dass die Quelle die genaue Darstellung nicht festlegt; es verspricht kein nil. Nicht aufgeführte Ereignisfelder werden nicht vorausgesetzt.
Abonnement-Beispiel#
Fügen Sie dieses unabhängige Fragment in den entsprechenden Cues-Knoten Ihres MD-Skripts ein. Benennen Sie WikiWatch bei Verwendung mehrerer Beispiele um. Der Player muss ein gültiges Primärschiff haben, wenn der Hörer aktiviert ist; die Lebensdauer des Hörers beim Ändern des beobachteten Objekts verwalten.
<cue name="WikiWatch" instantiate="true" namespace="this">
<conditions>
<event_object_docking_queued object="player.primaryship" />
</conditions>
<actions>
<set_value name="$Object" exact="event.object" />
<debug_text text="'Wiki: event_object_docking_queued received'" />
</actions>
</cue>Was geschieht#
Jedes passende Ereignis erstellt eine Handler-Instanz und kopiert die dokumentierten Felder in ihre lokalen Variablen. Bei aktivierter Skriptdiagnose wird folgende Meldung erwartet:
Wiki: event_object_docking_queued receivedDies ist die erwartete Ausgabe eines unabhängigen Lernbeispiels und kein abgeschlossener Spieltest. Abonnements beobachten Ereignisse, ohne die eigentliche Spielaktion auszulösen. Vermeide bei häufigen Ereignissen eine Protokollmeldung pro Ereignis.
XML-Abonnementfilter#
Diese Attribute filtern Ereignisse; sie sind nicht die oben genannten Ereignisdatenfelder. Schematypen.
libraries/common.xsd
| Attribut | Schematyp | Erforderlich | Standard / festgelegt |
|---|---|---|---|
chance |
expression |
Nein | nicht deklariert |
comment |
comment |
Nein | nicht deklariert |
object |
expression |
Nein | nicht deklariert |
group |
groupeventsource |
Nein | nicht deklariert |
check |
checkeventsource |
Nein | nicht deklariert |
Rückgabewert#
Dies ist eine MD-Ereignisbedingung, kein Funktionsaufruf mit einem Lua-Tupel als Rückgabe. Lies event.object/event.param im zugehörigen MD-Aktionskontext.
Vertragsgrundlage#
Die Feldzuordnung wurde mit den Anmerkungen in common.xsd / md.xsd der installierten X4 9.00 (611726) abgeglichen. Veröffentlicht werden eigene Erklärungen und unabhängige Beispiele. Gültiges XML allein beweist keinen Effekt im Spiel.