Subentities may now be declared as dictionaries instead of magic strings. This improves readability and flexibility (i.e. it makes it easier to add new attributes).
A subentity dictionary may have any of the following types, specified by the “type” entry: “standard”, “flasher” or “ball_turret”. No type entry implies “standard”. All subentities have an optional “position” entry, which is a vector specifier – a string with three space-separated numbers, or an array with three numbers. (The default is (0, 0, 0).)
Standard and ball-turret subentities are required to have a “subentity_key” entry, whose value is a ship key. They also have optional orientation (quaternion specifier – string with four space-separated numbers or array with four numbers; default is the identity quaternion).
Standard subentities may have an “is_dock” entry whose value is a boolean.
This replaces the use of “dock” in the subentity key when using dictionaries to specify subentities; old-style subentities work as before.
Ball-turret subentities may have a “fire_rate” entry, whose value is a floating-point number greater than or equal to 0.25 (default: 0.5).
Flasher subentities have the following attributes, other than type and position: size, frequency and phase, which correspond to parts of the old-style strings (defaults 8, 2 and 0); “colors”, an array of
colour specifiers,
or “color”, a single colour specifier (support for multiple colours is not yet implemented); and “initially_on” (boolean, default false). As with lasers, flasher colours must be “sufficiently bright”.
Related to this change, the script method
initialiseTurret no longer does anything when executed. However, its presence in setup_actions (and only in setup_actions, and not in any conditions) is used to recognise a ball turret when handling old-style sub-entities.
Here is the full subentities list for the Coriolis in the new format.
Code: Select all
{
subentities =
(
{
subentity_key = "dock-flat";
orientation = ( 1, 0, 0, 1); // rotated 90 degrees
position = ( 0, 0, 500 );
is_dock = true;
},
{
subentity_key = "arc-detail";
},
{
subentity_key = "arc-detail";
orientation = ( 1, 0, 0, 1 );
},
{
subentity_key = "arc-detail";
orientation = ( 0, 0, 0, 1 );
},
{
subentity_key = "arc-detail";
orientation = ( 1, 0, 0, -1 );
},
{
type = flasher;
size = 12;
color = { hue = 60; };
frequency = 1;
phase = -1;
position = ( 0, 92, 475 );
},
{
type = flasher;
size = 12;
color = { hue = 75; };
frequency = 1;
phase = -1.2;
position = ( 0, 92, 425 );
},
{
type = flasher;
size = 12;
color = { hue = 90; };
frequency = 1;
phase = -1.2;
position = ( 0, 92, 375 );
},
{
type = flasher;
size = 12;
color = { hue = 105; };
frequency = 1;
phase = -1.6;
position = ( 0, 92, 325 );
},
{
type = flasher;
size = 12;
color = { hue = 120; };
frequency = 1;
phase = -1.8;
position = ( 0, 92, 275 );
},
{
type = flasher;
size = 12;
color = { hue = 60; };
frequency = 1;
phase = -1;
position = ( 0, -92, 475 );
},
{
type = flasher;
size = 12;
color = { hue = 75; };
frequency = 1;
phase = -1.2;
position = ( 0, -92, 425 );
},
{
type = flasher;
size = 12;
color = { hue = 90; };
frequency = 1;
phase = -1.2;
position = ( 0, -92, 375 );
},
{
type = flasher;
size = 12;
color = { hue = 105; };
frequency = 1;
phase = -1.6;
position = ( 0, -92, 325 );
},
{
type = flasher;
size = 12;
color = { hue = 120; };
frequency = 1;
phase = -1.8;
position = ( 0, -92, 275 );
},
{
type = flasher;
size = 12;
color = "orangeColor";
frequency = 1;
phase = 0.5;
position = ( 0, -16, 252 );
},
{
type = flasher;
size = 12;
color = "orangeColor";
frequency = 1;
phase = 0.5;
position = ( 0, 16, 252 );
},
{
type = flasher;
size = 12;
color = "orangeColor";
frequency = 1;
phase = 0;
position = ( 16, 0, 252 );
},
{
type = flasher;
size = 12;
color = "orangeColor";
frequency = 1;
phase = 0;
position = ( -16, 0, 252 );
}
);
}
)