The tutorial module is used to create a tutorial for the map. Tutorials are split up into stages which have a message and a teleport position.

Tutorials are intended for players with zero playing experience, thus they should be written as simple as possible, without any abbreviations or acronyms. If abbreviations are used it is recommended that they are explained or written out, e.g. Capture the Wool (CTW)

The tutorial.xml defines the default messages that will be sent at the beginning and end of the tutorial.

NOTE: This file must be included.

<include src="tutorial.xml"/>

Tutorial stages contain a message with multiple lines and a teleport. A stage’s title shouldn’t be too long since it is displayed in the tool-tip of the tutorial item. The message element can contain multiple lines, color and formatting codes can be used for fancy text. Message lines are used to insert a hard line break, you can also put all the text into a single <line> however you won’t have any control over where lines start to wrap.

Teleports are optional, if they are not defined just the message will be displayed for that stage. They can contain regions or point providers, it is recommended that you use a point provider to control precisely where the player spawns. If a point is obstructed the player will not be teleported. However, the stage message will still be displayed.

Stages are displayed in the order that they are defined as in the XML.

Tutorial Stage Attributes

Tutorial Stage Sub-elements

<tutorial>
    <stage title="Capture the Wool">
        <message>
            <line>`rThis map is a `a`lCapture the Wool `r(CTW) map</line>
            <line>The objective is to grab the wool on the other team's side and return it to your base.</line>
        </message>
        <teleport>
            <point yaw="90" pitch="50">44,60,0</point>
        </teleport>
    </stage>
    <!-- next stages -->
</tutorial>