YMLs Explained and how to write them simply! by RightSide May 16, 2015 at 3:05 PM UTC

Well months ago I didn't know how to write YMLs and I wanted to learn and I self taught myself here's how I did it. You may be asking why did you do this but why I did this is to mainly get a YML and explain what it is or how to do it! Yes its alot of writing but it's really easy to read and then you can learn to look at other YMLs look here not everyone makes them in the same order or use different ways I tried to use the most simplest . I recormend using the following program to write the YMLs its called Sublime Text 2 click here to download! Make sure you read most of the text to fully understand or know what to do. This taken a while to make I just had some spare time so I make this and to help those you don't know how to make them!

This is mainly for DTM. (Make sure they are all in-line or as follows to check if they work or lined up correctly goto a YML Parser to check). To help me alot you can copy a previous YML and change/remove/add more code saves lots of time and you won't forget anything!
Examples here have been used from mixed YMLS.

===================================================================================
1. First start off with a section looking like this:

info:

title: 'NAME OF MAP'

world: 'NAME OF MAP'
version: 1.0 (Version your map is).

type: dtm (Gamemode like TDM CTW etc Please note for different gamemodes YMLs change). creators:

- ElementProHD

spawn: -39.5,86,-62.5,-90,0 (This is the world spawn/spectator location).

===================================================================================

2. Once you have done you can start with anything but I do it like this :

remove-drops: (This is the list of items you want to remove off the GROUND).

- golden helmet

- leather chestplate

- iron leggings

- leather boots

- glass

- steak

repair-drops:

- iron sword (This will remove items that are on the ground instead of leaving them).

- bow

- diamond pickaxe

===================================================================================

3. Next work on the load out with tells the server or plugin what items it needs to give each player:

loadout:

effects:

- damage resistance:5,5 (This section is for any effects players goto bottom).

helmet:

item: leader helmet (This is for what you want in each armour slot

chestplate: they don't have to be filled).

item: leather chestplate

leggings:

item: iron leggings

boots:

item: leather boots

0: (The 0 means 1st slot in the hotbar scroll to bottom).

item: iron sword (Iron sword is the item it will give you in first slot).

item: bow

enchants:

- arrow_infinite:1 (This is a enchantment for a bow scroll to bottom for more).

item: diamond pickaxe

item: log:2

amount: 32 (This is the amount of item you want to give no more than 64)

item: glass

amount: 32

item: golden apple

amount: 3

item: steak

amount: 32

item: exp_bottle

amount: 4

27:

item: arrow

amount: 1

28:

item: lapis block

amount: 1

===================================================================================

This is a list of all the effects : Source : https://docs.avicus.net

Name	Effect
ABSORPTION	Increases the maximum non-regenerable health of an entity, but is refilled every 30 seconds.
BLINDNESS	Blinds an entity.
CONFUSION	Warps vision on the client.
DAMAGE_RESISTANCE	Decreases damage dealt to an entity.
FAST_DIGGING	Increases dig speed.
FIRE_RESISTANCE	Stops fire damage.
HARM	Hurts an entity.
HEAL	Heals an entity.
HEALTH_BOOST	Increases the maximum health of an entity.
HUNGER	Increases hunger.
INCREASE_DAMAGE	Increases damage dealt.
INVISIBILITY	Grants invisibility.
JUMP	Increases jump height.
NIGHT_VISION	Allows an entity to see in the dark.
POISON	Deals damage to an entity over time.
REGENERATION	Regenerates health.
SATURATION	Increase food level of an entity each tick.
SLOW	Decreases movement speed.
SLOW_DIGGING	Decreases dig speed.
SPEED	Increases movement speed.
WATER_BREATHING	Allows breathing underwater.
WEAKNESS	Decreases damage dealt by entity.
WITHER	Deals damage to an entity over time and gives the health to the shooter.

This is a list of all the item slots as follows :

Here is a list of the available enchantments different to vanilla minecraft :

Name	Effect
ARROW_DAMAGE	Applied to bows to provide extra damage.
ARROW_FIRE	Sets entities on fire when shot.
ARROW_INFINITE	Provides infinite arrows when shooting with a bow.
ARROW_KNOCKBACK	Provides a knockback when an entity is hit by an arrow from a bow.
DAMAGE_ALL	Called Sharpness in Minecraft, this applies inreased damage on any item.
DAMAGE_ARTHROPODS	Increases damage against all arthropod targets.
DAMAGE_UNDEAD	Increases damage against undead targets such as Zombies.
DIG_SPEED	Increases the rate at which you mine/dig.
DURABILITY	Decreases the rate at which a tool loses durability.
FIRE_ASPECT	When attacking a target, it has a chance to set them on fire.
KNOCKBACK	All damage to other targets will knock them back when hit.
LOOT_BONUS_BLOCKS	Provides a chance of gaining extra loot when destroying blocks.
LOOT_BONUS_MOBS	Provides a chance of gaining extra loot when killing monsters.
OXYGEN	Decreases the rate of air loss whilst underwater.
PROTECTION_ENVIRONMENTAL	Provides protection against environmental damage.
PROTECTION_EXPLOSIONS	Provides protection against explosive damage, such as TNT and creepers.
PROTECTION_FALL	Provides protection against fall damage.
PROTECTION_FIRE	Provides protection against fire damage.
PROTECTION_PROJECTILE	Provides protection against projectile damage, such as arrows.
SILK_TOUCH	Allows specific blocks to drop themselves instead of their typical drops.
THORNS	Damages the attacker.
WATER_WORKER	Increases the speed at which a player may mine underwater.

Team colours as follows :

RED

LIGHT_RED

BLUE

GREEN

LIME

YELLOW

ORANGE

PURPLE

PINK

GRAY

NAVY

WHITE

LIGHT_GRAY

Source : https://docs.avicus.net

===================================================================================

4. Next work on the teams you want (Colours above^) :

teams:

yellow: (This is the colour).

spawn: -0.5,66,-130.5,-0,0 (This is for the TEAMS spawn point).

title: Losers (Title for the team).

max: 15 (Maximum of players in the team make the other the same).

===================================================================================

5. Next work on the monuments for that mean and add a extra part like this:

teams:

yellow:

spawn: -0.5,66,-130.5,-0,0

title: Losers

max: 15

monuments: (Monuments title).

a: (This is a example if you want more just add a extra like below:).

name: Left (Title that is displayed for this monument).

location: 18,67,5 (This is cords for monument when measuring make sure your head is in mon).

name: Right

location: 76,34,4

name: Middle (This is if you want to add extra).

location: 34,33,9

===================================================================================
6. Next just do another for the other team and put them together like this:

teams:

yellow:

spawn: -0.5,66,-130.5,-0,0

title: Losers

max: 15

monuments:

name: Left

location: 18,67,5

name: Right

location: -20,67,5

purple: (This is for the second team).

spawn: -0.5,66,5.5,-180,0

title: Winners

max: 15

monuments:

name: Left

location: -20,67,-131

name: Right

location: -53,67,342

===================================================================================

7. This is probably the hardest part just look at images below for more help (This will protect blocks from players breaking them used for protecting spawns etc):

red-spawn: (Title of region this won't be displayed more regions).

type: cylinder (Type of shape for region).

center: -42,34,-814 (Center of the cylinder).

radius: 13 (Radius more info here)

height: 7 (Height more info here)

flags:

build:

who: '*' (This means message to everyone)

message: 'Message to players' (Message will be sent if they try and break it, make it coloured)

box:

type: cuboid (Type of region this won't be displayed more regions)

min: 1 57 1 (This is cords for the bottom corner).

max: 10 53 10 (This is the top corner of the cuboid opposite to other one)

flags:

build:

who: '*'

message: '&cYou may not edit this loaction!' (Message to player trying to edit region).

This is points for a cuboid :

===================================================================================

8. You are actually done but here are some useful things to put have in your YML this a part copied from Formorgar 1 and it means that when theres a gold block on the floor it changes/modifies it to 4 XP bottles:

everywhere: (Applies everywhere on map).

type: global

flags:

build:

who: '*' (Works for everyone this means).

allow: true

triggers: (What triggers the action).

modify_drops:

type: gold_block (Item that will be replaced on the ground).

drops:

item: exp_bottle (Item will be changed to 4 XP bottles).

amount: 4

Here is a list of triggers: Source : https://docs.avicus.net

Name	Action	Required Variables
heal	Heals the player	amount Health to give, measured in half-hearts
feed	Satisfy the hunger	amount Number of food points to give, measured in half-food-points
teleport	Move to a location	to The coordinate the player will be teleported to
modify_drops *	Change the drops of destroyed blocks	type The type of block to modify. Use an asterisk to indicate all blocks. drops A loadout containing the items to drops
modify_projectile **	Change the projectile type of a bow shot.	projectile The entity to shoot instead of an arrow velocity The velocity of the entity (default is 2.2)
ignite_tnt ***	Configure TNT to ignite once place	delay Time until explosion in seconds (default is 3.0) block-damage Toggle terrain damage (default is true) yield Percent of block items dropped caused by explosion (default is 0)
give_loadout	Rewards a set of items and effects	loadout A loadout containing to give the killer
set_loadout	Sets the inventory and potion effects for a player. Can function as kits upon clicking a sign for entering an area.	loadout A loadout containing to give the killer
score	Nebula TDM and Nexus trigger that rewards the team with a specified amount of points.	amount Amount of points to give to the team

===================================================================================

Thats mostly all I will be adding more in the future this is how to put together a normal YML it can be easily changed I have used help from https://docs.avicus.net/ which shows you how to make a YML in lots of depth but I thought I would explain it please note this is how to make a 2 Team DTM map.

Hope this helped comment below what you want me to add, improve, if I have made anymistakes, or If I have got something wrong.

Eteh May 16, 2015 at 3:05 PM UTC

Thanks for writing this! It helps, I might try it. This should be stickied

ViceTechnicolour May 16, 2015 at 3:05 PM UTC

The spelling, formatting, and bolding makes this really confusing... I feel that as for a more reliable source that is made by kylo and I, docs.avicus.net provides this and more + pictures such as how cuboids and spheres work.

If there's anything requested for the docs site, I can try to add it but keep in mind there's a new doc site coming soon.

resepignev May 16, 2015 at 3:05 PM UTC

The spelling, formatting, and bolding makes this really confusing... I feel that as for a more reliable source that is made by kylo and I, docs.avicus.net provides this and more + pictures such as how cuboids and spheres work.

If there's anything requested for the docs site, I can try to add it but keep in mind there's a new doc site coming soon.

Agreed +1

RightSide May 16, 2015 at 3:05 PM UTC

The spelling, formatting, and bolding makes this really confusing... I feel that as for a more reliable source that is made by kylo and I, docs.avicus.net provides this and more + pictures such as how cuboids and spheres work.

If there's anything requested for the docs site, I can try to add it but keep in mind there's a new doc site coming soon.

The main aim was to try and explain it more xD

Edit also the cuboid image doesn't work :).

Robin_DD_J May 16, 2015 at 4:05 PM UTC

https://docs.avicus.net ?

RightSide May 16, 2015 at 4:05 PM UTC

https://docs.avicus.net ?

Yes I just explained it more and ran though a YML.

Robin_DD_J May 16, 2015 at 4:05 PM UTC

Yes I just explained it more and ran though a YML.

Ow, my bad

RightSide May 16, 2015 at 5:05 PM UTC

Ow, my bad

Its ok :)