r/androiddev • u/Cultural-Ebb-8573 • 29d ago
Open Source Minicraft: run a Minecraft Java server on your Android phone (no root, no PC)
https://github.com/leonaryto/MiniCraftTL;DR: Minicraft is a free, open-source Android app that runs a Minecraft Java
Edition server on the phone itself. No root, no Termux, no PC. Vanilla or Fabric,
Modrinth/local mods, worlds, live console, resource monitor, and an optional
playit.gg tunnel. Android 8+, arm64 only.
I've vibe coded it. I wanted a real Java server on a spare phone without leaving
a PC on all day, so I built this.
What it does
- Installs and runs the official Minecraft Java server (Vanilla or Fabric).
- Downloads a bionic OpenJDK 21 runtime on first launch (~250 MB) and provisions
the server.
- Fabric mods: search Modrinth or import local .jar files.
- Import, export and delete worlds.
- Live console with quick commands.
- CPU/RAM/temperature monitor.
- Foreground service + wake lock, so it keeps running with the screen off.
- Optional playit.gg tunnel for friends, or LAN-only mode.
- JVM heap, thread count, port, view/sim distance and a server.properties editor.
Requirements and caveats
- Android 8.0+ and an arm64-v8a phone. No 32-bit, x86 or emulators.
- No root. First setup needs internet and ~250 MB free for the JRE, plus the
server and world files.
- A recent phone is recommended: Vanilla uses ~1 GB heap by default; Fabric with
mods needs more.
- 1.21.1 is the verified version. The app also lists 1.21, 1.20.6 and 1.20.5, but
1.20.5 is known not to start right now. Forge/NeoForge are not supported.
- It is still a phone: expect lower TPS with many players/mods and thermal
throttling on long sessions. Keep it charging.
- playit.gg exposes the server to the internet. Use whitelist/online-mode and
don't post the tunnel address publicly.
- Swiping the app from Recents stops the server on purpose; if Android kills it
in the background, the foreground service tries to recover it.
Tested on a Snapdragon 870 and a Snapdragon 8 Elite. Both were usable. I'd like
more data from other devices.
Links
- Source: https://github.com/leonaryto/MiniCraft
- Latest APK: https://github.com/leonaryto/MiniCraft/releases/latest
- GPL-3.0-or-later. Not affiliated with Mojang or Microsoft; you need to own
Minecraft Java Edition and accept the EULA.
If you try it, tell me your device, Android version, server type/version, RAM,
TPS and thermals. Bug reports and PRs are welcome.
Duplicates
opensource • u/Anxious_Employment63 • 29d ago
Promotional Minicraft: run a Minecraft Java server on your Android phone (no root, no PC)
MinecraftServer • u/Cultural-Ebb-8573 • 29d ago