Avicus YAML Documentation

This website will assist you in writing the YAML files necessary for submitting maps to Avicus.

Get Started!

How it all works...



You can write YAML code that contains information regarding a map. This includes anything from the map title to what entity a bow should shoot, and everything in between. The majority of this website is dedicated to explaining what exactly you can do with these YAML files.


Our plugins read the YAML code and compute this information, basically translating readable English into computer recognizable data.


Everything written in the YAML file is now used as groundrules for matches played on your map. Each team will spawn in the specified location, they will spawn with the loadout written, etc.

Basic Requirements

A plain text editor will work fine with creating a YAML file, but we highly recommend Sublime Text (Windows, Mac, Mac) for doing so as it makes formatting easy and some references to this program may be included in our documentation. It may be downloaded and evaluated for free, though a license is necessary for continued use.

YAML Basics

YAML is a very simple markup language, despite it's name (YAML Ain't a Markup Lanuage). There are a few very important things to take note of when writing in YAML.


There can be no tab characters. Instead, indentation must be done in the form of two spaces like shown in the following example. Before title and world, there are two spaces.


Sections in YAML are used to categorize and organize configration options. The following example represents a section named "info" with the configuration options "title", "world", "duration", "build", and "time-lock" inside. When referring to options inside a section, you may use the format "section_name.config_option". For example, "info.title" would return "Ravaged" since "title" is inside the section "info".

Variable Types

There are multiple types of variables used in YAML that you should know before starting.


A string is a any segment of text that is primarily made up of alpha numerics. In order to avoid errors and for readability, you should surround strings with apostrophes like so:

title: 'Ravaged'


A duration defines a period of time. A duration is suffixed by an integer, then a type of time such as s for seconds, m for minutes or h for hours. This example results in a duration of 25 minutes.

duration: 25m


An integer is essentially a whole number. Negative infinity to infinity, no decimals. It is typically used to describe an amount.

amount: 32


Used when greater precision than an integer is possible such as in the case of changing the velocity of arrows shot or player speeds.

velocity: 2.52


Coordinates mark a location in your map. It includes the x, y, z locations as well as yaw, the player's direction, and pitch, the player's tilt. These values are all decimals or integers.

spawn: 783.5,76,842.5,0,0


Can only be 'true' or 'false', nothing else. It is used to toggle a feature.

allow: true