ansible-minecraft

This is a fork from the https://github.com/devops-coop/ansible-minecraft/ Project, thanks for the basement!!!

This role installs Minecraft or Spigot and configures it to run under systemd.

Features

• supports vanilla Minecraft and Spigot
• supports Debian >9, Ubuntu 14.04, Ubuntu 16.04, Ubuntu 18.04, CentOS 7 & 8, Fedora 29 - 34
• safely stops the server using stop when running under systemd
• uses Docker and Molecule to run integration tests
• manages user ACLs
• manages Bukkit/Spigot Plugins
• manages server.properties
• hooks: include arbitrary tasks at specific stages during execution

Out of Role Scope

• install a Java Runtime, this must be done, before you use this Role, you can use nolte/ansible-role-msopenjdk for example.
• executing backups and recovery
• healthy checks like Minecraft-Region-Fixer
• handle utility services like filebeat or prometheus
• install additional Tools like rcon-cli.

All of this is needet but not a part of this role!, you will find examples at nolte/minecraft-infrastructure.

Usage

By default this role will be install a Vanilla Minecraft Server.

Install

   ansible-galaxy install nolte.minecraft

or add this to your requirements.yml

- name: nolte.minecraft

and execute ansible-galaxy install -r requirements.yml

Use

  - hosts: minecraft
    roles:
       - { role: nolte.minecraft, minecraft_whitelist: ["jeb_", "dinnerbone"]}

Requirements

• Python 3.x on the Ansible control machine to generate user ACLs
• Ansible 2.7.0+ on the control machine to fetch the Minecraft version
• Existing Compatible Java Runtime for start and install Minecraft on target System.

Contributing

The best way to contribute is to use this role to deploy your own Minecraft server! We really appreciate bug reports from the wild.

If you'd like to help with the project itself, here are some other ways you can contribute:

• Add support for additional servers like Cuberite.
• Write integration tests for Minecraft- or Spigot-specific configuration.
• Share useful hooks.
• Fixing Typos ...

License

Apache 2.0

Disclaimer

To execute an automatic installation you must accept the Minecraft EULA. Be aware that by using this role, you implicitly accept the same EULA. You can handle the acception by using a Environment Property like: export mc_accept_eula=true the default is false for disagree.