Meaning#

lvalueexpression: An expression identifying a writable destination, such as an MD variable; it is distinct from a Lua return.

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 xs:string
Constraint Value
pattern *[$][a-zA-Z0-9_]+ *
pattern *[A-Za-z_$(]([A-Za-z0-9_$!?@=<>,.+\-*/%\^(){}\[\] ]|(#?'([^'\\]|\\.)*'))*\. *((\{([A-Za-z0-9_$!?@=<>,.+\-*/%\^(){}\[\] ]|(#?'([^'\\]|\\.)*'))+\})|([$][a-zA-Z0-9_]+)|(last)) *
pattern *(stat|userdata) *\. *[a-zA-Z_][a-zA-Z0-9_]* *

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
<set_value name="$Count" exact="3" />

What happens: After set_value, $Count contains 3; nothing is logged.

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_actor_to_room result libraries/common.xsd
add_cargo result libraries/common.xsd
assign_control_entity result libraries/common.xsd
assign_hired_actor success libraries/common.xsd
assign_hired_actor failed libraries/common.xsd
can_safely_extend_build_plot result libraries/common.xsd
check_any counter libraries/aiscripts.xsd
check_any counter libraries/md.xsd
create_group groupname libraries/common.xsd
create_loadout result libraries/common.xsd
create_trade_computer result libraries/common.xsd
do_all counter libraries/aiscripts.xsd
do_all counter libraries/md.xsd
do_for_each counter libraries/aiscripts.xsd
do_for_each name libraries/aiscripts.xsd
do_for_each valuename libraries/aiscripts.xsd
do_for_each counter libraries/md.xsd
do_for_each name libraries/md.xsd
do_for_each valuename libraries/md.xsd
drop_cargo groupname libraries/common.xsd
drop_cargo wares libraries/common.xsd
drop_cargo amounts libraries/common.xsd
find_closest_resource zone libraries/common.xsd
find_closest_resource sector libraries/common.xsd
find_closest_resource distance libraries/common.xsd
find_closest_resource position libraries/common.xsd
find_closest_resource resourcearea libraries/common.xsd
find_resource_area name libraries/common.xsd
find_sector_in_range distances libraries/common.xsd
get_loadout result libraries/common.xsd
get_ship_definition macro libraries/common.xsd
get_ship_definition reference libraries/common.xsd
launch_countermeasures result libraries/common.xsd
move_order result libraries/common.xsd
play_cutscene result libraries/common.xsd
remove_cargo result libraries/common.xsd
reserve_build_plot result libraries/common.xsd
result killed libraries/common.xsd
result module libraries/common.xsd
result surfaceelement libraries/common.xsd
result sequence libraries/common.xsd
result removed libraries/common.xsd
result cost libraries/common.xsd
result context libraries/common.xsd
result position libraries/common.xsd
result room libraries/common.xsd
result tags libraries/common.xsd
result total libraries/common.xsd
result hullshield libraries/common.xsd
result hullonly libraries/common.xsd
result shieldonly libraries/common.xsd
result hullnoshield libraries/common.xsd
result shielddisruption libraries/common.xsd
result trader libraries/common.xsd
result tradepartner libraries/common.xsd
transfer_money result libraries/common.xsd

All schema types · Lua / MD value types