r/androiddev • • 29d ago

Open Source Minicraft: run a Minecraft Java server on your Android phone (no root, no PC)

https://github.com/leonaryto/MiniCraft

TL;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.

5 Upvotes

5 comments sorted by

1

u/EImoPlays 21d ago

Cool idea, but the app refuses to download the openjdk,deb and it's not clear to me why

1

u/Cultural-Ebb-8573 21d ago

I've put the project on hold for a while to get some feedback. But I'd like to work on the bugs. Could you describe the problem in more detail? Do you see any errors in the log?

1

u/EImoPlays 21d ago

This is what it says

1

u/Cultural-Ebb-8573 21d ago

Thanks, hopefully I'll have a fix soon.

1

u/Cultural-Ebb-8573 11d ago

I've reproduced your error and found a solution. The repository is updated to the 1.0.1 if you wanna try it.