Scenario: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
Line 64: Line 64:
An event is something that occurs, on which the application can react. By selecting the Event Bundles option of a level, it is possible to add (a bundle of) Server events to a level, that will trigger as soon as the level starts.
An event is something that occurs, on which the application can react. By selecting the Event Bundles option of a level, it is possible to add (a bundle of) Server events to a level, that will trigger as soon as the level starts.
====Server Events fired when chosen====
====Server Events fired when chosen====
: This section deals with Server Events that are fired when the level is 'chosen' (= when level is started). Events can be assigned on the right panel to the selected level,  after being added with the 'Add Event' button on the bottom of the right panel. Then the desired event can be selected from a list on the bottom panel. The selection can be confirmed with the 'Commit' button, or cancelled with the 'Cancel' button.
: This section manages Server Events that are fired when the level is 'chosen' (= when level is started). Events can be assigned on the right panel to the selected level,  after being added with the 'Add Event' button on the bottom of the right panel. Then the desired event can be selected from a list on the bottom panel. The selection can be confirmed with the 'Commit' button, or cancelled with the 'Cancel' button.
[[File:LevelsEventsBottomPanel-Q3-2015.jpg|frame|center|Event bundle [[Bottom Panel]]]]
[[File:LevelsEventsBottomPanel-Q3-2015.jpg|frame|center|Event bundle [[Bottom Panel]]]]
{{Editor steps|title=add events to a level|Select Storyline → Levels|Select Level to have events added to|Select Event Bundles from the selected level|Select 'Add event' on the bottom of the right panel|Select the newly added event on the right panel|Select the desired server event from the bottom  panel|Confirm the selection with the 'Commit' button, or use the 'Cancel' button to clear the selection}}
{{Editor steps|title=add events to a level|Select Storyline → Levels|Select Level to have events added to|Select Event Bundles from the selected level|Select 'Add event' on the bottom of the right panel|Select the newly added event on the right panel|Select the desired server event from the bottom  panel|Confirm the selection with the 'Commit' button, or use the 'Cancel' button to clear the selection}}

Revision as of 09:29, 25 August 2015

Please note: This page is currently being updated.

Template:Learned

What are Levels?

There are many definitions for the word Level, of which the following is the most relevant for the Tygron Engine:

A Level is a relative position or rank on a scale.

How do Levels relate to the Tygron Engine

For different reasons it is possible to divide a project in two or more levels. Reasons to do so can be (but are not limited to):

  • to provide the session participants a learning curve, to get used to interacting with the Tygron Engine
Create a first level as tutorial where a stakeholder can only perform a limited number of actions and measures. This can happen in a secluded area of the 3D World, to get acquainted with the interaction with the Tygron Engine, without affecting the outcome of the session as a whole.
  • to gradually make the project interaction more complex, to match the issue in real life more closely
Add more complex actions, measures and indicators to let session participants gradually experience the complexity of the spatial planning issue(s) at hand.
  • to jump in time to a future scenario
Each level can start with an event or measure that reflects future scenarios, such as floodings that only occur once every fifty and every one hundred years, or the sea level rising over time.
  • to provide pause moments during a session
Sessions often take up a whole morning, afternoon or even the whole day. By implementing levels the session flow can be interrupted to incorporate pause moments for reflection and refreshments.

By default, a project in the Tygron Engine always consists of at least one level.

Adding, duplicating and removing Levels in a project

Template:Editor ribbon

Adding a Level

File:LevelsAddNewLevel-Q3-2015.jpg
Add new level - drop down menu
File:LevelsAddLevel-Q3-2015.jpg
Add new level - left panel

A level can be added in two ways in the Tygron Engine; through a ribbon drop down option or by selecting the Add button on the bottom of the left panel, after selecting Levels in the ribbon bar.

How to add levels to a project:
  1. Select Storyline → Levels
  2. Select Add new Level from the drop down menu
  3. Or select Add on the bottom of the left panel


Duplicating a Level

File:LevelsSelectLevel-Q3-2015.jpg
Select level to duplicate on left panel
File:LevelsDuplicateLevel-Q3-2015.jpg
Duplicate selected level

When levels are used to add complexity or to provide a tutorial, it can be very convenient to be able to duplicate a previous level. This avoids having to create and assign all previous actions, measures and indicators again for each consecutive level. Instead, only the added complexity needs to be put in the duplicated level.

How to duplicate levels in a project:
  1. Select Storyline → Levels
  2. Select the level to be duplicated on the left panel
  3. Select Duplicate on the bottom of the left panel


Removing a Level from a project

File:LevelsSelectLevel-Q3-2015.jpg
Select level to remove on left panel
Remove selected level

Sometimes an earlier implemented level becomes redundant, or an error has occurred that renders a level useless. In such cases it is possible to remove the level completely.

How to remove levels in a project:
  1. Select Storyline → Levels
  2. Select the level to be removed on the left panel
  3. Select Remove on the bottom of the left panel


Changing the properties of a Level

Template:Editor ribbon

Level

By selecting a level entry on the left panel, the following properties become available on the right panel:

Name

Main article: Names
File:LevelsName-Q3-2015.jpg
Enter the level name here
In the Name field a more suitable name can be entered, if desired. Examples of this can be: "Tutorial", "Prologue", etc.
How to change the name of a level:
  1. Select Storyline → Levels
  2. Select Level to be renamed from the left panel
  3. Select Name field on right panel
  4. Delete the previous name
  5. Enter new name
  6. Confirm by pressing the 'Enter' key


Description

The description field allows for describing the level in the Editor. This is convenient when the level has added complexity. The description will appear on the Level panel of the Admin Interface, providing a short summary of the levels in the project.
How to change the description of a level:
  1. Select Storyline → Levels
  2. Select Level to have description added from the left panel
  3. Select Description field on right panel
  4. Delete the previous text (if needed)
  5. Enter new description
  6. Text is instantly confirmed when typed ('Enter' key adds hard return to text)


Event Bundles

Main article: Events

An event is something that occurs, on which the application can react. By selecting the Event Bundles option of a level, it is possible to add (a bundle of) Server events to a level, that will trigger as soon as the level starts.

Server Events fired when chosen

This section manages Server Events that are fired when the level is 'chosen' (= when level is started). Events can be assigned on the right panel to the selected level, after being added with the 'Add Event' button on the bottom of the right panel. Then the desired event can be selected from a list on the bottom panel. The selection can be confirmed with the 'Commit' button, or cancelled with the 'Cancel' button.
Event bundle Bottom Panel
How to add events to a level:
  1. Select Storyline → Levels
  2. Select Level to have events added to
  3. Select Event Bundles from the selected level
  4. Select 'Add event' on the bottom of the right panel
  5. Select the newly added event on the right panel
  6. Select the desired server event from the bottom panel
  7. Confirm the selection with the 'Commit' button, or use the 'Cancel' button to clear the selection


Measures

Main article: Measures
Assign measures

Besides events it is also possible to assign predefined measures to the start of a new level. For example; in the first level the stakeholders looked into different spatial alignments of possible solutions, in the second level, one alignment is constructed at the start of the level as automated measure, to accommodate further discussions. Prerequisite for this is to have the measure(s) available, then select the Measures entry on the left panel. The available measures will then show up on the right panel, which can then be assigned to the selected level.

How to add measures to a level:
  1. Ensure predefined measures are available in the project
  2. Select Storyline → Levels
  3. Select the level to have measures added to
  4. Select on the left panel the Measures property from the selected level
  5. Mark the check box of the desired measure from the available entries on the right panel


Stakeholders

Main article: Stakeholders
File:LevelsStakeholderProperties-Q3-2015.jpg
Stakeholder properties (right panel)

Selecting the arrow next to 'Stakeholders' on the left panel opens up the stakeholder section, containing the names of all active stakeholders in the project. Here the stakeholder properties can be set up per level. The following properties can be adjusted:

Provided Budget

The Provided Budget is the budget increment that happens at the start of the level. This can be the fixed income per stakeholder per period, or a dedicated subsidy flow for a special cause for example. This increment is separate from any income generated during the level from stakeholder actions.
How to change the incremental level budget for a stakeholder:
  1. Select Storyline → Levels
  2. Select the level to have the stakeholder budget changed from
  3. Select on the left panel the Stakeholder from the Stakeholder list of the selected level
  4. Enter a new budget in the budget field on the right panel
  5. Confirm by using the 'Enter' key

Start with Cinematic

Main article: Cinematics
To introduce the new level with a cinematic, each stakeholder can have a tailor made cinematic triggered at the start of each level to inform about the intricacies of the new level at hand. These cinematics must be created first, before they are available for selection from the drop down menu on the right panel.
How to change the level stating cinematic a stakeholder:
  1. Ensure a proper cinematic is available
  2. Select Storyline → Levels
  3. Select the level to have the stakeholder cinematic changed from
  4. Select on the left panel the affected Stakeholder from the Stakeholder list of the selected level
  5. Select on the right panel the desired cinematic from the drop down menu
  6. Mark the check box 'Start with Cinematic' to activate the cinematic at the start of the level

Active Action Menus

It is possible to assign more (or even different) action menus for each consecutive level, for each stakeholder. This is very useful when levels are implemented to build up complexity over the course of a session. Available action menus are present in a list with check boxes. Checking a box adds the action menu to the selected stakeholder for that level.
How to change the available actions for a stakeholder in the selected level:
  1. Select Storyline → Levels
  2. Select the level to have the stakeholder actions changed from
  3. Select on the left panel the affected Stakeholder from the Stakeholder list of the selected level
  4. Mark on the right panel the check boxes of the desired action menus


Playable Zones

File:LevelsPlayableZones-Q3-2015.jpg
Select which zones are active

This section allows for assigning dedicated areas in the 3D world to the selected level. Any non selected area is not playable, which means that any action here will not be deployable; the brush selection will color red. This allows for instance for the first tutorial level to take place in a small corner of the 3D world that does not have a large impact on the overall progression of the session.

How to change playable zones of a level:
  1. Select Storyline → Levels
  2. Select the level to change on the left panel
  3. Select on the left panel the affected Stakeholder from the Stakeholder list of the selected level
  4. Mark on the right panel the check boxes the playable zones to be active at the start of the level