Actions description

Actions do not have independent descriptions in separate files, but are present in descriptions of other game elements, for example, in job states.

Actions are used to affect the state of the game objects or to trigger an event.

Description structure

The action description always includes its type from the list below in the ActionType parameter, as well as a set of additional parameters depending on it.


 * Message
 * Message2
 * PlayerUpgradeAdd
 * PlayerCargoAdd
 * PlayerCargoRemove
 * PlayerFundAdd
 * PlayerFundRemove
 * SetWeather
 * CityFundAdd
 * CityFundRemove
 * CityChangePhase
 * CitySetOpen
 * CreateSimpleEntity
 * CreateNPC
 * CreateCargoBox
 * RemoveEntity

 Message 

Sending a message to the player through the intercom. {   "ActionType": "Message", "Name": "ExampleMessageText", "Sound": "ExampleMessageSound", } Name - the name of the message text from the localization

Sound - (optional) the name of the sound, if not specified - take Name.

Message2

Sending an improved message to the player through the intercom. {   "ActionType": "Message2", "Name": "ExampleMessageName", "PersonName": "ExamplePersonName", } Name - the name of the message description (for details, see Message Descriptions).

PersonName - the name of the author's description of the identity of the message (for details, see Personality Descriptions).

PlayerUpgradeAdd

Adding an upgrade to the player's ship. {   "ActionType": "PlayerUpgradeAdd", "Name": "ExampleUpgradeName", }

Name - the name of the upgrade description (for details, see Upgrade Descriptions).

PlayerCargoAdd

Adding goods to the hold of the player's ship. {   "ActionType": "PlayerCargoAdd", "Name": "ExampleProductName", }

Name - the name of the product description (more in Product Descriptions).

PlayerCargoRemove

Removal of goods from the hold of the player's ship. {   "ActionType": "PlayerCargoRemove", "Name": "ExampleCargoName", }

Name - the name of the product description (more in Product Descriptions).

PlayerFundAdd

Adding currency to the player. {   "ActionType": "PlayerFundAdd", "Name": "ExampleFundName", "Count": 100, }

Name - the name of the currency.

Count - the amount of currency.

 PlayerFundRemove 

Removing the currency from the player. {   "ActionType": "PlayerFundRemove", "Name": "ExampleFundName", "Count": 100, } Name - the name of the currency.

Count - the amount of currency.

SetWeather

Set the weather. {   "ActionType": "SetWeather", "Name": "ExampleWeatherName", } Name - the name of the weather description (more in the Weather Descriptions).

CityFundAdd

Adding the currency of the city (base). {   "ActionType": "CityFundAdd", "Name": "ExampleFundName", "Count": 100, "CityName: "ExampleBaseName", } Name - the name of the currency.

Count - the amount of currency. CityName - the name of the base.

CityFundRemove

Removal of currency from the city (base). {   "ActionType": "CityFundRemove", "Name": "ExampleFundName", "Count": 100, "CityName: "ExampleBaseName", } Name - the name of the currency.

Count - the amount of currency.

CityName is the name of the base.

CityChangePhase

Setting the phase of the construction of the city (base). {   "ActionType": "CityChangePhase", "Name": "ExampleCityName", "Count": 2, } Name - the name of the description of the base (more in the base Descriptions). Count is the number of the phase.

CitySetOpen

Opening of the city (base). {   "ActionType": "CitySetOpen", "Name": "ExampleCityName", } Name - the name of the description of the base (more in the base Descriptions).

CreateSimpleEntity

Creating a game object. {   "ActionType": "CreateSimpleEntity", "Name": "ExampleEntityName", "TargetDescr": "ExampleTargetName", "PrefabName": "ExamplePrefabName", "NeedCorrectPosition": true, } Name - the unique name that will be assigned to the object.

TargetDescr - name of the goal description (details in the Descriptions of goals), which determines the position of the object being created.

PrefabName - the path to the prefab of the object.

NeedCorrectPosition - (optional) whether you need to adjust the position and set the object to the ground.

CreateNPC

Creation of a character in the world. {   "ActionType": "CreateNPC", "Name": "ExampleNPCName", "TargetDescr": "ExampleTargetName" "DescrName": "ExampePassengerName", } Name - the unique name that will be assigned to the object.

TargetDescr - name of the goal description (details in the Descriptions of goals), which determines the position of the object being created.

DescrName - the name of the character description (more in Character Descriptions *).

CreateCargoBox

Creation of a box with the goods. {   "ActionType": "CreateCargoBox", "Name": "ExampleNPCName", "TargetDescr": "ExampleTargetName" "DescrName": "ExampleCargoboxName", "Velocity": 0, "RotateImpulse": 0, "AngleDirection": [0, 0, 0], "KillUnderGround": true, "UseGravity": true, } Name - the unique name that will be assigned to the object.

TargetDescr - name of the goal description (details in the Descriptions of goals), which determines the position of the object being created.

DescrName - the name of the container description (for details see Container Descriptions).

Velocity - (optional)

RotateImpulse - (optional)

AngleDirection - (optional)

KillUnderGround - (optional)

UseGravity - (optional)

RemoveEntity

Deleting an object. {   "ActionType": "RemoveEntity", "Name": "ExampleEntityName", } Name - the name of the object.

SetBelongContainer

Setting the ownership (ownership) of the container to the player, world or city.

If the container belongs to the world or the player, it can be taken, it can break. {   "ActionType": "SetBelongContainer", "Name": "ExampleContainerName", "CargoBelongType": "PLAYER", } Name - the name of the object.

CargoBelongType - type of ownership: CITY - to the city, PLAYER - to the player, WORLD - to the world.