Minecraft Playbook
This playbook installs Java and EMSM (and, through it, Minecraft) on a Unix server. It also configures zero or more worlds on the server, and is able to install some mods (in particular, Forge-based mods).
Accepting EULAs
Both Java and Minecraft require accepting EULAs in order to run the software. These playbooks do so automatically, but require you to explicitly opt in to this behavior.
Do so by setting the following as host variables:
accept_java_eula: yes
accept_minecraft_eula: yes
Defining Worlds
Worlds are defined using the worlds
variable, defined as a list.
Each item in the list defines a world name (name
), a version of the
Minecraft server (server
), and optionally a list of mods to install
(mods
) and players to have op on the server (ops
).
All world properties are set to the Minecraft defaults, and may be overridden
individually by passing them to properties
within each world.
A complete sample world definition looks like this:
worlds:
- name: A Minecraft World
server: minecraft forge 1.8
mods:
- 'http://files.minecraftforge.net/maven/com/github/glitchfiend/biomesoplenty/BiomesOPlenty/1.8-3.0.0.1165/BiomesOPlenty-1.8-3.0.0.1165-universal.jar'
- 'http://marglyph.s3.amazonaws.com/TooManyItems2015_02_14_1.8_Forge.jar'
ops:
- uuid: 2f6a0860-1815-4dd1-817b-789c47bdb7ba
name: lukesneeringer
level: 4
properties:
level_type: BIOMESOP
pvp: 'false'
server_port: 25565
Notes:
- Server versions are defined by EMSM; check its documentation.
Generally it should either be
vanilla x.y
orminecraft forge x.y
, in lower-case. - Ops must be defined including the
uuid
,name
, andlevel
. You can look up a player's UUID if you need to. - It is best to always explicitly define the
server_port
. - If you need to pass a boolean value to any property, make sure you do so as a string (as done in the example above).
License
All code provided here is considered to be licensed as New BSD
(see the LICENSE
file).
The software that this playbook installs is licensed under their own terms; using this does not alter that.