Action: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
(39 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[[{{TALKPAGENAME}}|>>> see discussion]]
[[File:Actions.png|link=https://www.tygron.com/nl/2019/05/22/actions-measures-en-upgrades/]]
[[File:ActionsLogo.jpg|right|250px]]
{{learned|what actions are|what menus are|how actions can influence indicators|how to add and remove actions to a stakeholder}}
<br clear=all>


==Actions==
==Actions==
Line 8: Line 5:
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.
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==
==How actions relate to the {{software}}==
 
When a user 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 stakeholder plants new trees, this action would have an effect on the [[Livability (Indicator)|Livability indicator]]. 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 user can have a lot of different actions available to reach their [[objective]], actions are organized into [[#Menus|menus]].  
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 [[#Menus|menus]].  


===Predefined Actions===
===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 [[functions|function]].
A lot of predefined actions are available in {{software}}. Each project can have its own set of available actions. Furthermore, Not every action has to be available for each [[stakeholder]]. Since Projects created in the {{software}} have their focus primarily on urban planning, most of the available actions are construction options. These options allow stakeholders to plan constructions based on available [[functions]].


For more information about all the actions available in the Tygron Engine, see the [[list of actions]]
For more information about all the actions available in the {{software}}, see the [[list of actions]].


===Effects of Actions===
===Effects of Actions===
Because there are various types of actions that could be made available, there is also a variety of effects that actions could have.


====Construction Actions====
====Construction Actions====
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 [[Financial System#Costs|cost]] will negatively affect the acting stakeholder's [[Budget (Indicator)|budget]]. Actions such as parks and green roofs will positively affect the [[Green (Indicator)|green indicator]]. The effect on the indicator is determined by that element's [[function]] (type).
Most actions, when planned by the stakeholder, will place a construction in the 3D World and will have an effect on at least one or more indicators. Each construction with a [[Financial System#Costs|cost]] will negatively affect the acting stakeholder's [[Budget (Indicator)|budget]]. Constructions such as parks and green roofs will positively affect the [[Green (Indicator)|green indicator]]. The effect on the indicator is determined by that construction's [[function]].


For changing the effects of the constructions on the indicators, see [[functions]].
For changing the effects of the constructions on the indicators, see [[functions]].
Line 27: Line 24:
====Special Actions====
====Special Actions====
Examples of actions that do not place or remove an element in the 3D world, and thus do not have an associated construction action, include money transfer, buy and sell land, [[demolish]], and the [[inbox]]. These actions are grouped together as [[list of option groups#Special Actions|Special actions]].
Examples of actions that do not place or remove an element in the 3D world, and thus do not have an associated construction action, include money transfer, buy and sell land, [[demolish]], and the [[inbox]]. These actions are grouped together as [[list of option groups#Special Actions|Special actions]].
====Upgrades and Levees====
Besides placing constructions, a user may also opt to [[Upgrades|upgrade]] buildings or place [[Levee Types|levees]] in the 3D world. These need to be defined before they can be added to a stakeholder's action menu. Upgrades always have a function associated with it, and levees can have functions associated with them. The effects of these actions depend on the functions, in a similar fashion as constructions.
====Measures and Events====
[[Measures]] and [[event]]s also need to be defined before they can be added to a stakeholder's action menu. Events simply cause other things to happen during the session when they are activated. Measures may have a variety of effects.


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


For each stakeholder, their actions are organized into menus. Similar actions, such as creation of infrastructure (roads, traintracks, etc) or housing (villas, apartments, etc), can be grouped together into the same menu. By roughly matching the actions in a menu to the indicators relevant to the stakeholder, it is possible for players to weigh choices of actions against each other easily.
Action menus can also be shared between stakeholders. This means that two or more stakeholders can have access to the same menu, and to the same actions within that menu. An example of a menu that could be shared among stakeholders would be a menu with financial actions, such as the ability to transfer money. Having a menu shared with another stakeholder has no effect on the usability of a menu or the actions therein.
 
Action menus can also be shared between stakeholders. This means that two or more players can have access to the same menu, and to the same actions within that menu. An example of a menu that could be shared among stakeholders would be a menu with financial actions, such as the ability to transfer money. Having a menu shared with another stakeholder has no effect on the usability of a menu or the actions therein.


==Changing actions and menus==
==Changing actions and menus==
{{Editor location|action menus}}


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


{{Editor location|||Stakeholders|Actions}}
===Adding and removing action menu's===
{{Editor location|action menus}}
[[File:actions-left.jpg|framed|left|The left panel in the editor, when editing the actions.]]
To add an action to a stakeholder, the stakeholder first needs to have at least one menu to place the action in. It is not possible to add an action to a stakeholder without organizing it into a menu. A menu without actions will appear to a user as empty, and does not directly serve any purpose.


[[File:Editor - categories.jpg|framed|none|The action screen of the editor.]]
{{Editor steps|title=add an action menu|Select "Stakeholders" in the ribbon header.|Select "Actions" in the ribbon bar.|Select "Add" in the [[Editor#Left_Panel|left panel]].}}
{{Editor steps|title=remove an action menu|Select "Stakeholders" in the ribbon header.|Select "Actions" in the ribbon bar.|Select the menu you wish to remove.|Select "Remove" in the [[Editor#Left_Panel|left panel]].}}
<br clear=all>


===Adding and removing menus and actions===
===Editing action menus===
{{Editor location|action menus|The Action Menu to edit}}
[[File:Actions-right.jpg|framed|left|The right panel in the editor, when editing the action menu's.]]
When you select a menu, the right panel will automatically be filled with the information pertaining to that menu. A number of properties pertaining to a menu can be edited.


{{Editor location|||Stakeholders|Actions}}
====Menu Name====
To add an action to a stakeholder, the stakeholder first needs to have at least one menu to place the action in. It is not possible to add an action to a stakeholder without organizing it into a menu. A menu without actions will appear to a player as empty, but does not directly serve any purpose.
[[File:Actions-right-name.jpg|frame|right|The field for the "name".]]
: ''This Menu name field is the name of the menu. The menu name is displayed when a user hovers the mouse over a menu. You can change the name of the menu by editing the textfield.''<br clear=right>


It is also possible to share menus between multiple stakeholders. The menu must first be created for a single stakeholder, and can then be added to other stakeholders as well. Actions added to such a menu can be used by all stakeholders with that menu.
====Menu Icon====
====Adding a menu====
[[File:Actions-right-image.jpg|frame|right|The menu's "image".]]
:''To add a new menu to the current stakeholder, right-click in the middle pane, and select "Add new Menu".''
: ''The Menu image is a visual representation of a menu. The menu image is used to group several actions into. You can change the image by clicking the Menu image and choosing an image from the list of images that appears.''<br clear=right>
:''To add an already existing menu to the stakeholder, right-click in the middle pane, and choose "Add existing Menu". Then pick a menu from the menus list.''


{{Editor steps|title=add a menu|Select the stakeholder to which you wish to add the menu.|Right-click in the middle pane.|Choose "Add new Menu" or "Add Existing Menu".|If you chose "Add Existing Menu", select a menu from the menus list.}}
====Menu Active====
[[File:Actions-right-active.jpg|frame|right|The "active" checkbox.]]
: ''The "Active" property dictates whether the action menu is activated at the start of the project. You can change this by checking or unchecking the checkbox''<br clear=right>


====Removing a menu====
====Menu Order====
:''To remove a menu from the current stakeholder only, right-click on the menu you want to remove, and select "Remove from stakeholder".''
[[File:Actions-right-move.jpg|frame|right|The buttons with which to alter the "order" of the menus.]]
:''To permanently delete a menu completely, right-click on the the menu you want to remove, and select "Delete Menu". This also removes it from other stakeholders.''
: ''The menu order defines the order in which the menus are being presented to the user. You can change the order by selecting a menu and pressing "Move up" and "Move Down".''<br clear=right>
{{Editor steps|title=remove a menu|Select the stakeholder from which you wish to remove a menu.|Right-click on a menu in the middle pane.|If you wish to keep the menu, but disconnect it from this menu, select "Remove from stakeholder".|If you wish to completely delete the menu, select "Delete Menu".}}


====Adding and removing actions====
====Menu Stakeholders====
:''To add an action to a menu, drag an action from the left pane (for example, "Construction actions -> Agriculture -> Corn Fields") to an available menu. When no menu is available, you need to to add a menu first.''
[[File:Actions-right-stakeholders.jpg|frame|right|The checkboxes for giving stakeholders access to the action menu.]]
{{Editor steps|title=add an action|Select the stakeholder to which you wish to add the action.|Make sure the stakeholder has [[#Adding a menu|at least one menu]].|Select an action from the pane on the left of the panel.|Drag the action ''on to'' the menu in which you wish the action to be placed.}}
: ''The stakeholders with whom the action menu is shared, have access to the actions in the menu. In addition, this sharing can be defined by level, meaning that the availability of an action menu can change by stakeholder and by level. To give a stakeholder access to this action menu in a given level, find the level in the list, find the entry for the stakeholder listed under the entry for the level, and check the checkbox next to the stakeholder's entry.''<br clear=all>
:''To remove an action from a menu, right-click the action you want to remove from the menu you want to remove, and select "Delete Action"''
{{Editor steps|title=remove an action|Select the stakeholder from which you wish to remove an action.|Open the menu containing the action.|Right-click the action and select "Delete Action".}}


===Changing menus===
===Adding and removing actions===
{{Editor location|||Stakeholders|Actions}}
{{Editor location|actions}}
In the middle of the panel, you will see the existing menus. When you select a menu, the right of the panel will automatically be filled with the information pertaining to that menu. A number of properties pertaining to a menu can be edited.
<!--[[File:Actions-left-actions.jpg|frame|left|Selecting the "Assigned Actions" option in the left panel.]]-->
[[File:Actions-right-actions.jpg|frame|left|The right panel allows you to select actions for the menu.]]
To change which actions are included in an action menu, find the entry for the menu you wish to change, and select the sub-item "Assigned Actions". In the right panel, a list will be visible with several types of actions. Each action type can be opened to reveal either a sub-list of action types, or a list of actual actions. By checking or unchecking the checkbox next to an action, the action is either added or removed.


{{Editor steps|title=change a menu|Select a menu in the middle pane.|Change the name by changing the contents of the "Menu Name" field.|Change the icon by clicking on the icon, and selecting a new one in the icon panel.|Change the order by moving this menu up or down, by using the "Move Up" and "Move Down" buttons.}}
{{Editor steps|title=set the actions of an action menu|In the left panel, select the action menu for which you'd like to edit the actions.|In the right panel, select the appropriate action type.|If neccesary, select the appropriate subtype.|For a given action, check the checkbox next to the action to add it to the menu.}}


====Menu Name====
There is a quick way to reach the checkbox for an action that is already included in an action menu. In the left menu, Under the assigned actions of an action menu, a sub-list is available of the actions included in that menu. By selecting an action in the left panel, the same entry is also automatically selected in the right panel.
[[File:Categories_overview_-_name.jpg|frame|right|The field for the "name".]]
: ''This Menu name field is the name of the menu. The menu name is displayed when a player hovers the mouse over a menu. You can change the name of the menu by editing the textfield.''<br clear=all>


====Menu Icon====
A few action types may be empty: [[Measures]], [[Levee Types|Levees]] and [[Event Bundle]]s. These are all user-defined. If these have not yet been defined in the project, they cannot be added to the action menu's.
[[File:Categories_overview_-_icon.jpg|frame|right|The menu's "icon".]]
: ''The Menu icon is a visual representation of a menu. The menu icon is used to group several actions into. You can change the icon by clicking the Menu icon and choosing an image from the list of images that appears.''<br clear=all>


====Menu Order====
{{Template:Editor_future_design_nav}}
[[File:Categories_overview_-_sort_index.jpg|frame|right|The buttons with which to alter the "order" of the menus.]]
: ''The menu order defines the order in which the menus are being presented to the user. You can change the order by selecting a menu and pressing "Move up" and "Move Down".''<br clear=all>

Revision as of 15:34, 27 February 2020

Actions.png

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 Platform

When a user 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 stakeholder plants new trees, this action would have an effect on the Livability indicator. 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 user can have a lot of different actions available to reach their objective, actions are organized into menus.

Predefined Actions

A lot of predefined actions are available in Tygron Platform. Each project can have its own set of available actions. Furthermore, Not every action has to be available for each stakeholder. Since Projects created in the Tygron Platform have their focus primarily on urban planning, most of the available actions are construction options. These options allow stakeholders to plan constructions based on available functions.

For more information about all the actions available in the Tygron Platform, see the list of actions.

Effects of Actions

Because there are various types of actions that could be made available, there is also a variety of effects that actions could have.

Construction Actions

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

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

Special Actions

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

Upgrades and Levees

Besides placing constructions, a user may also opt to upgrade buildings or place levees in the 3D world. These need to be defined before they can be added to a stakeholder's action menu. Upgrades always have a function associated with it, and levees can have functions associated with them. The effects of these actions depend on the functions, in a similar fashion as constructions.

Measures and Events

Measures and events also need to be defined before they can be added to a stakeholder's action menu. Events simply cause other things to happen during the session when they are activated. Measures may have a variety of effects.

Menus

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

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

Changing actions and menus

Editor → Future Design (Ribbon tab) → Actions (Ribbon bar)

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

Adding and removing action menu's

Editor → Future Design (Ribbon tab) → Actions (Ribbon bar)
The left panel in the editor, when editing the actions.

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

How to add an action menu:
  1. Select "Stakeholders" in the ribbon header.
  2. Select "Actions" in the ribbon bar.
  3. Select "Add" in the left panel.
How to remove an action menu:
  1. Select "Stakeholders" in the ribbon header.
  2. Select "Actions" in the ribbon bar.
  3. Select the menu you wish to remove.
  4. Select "Remove" in the left panel.


Editing action menus

Editor → Future Design (Ribbon tab) → Actions (Ribbon bar) → The Action Menu to edit (Left panel)
The right panel in the editor, when editing the action menu's.

When you select a menu, the right panel will automatically be filled with the information pertaining to that menu. A number of properties pertaining to a menu can be edited.

Menu Name

The field for the "name".
This Menu name field is the name of the menu. The menu name is displayed when a user hovers the mouse over a menu. You can change the name of the menu by editing the textfield.

Menu Icon

The menu's "image".
The Menu image is a visual representation of a menu. The menu image is used to group several actions into. You can change the image by clicking the Menu image and choosing an image from the list of images that appears.

Menu Active

The "active" checkbox.
The "Active" property dictates whether the action menu is activated at the start of the project. You can change this by checking or unchecking the checkbox

Menu Order

The buttons with which to alter the "order" of the menus.
The menu order defines the order in which the menus are being presented to the user. You can change the order by selecting a menu and pressing "Move up" and "Move Down".

Menu Stakeholders

The checkboxes for giving stakeholders access to the action menu.
The stakeholders with whom the action menu is shared, have access to the actions in the menu. In addition, this sharing can be defined by level, meaning that the availability of an action menu can change by stakeholder and by level. To give a stakeholder access to this action menu in a given level, find the level in the list, find the entry for the stakeholder listed under the entry for the level, and check the checkbox next to the stakeholder's entry.

Adding and removing actions

Editor → Future Design (Ribbon tab) → Actions (Ribbon bar) → The Action Menu to edit (Left panel) → Actions tab (Right panel)
The right panel allows you to select actions for the menu.

To change which actions are included in an action menu, find the entry for the menu you wish to change, and select the sub-item "Assigned Actions". In the right panel, a list will be visible with several types of actions. Each action type can be opened to reveal either a sub-list of action types, or a list of actual actions. By checking or unchecking the checkbox next to an action, the action is either added or removed.

How to set the actions of an action menu:
  1. In the left panel, select the action menu for which you'd like to edit the actions.
  2. In the right panel, select the appropriate action type.
  3. If neccesary, select the appropriate subtype.
  4. For a given action, check the checkbox next to the action to add it to the menu.

There is a quick way to reach the checkbox for an action that is already included in an action menu. In the left menu, Under the assigned actions of an action menu, a sub-list is available of the actions included in that menu. By selecting an action in the left panel, the same entry is also automatically selected in the right panel.

A few action types may be empty: Measures, Levees and Event Bundles. These are all user-defined. If these have not yet been defined in the project, they cannot be added to the action menu's.