simple login via minecraft (server component / spigot plugin)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sheldon Rupp 35e30ff7b9 Update ViaVersion URL 6 months ago
.docker Update ViaVersion URL 6 months ago
OauthPlugin init 7 months ago
api improved api and fixed some readme 7 months ago
docker-golang-git init 7 months ago
.drone.yml init 7 months ago
.gitignore Add player.csv 7 months ago init 7 months ago Update with Docker installation 7 months ago init 7 months ago
docker-compose.yml Add player.csv 7 months ago


This isnt technically oauth but oh well.

Compatible with Minecraft Client 1.7.X to 1.14.X and further through ViaVersion.
This server and plugin are meant to verify that an mc user exists and is valid.
Inspired by Head over to their description, seriously its a lot better.
Running all build steps below by hand is too complicated?
Try drone exec (requires drone-cli installed) or head over to the releases.


We include a Docker setup out of the box with no configuration needed so you can just deploy this and forget about it.


  1. (Optional) Edit docker-compose.yml to your likings for the port mappings.
  2. Run docker-compose up -d in the project root.


Optional (if building Spigot)

  • Java (any version that can build Spigot, 11 is recommended)

Optional (if building API Server)

  • Go

Optional (but required by Spigot AND API Server)

  • Git

Optional (if building OauthPlugin)

  • Maven


Build Spigot

curl -o BuildTools.jar
  • Build spigot.jar in version 1.8.X (here 1.8.8 but any will work fine)
java -Xmx1024M -jar BuildTools.jar --rev 1.8.8

Install Plugins

  • Install into /plugins ViaVersion
  • (Optional to support Minecraft Clients 1.7.X) Install into /plugins ViaRewind

Get OauthPlugin

Install into /plugins, either

  • build via mvn package (project at OauthPlugin)
  • install release from releases

API Server


go get


Build server.go, either

  • go build server.go
  • install release from releases

Start service

  • start spigot (make sure that all plugins are installed!)
java -jar spigot-1.8.jar
  • start api server


Server will per default attach to port 80 (please use port forwarding in production).

GET /api/{token}



or none