penguincoder
/
vagrant-minecraft
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
A simple and effective Vagrant setup for vanilla Minecraft and the Minecraft Overviewer
13 Commits
1 Branch
0 Tags
35 KiB
Python 41.3%
Dockerfile 24.2%
Makefile 24%
Shell 10.5%
 
 
 
 
Go to file
Andrew Coleman 96cf95c147 use new make system 2017-06-12 16:35:18 -04:00
caddy remove local directory reference and use original overviewer target directory 2017-06-12 15:49:06 -04:00
minecraft-server add make based minecraft server 2017-06-12 16:33:02 -04:00
overviewer use make based overviewer 2017-06-12 16:34:57 -04:00
.gitignore Initial commit of vagrant + minecraft 2015-03-26 13:13:51 -05:00
LICENSE Initial commit of vagrant + minecraft 2015-03-26 13:13:51 -05:00
README.md update docs 2017-06-12 16:34:40 -04:00
Vagrantfile Update to alpine linux base 2017-05-10 13:01:27 -04:00
provision.sh use new make system 2017-06-12 16:35:18 -04:00

README.md

Vagrant + Minecraft Server

Why?

There are simple servers for most Unix and Windows operating systems, sure, but do you want the hassle of installing Java and its constant need for updates? Do you want to manage starting the actual server itself? Probably not. I know I don't want to.

This is also helpful to give to your buddies so they can run their own local server, or it's very handy for a LAN party.

This stack uses the vanilla Minecraft server, Minecraft Overviewer set to the leaflet development branch, and caddy to serve static HTML files.

How?

  • Install Vagrant
  • Install VirtualBox if you don't already have one.
  • Clone this repo
  • vagrant up

Alternative How?

If you want to run this stack directly, without the use of a VM, the process is painless. You do need a few things installed, but the list of required items is quite short. You need an 'ecosystem' directory (just a place to put the server and the overviewer). For instance, this might be /home/notch/mcserver. It is not likely to be the Vagrant default, so be sure and set this variable!

  • Install Docker
  • Ensure GNU Make is installed (specific to your operating system)
  • export MC_HOME=/path/to/minecraft/ecosystem somewhere, probably in your ~/.bashrc
  • cd vagrant-minecraft && ./provision.sh

Once the ecosystem is up and running (check with docker ps), you can remove and restart individual components by cding into the directory and then running make clean && make for the minecraft server, overviewer, and caddy.

What this provides

This repository gives you access to a fresh-built VM hosting the newest version of vanilla Minecraft. It also generates a map of your world and keeps it up to date daily. There is nothing for you to do or configure. It Just Works(TM).

From your machine

From other machines

You will need to manage your local firewall settings accordingly. This process works much better if you have local DNS resolution from a fine product like pfSense or DD-WRT.