Action: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
mNo edit summary
 
(134 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{learned|what actions are.|what categories are.|how actions can influence indicators.|how to add and remove actions to a stakeholder.}}
[[File:Api_future_design.png|thumb|right|400px|All available types of [[Action]]s]]


[[File:ActionsLogo.jpg|left|250px]]<br clear=all>


==Actions==
An action is an activity a [[stakeholder]] can perform to potentially achieve their objectives. 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 party 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.
Actions can be grouped together using [[Action Menu]]s. In the [[viewer ]]interface, Action menu that are available to a [[stakeholder]] are shown in the [[Action menu panel]] found the left part of the viewer interface. Selecting an Action Menu from the Action menu panel opens the Action panel, which provides options to plan an Action.


==How actions relate to the Tygron Engine==
When a user plans an action, it changes the future situation and will often have an effect on [[overlays]] and [[indicators]]. For example, when a stakeholder plants new trees, this action will have an effect on the [[Livability (Overlay)|Livability overlay]] and consequently on the [[Livability (Indicator)|Livability indicator]].


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|categories]].  
Actions taken are tied to specific stakeholders, allowing the recording of costs and incomes. As an example, the waterboard can be configured to have the capability to create waterways, but not social housing or roads. Since a stakeholder can be configured to have access to many different actions available, actions are organized using [[#Action Menus|Action menus]].  


===Predefined Actions===
[[Planned situation|Planned actions]] are generally not final. They can be canceled by the stakeholder that performed the action and sometimes be reverted by stakeholders that own the property. For reverting actions, see [[#Special 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]].
Each action is logged in the [[Action Log]], which can be used to trace back which actions have been taken during a [[session]] or [[test run]].


For more information about all the actions available in the Tygron Engine, see the [[list of option groups]]
{{clear}}
===Types of Actions===
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]].


===Effects of Actions===
This section describes the types of actions that can be taken and what effect they will have when planned in your project.


====Construction Options====
Actions that require a drawn selection:
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 (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).
* [[Function]]s.
: ''The most common type of action, the [[function]], can be applied to your project by drawing a selection. When applied, a [[building]] with that function will be planned in your project.''
* [[Upgrade Type|Upgrade]]s
: ''[[Buildings]] can be upgraded using [[Upgrade Types]], provided an upgrade definition exists within that Upgrade Type which applies to that building's [[function]]. Upgrades can be used to improve the building to a related function, or to change the building to a completely different function [[category]].''
* [[Levee]]s
* [[Attribute action]]s
: ''Similar to upgrades, although these actions do not change the function of a building. Instead, they set particular attribute values. These values can be set (at locked) by the creator of the action, or be configured by stakeholders applying these actions.''
* [[Special Option]]s:
: ''These are actions that have a functionality that cannot be further configured.
** [[Demolish]] and [[demolish underground]]
** [[Revert]]
** [[Raise land]] and [[Lower land]]
** [[Buy land]] and [[Sell land]]


For changing the effects of the constructions on the indicators, see [[functions]].
Actions that open an additional panel:
* [[Finance view]]
* [[Transfer money]]


====Extra Options====
Actions that will be applied directly:
Examples of actions that do not place or remove en 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 [[list of option groups#Extra Options|Extra options]].
* [[Measure]]s
* [[Event bundle]]s


===Categories===
====Impact of Actions====
Most actions have effects on buildings; planning new or demolishing or upgrading them. This will often have an effect on one or more indicators. Each action on a building has a [[Financial System#Costs|cost]] that will negatively affect the acting stakeholder's [[Budget (Indicator)|budget]].


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.
For changing the effects of the buildings on the indicators, see [[functions]].


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.
====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.


==Editing categories and actions==
{{article end
|howtos=
* [[How to add and remove an action menu]]
* [[How to edit an action menu]]
* [[How to add and remove actions]]
*[[How to add a Panel which can be opened from an Action Menu]]
*[[How to add an Attribute Action to your project]]
*[[How to add Financial Actions to your project]]
|seealso=
*[[Action Menu]]
*[[Action Log]]
*[[Action panel]]
*[[Planned situation]]
}}


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.


{{Editor location|||Stakeholders|Actions}}


[[File:Editor - categories.jpg|framed|none|The action screen of the editor.]]
{{Editor future design nav}}
 
[[Category:Action]]
===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.''
 
{{Editor steps|title=add a category|Select the stakeholder to which you wish to add the category.|Right-click in the middle pane.|Choose "Add Category" or "Add Existing Category".|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.''
{{Editor steps|title=remove a category|Right-click on a category in the middle pane.|If you wish to keep the category, but disconnect it from this stakeholder, select "Remove from stakeholder".|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.''
:''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"''
 
===Editing 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.
 
====Category Name====
[[File:Categories_overview_-_name.jpg|frame|right|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.''<br clear=all>
 
====Category Icon====
[[File:Categories_overview_-_icon.jpg|frame|right|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.''<br clear=all>
 
====Category Order====
[[File:Categories_overview_-_sort_index.jpg|frame|right|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".''<br clear=all>

Latest revision as of 09:07, 18 December 2023

All available types of Actions


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

Actions can be grouped together using Action Menus. In the viewer interface, Action menu that are available to a stakeholder are shown in the Action menu panel found the left part of the viewer interface. Selecting an Action Menu from the Action menu panel opens the Action panel, which provides options to plan an Action.

When a user plans an action, it changes the future situation and will often have an effect on overlays and indicators. For example, when a stakeholder plants new trees, this action will have an effect on the Livability overlay and consequently on the Livability indicator.

Actions taken are tied to specific stakeholders, allowing the recording of costs and incomes. As an example, the waterboard can be configured to have the capability to create waterways, but not social housing or roads. Since a stakeholder can be configured to have access to many different actions available, actions are organized using Action menus.

Planned actions are generally not final. They can be canceled by the stakeholder that performed the action and sometimes be reverted by stakeholders that own the property. For reverting actions, see #Special Actions

Each action is logged in the Action Log, which can be used to trace back which actions have been taken during a session or test run.

Types of 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.

This section describes the types of actions that can be taken and what effect they will have when planned in your project.

Actions that require a drawn selection:

The most common type of action, the function, can be applied to your project by drawing a selection. When applied, a building with that function will be planned in your project.
Buildings can be upgraded using Upgrade Types, provided an upgrade definition exists within that Upgrade Type which applies to that building's function. Upgrades can be used to improve the building to a related function, or to change the building to a completely different function category.
Similar to upgrades, although these actions do not change the function of a building. Instead, they set particular attribute values. These values can be set (at locked) by the creator of the action, or be configured by stakeholders applying these actions.
These are actions that have a functionality that cannot be further configured.

Actions that open an additional panel:

Actions that will be applied directly:

Impact of Actions

Most actions have effects on buildings; planning new or demolishing or upgrading them. This will often have an effect on one or more indicators. Each action on a building has a cost that will negatively affect the acting stakeholder's budget.

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

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.

How-to's

See also


Editor ribbon icon future.pngFuture Design
Future Design
Test Run • Actions • Action Menus • Measures • Parametric • Attributes • Levee Types • Upgrade Types • Event Bundles • Active Stakeholders
Actions
Action Logs
Editor
Current Situation • Future Design • Multi Scenario • Tools • Community
Retrieved from "https://support.tygron.com/w/index.php?title=Action&oldid=56854"