Prototype/Tutorial: Difference between revisions
(0.18.26: added visible_when_dependencies_not_completed) |
(0.18.33: removed visible_when_dependencies_not_completed, added locked_when_dependencies_not_completed, unlocked) |
||
Line 28: | Line 28: | ||
Items that are related to this tutorial, are shown below the tutorial icon in the tutorial list. Max number of related_items is 9. | Items that are related to this tutorial, are shown below the tutorial icon in the tutorial list. Max number of related_items is 9. | ||
{{Prototype property| | {{Prototype property|locked_when_dependencies_not_completed|[[Types/bool|bool]]|false|optional=true}} | ||
Whether the tutorial should be | Whether the tutorial should be locked when the [[#dependencies]] tutorials have not yet been completed. | ||
{{Prototype property|unlocked|[[Types/bool|bool]]|false|optional=true}} | |||
Whether the tutorial is always unlocked, regardless of dependency tutorials. | |||
== Example == | == Example == |
Revision as of 07:52, 8 July 2020
Template:Prototype parent The definition of the tutorial as shown in the tutorial selection in-game. The actual tutorial code is defined in the tutorials folder, in the folder that has the name of the scenario property.
Mandatory properties
Inherits all properties from PrototypeBase.
Template:Prototype property Name of the folder for this tutorial in the tutorials folder.
Template:Prototype property Table with the following properties:
- type - string - Mandatory. - One of "research-technology", "build-entity", "craft-item" and "manual-transfer".
- technology - string - Read if type is "research-technology". - Name of the technology that triggers this tutorial when it is researched.
- entity - string - Read if type is "build-entity". - Name of the entity that triggers this tutorial when it is built.
- item - string - Read if type is "craft-item". - Name of the item that triggers this tutorial when it is crafted.
- count - uint32 - Read if type is "manual-transfer". - Amount of times manual item transfer has to be done to trigger this tutorial.
Optional properties
Template:Prototype property Names of the tutorials this one depends on. If those are not unlocked yet, the tutorial will show in a different color in the tutorial gui.
Template:Prototype property Items that are related to this tutorial, are shown below the tutorial icon in the tutorial list. Max number of related_items is 9.
Template:Prototype property Whether the tutorial should be locked when the #dependencies tutorials have not yet been completed.
Template:Prototype property Whether the tutorial is always unlocked, regardless of dependency tutorials.
Example
{
type = "tutorial",
name = "trains-basics",
scenario = "trains-basics",
order = "d[trains]-a[basic-train]",
technology = "railway",
icon = "__base__/graphics/technology/railway.png",
icon_size = 128,
related_items = {"rail", "locomotive"}
},