Minetest on a Stick

A Luanti server with Minetest Game built in, on an ESP32-S3. Version 0.1.0.

Install from your browser

Connect the board to this computer by USB, then press the button for your board. Your browser asks which serial port to use: pick the board's (often "USB JTAG/serial debug unit").

This needs Chrome, Edge or Opera on a desktop or laptop (they can talk to USB serial devices). Firefox and Safari can't, nor can phones.

The Waveshare ESP32-S3-LCD-1.47, a USB stick with a small screen showing the server's address and its players Waveshare ESP32-S3-LCD-1.47 The USB stick with a 1.47" screen and a microSD slot. Your browser can't do this: use Chrome or Edge on a computer. This page must be opened over https to install.
LCDwiki's ES3N28P, a board with a 2.8 inch screen showing the server's device page LCDwiki ES3C28P or ES3N28P The boards with a 2.8" screen (with or without touch). Your browser can't do this: use Chrome or Edge on a computer. This page must be opened over https to install.
LilyGO's T-Display-S3 in a black case, its 1.9 inch screen showing the USB drive page LilyGO T-Display-S3 The board with a 1.9" screen and two buttons. It has no SD card slot, so the game is kept in the board's own flash (about 11 MB). Your browser can't do this: use Chrome or Edge on a computer. This page must be opened over https to install.

Things to know

After installing

  1. The board restarts and, with no Wi-Fi network to join yet, starts its own hotspot. Its screen shows the hotspot's name and password, and a QR code for a phone's camera.
  2. Join the hotspot with a phone or laptop and open http://192.168.4.1 in a browser: the settings page.
  3. Add your Wi-Fi network, and press Save and restart on Wi-Fi. The board joins it, and its screen shows the address to use.
  4. In Luanti, open Join Game, enter that address and port 30000, and pick a name and password. The first player to log in becomes the administrator, so make that you.

To get back to the settings page later, hold BOOT for a second just after the board starts: it starts the hotspot instead of joining Wi-Fi.

Other ways

The firmware files are also on the releases page, one per board, each a single image to write at address 0, with espflash or esptool:

espflash write-bin 0x0 minetest-on-a-stick-waveshare-0.1.0.bin
esptool.py --chip esp32s3 write_flash 0x0 minetest-on-a-stick-waveshare-0.1.0.bin

To build it yourself, with your Wi-Fi details built in, see Building and flashing.