This project was built on-stream. It's a Java application that starts a Minecraft server and a webserver. The webserver is designed to handle webhook requests from Twilio's Programmable SMS API and forward the SMS body as a command to the MC server.
(remember, this is a work-in-progress!).
- Download the minecraft server jar from https://www.minecraft.net/en-us/download/server/.
- Run it by hand:
java -jar server.jar
. You will get a message about the EULA. - Read the EULA then change the
eula.txt
file to indicate that you've read and understood it.
- Create a Twilio account and buy a phone number: https://twilio.com/try-twilio
- Use
ngrok
from here to create a public URL forlocalhost:4567
:ngrok http 4567
- Copy the ngrok forwarding url (better use the HTTPS one), and set the webhook URL for your Twilio number to
<YOUR NGROK URL>/mc
- Clone the repo and load it into your IDE
- Check the path for the Minecraft server is set correctly here.
- Run the main method in your IDE
Run Minecraft game client locally and connect to a server on localhost:25565
.
Send SMS to your Twilio number with Minecraft server commands, eg say Hello everyone
or weather clear
. There are loads of things you can do.
🎉🎉 ENJOY 🎉🎉