ansible-minecraft's Introduction

ansible-minecraft

Install Minecraft on Debian Jessie.

To build a Minecraft Docker container see docker-builder/README.md.
To deploy a Minecraft Docker container see docker-deploy/README.md.

To install Minecraft without Docker, continue :).

Requirements

Ansible.
Vagrant (If you want to build the Docker container).
- VirtualBox or vmware.
A Debian Jessie server (May work on Ubuntu).

You will need to add your server's IP to the inventories file.

How to run

Example ansible command: ansible-playbook -i inventories playbook.yml -u <user>.

Configurable options

To see all available configurable options and their defaults see roles/minecraft/defaults/main.yml.

Example Playbook:


- hosts: minecraft
  become: yes
  vars:
    update_server: yes
    agree_to_eula: "true" #Do you agree to the eula? See https://account.mojang.com/documents/minecraft_eula
    install_location: "/home/minecraft"
    minecraft_version: 1.9
    minecraft_url: "https://s3.amazonaws.com/Minecraft.Download/versions/{{ minecraft_version }}/minecraft_server.{{ minecraft_version }}.jar"
    minecraft_sha256sum: "38a797f50c71f55202e2135a30302cf3a5c8cb494c6d225b88599542957d3a7d"
    java_options: "-Xms2048M -Xmx2048M -jar {{ install_location }}/minecraft_server.{{ minecraft_version }}.jar nogui" #Change the Xms and Xmx values base on the resources of your server.
    white_list: "true"
    white_list_include:
      - username1
      - username2
  roles:
    - minecraft

Acknowledgements

Used directions off of a gamepedia Minecraft Tutorial

Things to Consider

As of right now I am not including any sort of Firewall rules (Such as iptables). Before installing and running any server(particularly minecraft) you should understand the implications.

Recommend Projects