Fork of jacobwgillespie/heroku-minecraft modified to run Glowstone server
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
proxy
.buildpacks
.gitignore
Gemfile
Gemfile.lock
LICENSE
Procfile
Procfile-localbridge
Procfile-web
README.md
package.json
pom.xml
requirements.txt
run.sh
runtime.txt

README.md

Heroku Glowstone

Glowstone finds a way.

This is a very alpha-quality Heroku app that runs a Glowstone server on a single dyno.

Limitations

Since Heroku is a bit of a weird platform, there are a couple of caveats to running a Glowstone server on it.

  • Since Heroku no longer supports TCP routing, we're proxying the connection through WebSockets. This means each client will have to run a little tool to turn the WebSocket connection back into a regular TCP Glowstone connection. This is detailed below in the "Client" section.

  • Heroku has no persistant storage, so you will have to have an Amazon AWS account and an Amazon S3 bucket ready to store your world data. Your world data will be automatically synced to and from S3 in the background.

Server Setup

  1. Clone this repository using git (or, if it's easier, GitHub for Mac, or GitHub for Windows).

  2. Create a new Heroku app with a custom buildpack.

    heroku create my-app-name
    heroku buildpacks:add  heroku/ruby
    heroku buildpacks:add heroku/python
    heroku buildpacks:add heroku/java
    heroku buildpacks:add heroku/nodejs
  3. Add your Amazon AWS credentials and S3 bucket name to the Heroku configuration. This enables data persistence. Otherwise, your server will be wiped each time it is restarted.

    heroku config:add AWS_KEY=xxxxxxx AWS_SECRET=yyyyyyyyyyyyyyyyy S3_BUCKET=my-bucket-name
  4. Push the app to Heroku.

    git push heroku master

Client Setup

Install https://github.com/leonardosantos/hmwtc, then:

hmwtc my-app-name.herokuapp.com

Credits

Based on original implementation of heroku-minecraft by Jacob Gillespie. See the contributors list - many awesome people have contributed.