Prototype/Tutorial: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
(Converted to SMW format)
(Updated styling of prototype doc migration note)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div class="stub"><p>'''The prototype docs have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/prototypes/TutorialDefinition.html https://lua-api.factorio.com/latest/prototypes/TutorialDefinition.html]
</p><p>This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].</p></div>
{{Prototype parent|PrototypeBase}}
{{Prototype parent|PrototypeBase}}
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.
The definition of the tutorial to be used in the tips and tricks, see [[Prototype/TipsAndTricksItem]]. The actual tutorial code is defined in the tutorials folder, in the folder that has the name of the scenario property.


{{Prototype TOC|tutorial}}
{{Prototype TOC|tutorial}}
Line 6: Line 12:
== Mandatory properties ==
== Mandatory properties ==
Inherits all properties from [[PrototypeBase]].
Inherits all properties from [[PrototypeBase]].
{{Prototype property|icons, icon, icon_size (IconSpecification)|[[Types/IconSpecification|IconSpecification]]}}


{{Prototype property|scenario|[[Types/string|string]]}}
{{Prototype property|scenario|[[Types/string|string]]}}
Name of the folder for this tutorial in the tutorials folder.
Name of the folder for this tutorial in the tutorials folder.
{{Prototype property|trigger|[[Types/table|table]]}}
Table with the following properties:
* type - [[Types/string|string]] - Mandatory. - One of "research-technology", "build-entity", "craft-item" and "manual-transfer".
* technology - [[Types/string|string]] - Read if type is "research-technology". - Name of the technology that triggers this tutorial when it is researched.
* entity - [[Types/string|string]] - Read if type is "build-entity". - Name of the entity that triggers this tutorial when it is built.
* item - [[Types/string|string]] - Read if type is "craft-item". - Name of the item that triggers this tutorial when it is crafted.
* count - [[Types/uint32|uint32]] - Read if type is "manual-transfer". - Amount of times manual item transfer has to be done to trigger this tutorial.
== Optional properties ==
{{Prototype property|dependencies|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
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.
{{Prototype property|related_items|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Items that are related to this tutorial, are shown below the tutorial icon in the tutorial list. Max number of related_items is 9.
== Example ==
<syntaxhighlight lang="lua">{
    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"}
  },</syntaxhighlight>

Latest revision as of 10:43, 21 September 2023

The prototype docs have moved to a new website with an improved format. This documentation page can now be found here: https://lua-api.factorio.com/latest/prototypes/TutorialDefinition.html

This wiki page is no longer updated and will be removed at some point in the future, so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback on the forums.


Prototype definitions » PrototypeBase » Prototype/Tutorial


The definition of the tutorial to be used in the tips and tricks, see Prototype/TipsAndTricksItem. The actual tutorial code is defined in the tutorials folder, in the folder that has the name of the scenario property.


Prototype/Tutorial — tutorial
scenario::string
Inherited from PrototypeBase
name::string
type::string
localised_description::LocalisedString (optional)
localised_name::LocalisedString (optional)
order::Order (optional)

Mandatory properties

Inherits all properties from PrototypeBase.

scenario

Type: string
Name of the folder for this tutorial in the tutorials folder.

Retrieved from "https://wiki.factorio.com/index.php?title=Prototype/Tutorial&oldid=193950"