Atlas Map Documentation

A comprehensive guide on creating maps and game modes for Atlas.

Map Tutorials<tutorial>

Tutorials are used to give players an introduction to the map with use of text and locations.

Tutorial Step<step>

A tutorial contains information about the map,

<tutorial>
  ...
  <step freeze="false" countdown="5s" location="-43, 8, -116" yaw="-179" pitch="27">...</step>
</tutorial>

Tutorial Step Attributes
AttributeDescriptionTypeDefault
freeze

If the player should be frozen in place when they are in this step.

True/Falsetrue
clear-inventory

If the player's inventory should be cleared when they are in this step.

True/Falsetrue
fly

If the player should be allowed to fly when they are in this step.

True/Falsetrue
countdown

How long this step should last before advancing to the next step.

This attribute denotes a period of time and can either be in seconds or in a period format.

Formats are as follows:

d - days

h - hours

m - minutes

s - seconds

These can be combined to create any period. No spaces are allowed.

Duration
yaw

The yaw that the player should be at when in this step.

Float
pitch

The pitch that the player should be at when in this step.

Float
location

The location that the step should start at.

X,Y,Z Vector

Chat<chat>

This is used to specify lines of text that the player should see in chat when this step starts.

<step>
  ...
  <chat>
    <line>^r • {tutorial.generic.team-spawns}</line>
  </chat>
</step>

Element Text

DescriptionType

The text that is on this line.

Localized String

Inventory<inventory>

This is used to give a player certain items when they are in this step.

<step>
  <inventory>
    <item slot="0" material="iron sword" />
    <item slot="1" material="bow">
      <enchantment>arrow_infinite</enchantment>
    </item>
  </inventory>
</step>

Inventory Attributes
AttributeDescriptionType
items

Items that should be given to the player.

This should be written like items would be configured in a loadout.

Items Loadout Tag

Title<title>

This is used to specify lines of text that the player should see as a title when this step starts.

<step>
  ...
  <title stay="3s" subtitle="^a^l{tutorial.mixed.dtc-dtm.title}" />
</step>

Title Attributes
AttributeDescriptionTypeDefault
text

The text of the main title.

Localized String
subtitle

The text of the subtitle.

Localized String
fade-in

If the title location is used, The time if takes the title to fade in.

Number (Without Decimal)20
stay

If the title location is used, The time if takes the title to stay on screen.

Number (Without Decimal)40
fade-out

If the title location is used, The time if takes the title to fade out.

Number (Without Decimal)20