Action

File:ActionsLogo.jpg

Template:Learned

Actions

An action is an activity a stakeholder can perform to achieve their objective. A typical example of an action would be a housing corporation constructing social housing, or a water board realizing open water.

How actions relate to the Tygron Engine

When a player plans an action it will influence the 3D World and have a certain effect on indicators. The effect of the planned action simulates the effect the action would have in the real world. When a player plants new trees, this action would have an effect on the indicator Quality of Life. Actions are tied to specific stakeholders, referring to the capability each stakeholder has to influence the 3D World. The waterboard has the capability to create water, but not social housing or roads. Since a player can have a lot of different actions available to reach their objective, actions are organized into categories.

Predefined Actions

A lot of predefined actions are available in Tygron Engine. Not all those actions have to be available to the players in all games. Since the game is about urban planning, most of the available actions have an available construction associated with its function.

For more information about all the actions available in the Tygron Engine, see the list of option groups

Effects of Actions

Construction Options

Most actions, when planned by the player, will place a construction in the 3D World and will have an effect on at least one or more indicators. Each action with a cost will negatively affect the acting stakeholder's budget. Actions such as parks and green roofs will positively affect the green indicator. The effect on the indicator is determined by that element's function (type).

For changing the effects of the constructions on the indicators, see functions.

Extra Options

Examples of actions that do not place or remove an element in the 3D world, and thus do not have an associated construction option, include money transfer, buy and sell land, demolish, and the inbox. These actions are grouped together as Extra options.

Categories

For each stakeholder, their actions are organized into categories. Similar actions, such as creation of infrastructure (roads, traintracks, etc) or housing (villas, apartments, etc), can be grouped together into the same category. By roughly matching the actions in a category to the indicators relevant to the stakeholder, it is possible for players to weigh choices of actions against each other easily.

Categories can also be shared between stakeholders. This means that two or more players can have access to the same category, and to the same actions within that category. An example of a category that could be shared among stakeholders would be a category with financial actions, such as the ability to transfer money. Having a category shared with another stakeholder has no effect on the usability of a category or the actions therein.

Changing categories and actions

In the editor, you can add, remove and reorganize actions and categories in the game as desired. The panel required to make changes to the actions and categories is the "Actions" panel from the "Stakeholder" menu in the editor.

File:Editor - categories.jpg

The action screen of the editor.

Adding and removing categories and actions

To add an action to a stakeholder, the stakeholder first needs to have at least one category to place the action in. It is not possible to add an action to a stakeholder without organizing it into a category. A category without actions will appear to a player as an empty category, but does not directly serve any purpose.

It is also possible to share categories between multiple stakeholders. The category must first be created for a single stakeholder, and can then be added to other stakeholders as well. Actions added to such a category can be used by all stakeholders with that category.

Adding a category

To add a new category to the current stakeholder, right-click in the middle pane, and select "Add Category".

To add an already existing category to the stakeholder, right-click in the middle pane, and choose "Add Existing Category". Then pick a category from the categories list.

How to add a category:

1. Select the stakeholder to which you wish to add the category.
2. Right-click in the middle pane.
3. Choose "Add Category" or "Add Existing Category".
4. If you chose "Add Existing Category", select a category from the categories list.

Removing a category

To remove a category from the current stakeholder only, right-click on the category you want to remove, and select "Remove from stakeholder".

To permanently delete a category completely, right-click on the the category you want to remove, and select "Delete Category". This also removes it from other stakeholders.

How to remove a category:

1. Select the stakeholder from which you wish to remove a category.
2. Right-click on a category in the middle pane.
3. If you wish to keep the category, but disconnect it from this stakeholder, select "Remove from stakeholder".
4. If you wish to completely delete the category, select "Delete Category".

Adding and removing actions

To add an action to a category, drag an action from the left pane (for example, "Construction options -> Agriculture -> Corn Fields") to an available category. When no category is available, you need to to add a category first.

How to add an action:

1. Select the stakeholder to which you wish to add the action.
2. Make sure the stakeholder has at least one category.
3. Select an action from the pane on the left of the panel.
4. Drag the action on to the category in which you wish the action to be placed.

To remove an action from a category, right-click the action you want to remove from the category you want to remove, and select "Delete Option"

How to remove an action:

1. Select the stakeholder from which you wish to remove an action.
2. Open the category containing the action.
3. Right-click the action and select "Delete Option".

Changing categories

In the middle of the panel, you will see the existing categories. When you select a category, the right of the panel will automatically be filled with the information pertaining to that category. A number of properties pertaining to a category can be edited.

How to change a category:

1. Select a category in the middle pane.
2. Change the name by changing the contents of the "Category Name" field.
3. Change the icon by clicking on the icon, and selecting a new one in the icon panel.
4. Change the order by moving this category up or down, by using the "Move Up" and "Move Down" buttons.

Category Name

File:Categories overview - name.jpg

The field for the "name".

This Category name field is the name of the category. The Category name is displayed when a player hovers the mouse over a category. You can change the name of the category by editing the textfield.

Category Icon

File:Categories overview - icon.jpg

The category's "icon".

The Category icon is a visual representation of a Category. The category icon is used to group several actions into. You can change the icon by clicking the Category icon and choosing an image from the list of images that appears.

Category Order

File:Categories overview - sort index.jpg

The buttons with which to alter the "order" of the categories.

The category order defines the order in which the categories are being presented to the user. You can change the order by selecting a category and pressing "Move up" and "Move Down".