- Kotlin 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| app | ||
| gradle/wrapper | ||
| .gitignore | ||
| build.gradle.kts | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| README.md | ||
| RELEASE_NOTES_0.1.0.md | ||
| RELEASE_NOTES_0.1.1.md | ||
| RELEASE_NOTES_1.0.0.md | ||
| RELEASE_NOTES_1.0.1.md | ||
| RELEASE_NOTES_1.0.2.md | ||
| RELEASE_NOTES_1.0.3.md | ||
| settings.gradle.kts | ||
Minecraft Mobile
Current version: 1.0.3
Minecraft Mobile is a native, phone-first Android operator app for the existing Minecraft Dashboard. It connects directly to that dashboard's HTTPS API; it does not embed the web interface and does not connect to the Minecraft game or RCON ports from the phone.
Included
- One focused Minecraft server connection with a first-run setup flow.
- Automatic dashboard login and re-authentication after a web session expires.
- Live service state, uptime, version, memory, CPU time, process ID, player totals, and visible player names.
- Pull-to-refresh, a 30-second foreground refresh, and live journal streaming.
- Confirmed start, stop, and restart controls.
- Official stable-release checks and confirmed server upgrades through the dashboard's verified backup/rollback process.
- A native Minecraft admin console backed by the dashboard's CSRF-protected RCON endpoint. The RCON password never reaches the app.
- Editable server name, HTTPS dashboard address, and passphrase.
- A Minecraft-specific visual identity and bundled realm artwork.
The address and passphrase are stored together in an AES-GCM encrypted payload using an app-specific key held by Android Keystore. Removing the connection erases the payload. Android backup and device transfer are disabled, and no address, credential, cookie, or private key is included in source code or the APK.
Requirements
- Current Android Studio with JDK 17.
- Android SDK Platform 37 and SDK Build Tools 36.0.0 or newer.
- Android 8.0 (API 26) or newer.
- A current
minecraft-dashboarddeployment reachable through HTTPS with a certificate trusted by Android. - Dashboard RCON support configured if the native admin console is required.
Release builds trust only Android's system certificate store and require HTTPS. Debug builds additionally trust user-installed certificate authorities for safe private-development testing. Hostname and TLS verification are never bypassed.
Build
Open the project in Android Studio, or build from PowerShell:
.\gradlew.bat testDebugUnitTest assembleDebug
The versioned test APK is written to:
app/build/outputs/versioned-apk/minecraft-mobile-v1.0.3-debug.apk
First connection
- Enter a friendly name for the realm.
- Enter the public Minecraft Dashboard origin, such as
https://minecraft.example.com. - Enter the same passphrase used by the web dashboard.
- Select Connect securely. The app tests the login before saving anything.
Use the top-right menu to edit or remove the saved connection. All lifecycle, update, and RCON actions are confirmed or intentionally submitted in the app.
Scope
This app is intentionally only for the Minecraft side of the game fleet. It does not include Nexus fleet views, other game dashboards, dashboard installation, system configuration, or direct SSH access.
Changes in 0.1.0
- Initial Minecraft-only Android client derived from the Nexus Mobile framework.
- Added encrypted single-server setup, native monitoring and controls, live logs, update management, and the Minecraft RCON console.
Changes in 0.1.1
- Consumes role capabilities returned by Minecraft Dashboard.
- Hides the RCON console completely for restricted user sessions.
- Preserves RCON access for admin and legacy single-password dashboards.
Changes in 1.0.0
- Promotes the tested staging build to the first stable Minecraft Mobile release.
- Includes encrypted connection storage, live monitoring and logs, lifecycle and update controls, and the capability-gated native RCON console.
Changes in 1.0.1
- Moves start, stop, and restart controls directly below the live server status summary so the most common operator actions are immediately available.
Changes in 1.0.2
- Removes the internal updater phase label from the server update panel to match Nexus Mobile and keep the controls clear for non-technical users.
Changes in 1.0.3
- Reorders the dashboard around everyday priorities: status, controls, updates, player details, telemetry, the capability-gated admin console, then logs.