This website will assist you in writing the YAML files necessary for submitting maps to Avicus.Get Started!
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.
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".
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:
A duration defines a period of time. A duration is suffixed by an integer, then a type of time such as
for minutes or
for hours. This example results in a duration of 25 minutes.
An integer is essentially a whole number. Negative infinity to infinity, no decimals. It is typically used to describe an amount.
Used when greater precision than an integer is possible such as in the case of changing the velocity of arrows shot or player speeds.
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.
Can only be 'true' or 'false', nothing else. It is used to toggle a feature.