Prototype/Tutorial: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
(Converted to SMW format)
(0.18.26: added visible_when_dependencies_not_completed)
Line 27: Line 27:
{{Prototype property|related_items|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
{{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.
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|visible_when_dependencies_not_completed|[[Types/bool|bool]] |true|optional=true}}
Whether the tutorial should be visible when the [[#dependencies]] tutorials have not yet been completed.


== Example ==
== Example ==

Revision as of 14:31, 21 May 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.

Template:Prototype TOC

Mandatory properties

Inherits all properties from PrototypeBase.

Template:Prototype property

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 visible when the #dependencies tutorials have not yet been completed.

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"}
  },