MCinaBox - A Minecraft Java Edition Launcher on Android
[Now in English] 切换为简体中文
If you find problems when you run MCinaBox, you can check Q&A first.
Instruction
- MCinaBox is a Launcher of Minecraft Java Edition on Android. The core functionality is powered by CosineMath's BoatApp project.
Discord
Join
![Discord Banner 2](https://discord.com/api/guilds/808182854718062623/widget.png?style=banner2)
Contents
Background
MCinaBox
is an open source project with the goal of building and developing a Minecraft Java Edition launcher that runs on an Android.
Front End
provides User Management, Minecraft Version Management, Minecraft Game Controller, Minecraft Startup Parameter Generation, Configuration Backend, etcConfiguration
and Management
functions to reduce the workload of complete launcher development.
Backend
provides JRE runtime environment, Minecraft runtime environment, etc core
functionality.
Composition
MCinaBox consists of a front end and a back end.
Change Log
Build
Environment
- Android Studio
- Android NDK
- Git
Clone
git clone https://github.com/AOF-Dev/MCinaBox.git
Import
- Import this project in your Android Studio.
Build
- Build via Android Studio.
Release
- You can also get released apk from here.
Usage
Installation
- Download the latest APK and runtime to your Android phone.
- Then start APK and find
Launcher Settings
- Import Runtime
. Click Import
to import runtime.
- Alternatively, you can move the runtime to
/ sdcard / Android/ com.aof.mcinabox/files/MCinaBox/runtime
, and then repeat the previous step.
Start
- First, you need to create a user. Click
User
- Add new User
to create a user.
- Second, you need to download Minecraft. Click
Game List
- Install new version
to download Minecraft.
- Finally, you will start the game. Please select a Minecraft version on
home page
and start the game.
Forge API
- First, download Forge-Installer from Forge. It must be in
Universal
and jar
format.
- Then put the downloaded jar file in
/sdcard/Android/com.aof.mcinabox/files/MCinaBox/forge
.
- Finally, open the MCinaBox and click
Launcher Settings
- Forge Installer
to select and install the forge.
Customize
- MCinaBox offers a number of customization options, you can configure your launcher parameters in the
Game List
- Global Game Settings
.
- MCinaBox provides the ability to customize your Minecraft working directory by configuring your Minecraft working directory in the
Game Directory
.
- MCinaBox provides the ability to customize your game controller by creating your virtual keyboard layout in the
Virtual Keyboard Settings
.
Online
- MCinaBox supports Mojang's official server authentication. When you create a user, you can check
Online login
and enter your Mojang account and password to log in.
- MCinaBox supports server authentication for Authlib-Injector. When you create a user, you can check
Online login
, enter your account and password, and verify the address of the server to log on.
- MCinaBox will not record your password in any way.
Preview
Known Issues
Launcher
- Microsoft Authentication API is not added, so you'll not be able to login with Microsoft Account.
Launch Minecraft
- Forge's loading animation will cause a crash
- It seems that there will be an X11 error when starting the Minecraft version below 1.6
Maintainers
@AOF-Dev
License
The software is distributed under GPL v3 with additional terms.
Additional terms under GPLv3 Section 7
- When you distribute a modified version of the software, you must change the software name or the version number in a reasonable way in order to distinguish it from the original version. [under GPLv3, 7(c).]
- You must not remove the copyright declaration displayed in the software. [under GPLv3, 7(b).]
Contribution
This project exists thanks to all the people who contribute.
List of contributors:
- ALL
MCredbear
- All people who put forward issues.
If you want to submit a pull request, there're some requirements:
- IDE: Android Studio
- TargetSDK: 22
- MimniumSDK: 21
- DO NOT modify
gradle
files.
Related
- BoatApp (CosineMath,GPL 2.0)
- Gson (Google,Apache 2.0)
- XZ for Java (Lasse Collin,Public Domain)
- JNDCrash (ivanarh,Apache-2.0)
- FileDownloader (lingochamp,Apache-2.0)
- BubbleLayout (MasayukiSuda,All)
- AndroidRocker (kongqw,All)
- colorpicker (QuadFlask,All)
Runtime Pack
- GL4ES (ptitSeb,MIT)
- OpenJDK-8 (CosineMath,GPL-2.0)
- OpenJDK-8 (CosineMath,GPL-2.0)
- lwjgl2.x (CosineMath,All)
- lwjgl3.x (CosineMath,All)
- glfw (CosineMath,All)
- openal-soft (kcat,GPL-2.0)