[Now is English] 切换为简体中文

• There is a problem with the latest source code. Some functions are not working properly.
• Because I have no time to maintain the project, the latest source code is not perfect.

• Background
• Change Log
• Build
• Usage
• Preview
• Known Issues
• Maintainers
• Contribution
• Related
• License
• Q&A

Origin I discovered the BoardwalkApp a few years ago, which can launch Minecraft Java Edition on Android devices. It's so exciting to see minecraft start on my phone.It's really a curious and interesting project
MCinaBox is an open source project, and the back end is supported by the BoatApp project. And in the efforts of many people to make it run.

zhuowei 's BoardwalkApp https://github.com/zhuowei/Boardwalk
CosineMath 's BoatApp https://github.com/CosineMath/BoatApp

• English
• Chinese

• Android Studio
• Android NDK
• Git

• git clone https://github.com/longjunyu2/MCinaBox.git

• Import this project in your Android Studio.

• Build via Android Studio.

1. Download the latest APK and runtime pack to your Android phone.
2. Install APK and start it at least one time.
3. Copy the runtime to /sdcard/Android/data/com.aof.mcinabox/files/MCinaBox/runtimepack/
4. Then start APK and find Launcher Set to import the runtime pack.

1. Before you start the game, you need to configure the starter according to the instructions in the software. Until the indicator changes from red to blue.
2. What you need to do includes creating users, modifying the maximum memory, downloading game versions, and creating your own virtual keyboard templates.

In theory, forge is supported, but we need to make some changes to start it.

1. Copy an installed version of forge from your computer to /sdcard/mcinabox/.minecraft/, including libraries and versions
2. Launch it in MCinaBox at least one time. (As a result, it can't be started)
3. Edit /sdcard/MCinaBox/.minecraft/config/splash.properties to change enabled=true to enabled=false to close forge loading animation.
4. Try to launch forge again. It's going to be black for a while, but it's usually useful.

1. Mipmap will cause rendering problems. Please turn it off in Minecraft settings - video settings - mipmap=0

1. Unable to request more memory from the system, the upper limit is determined by the system

1. Forge's loading animation will cause a crash
2. It seems that there will be an X11 error when starting the Minecraft version below 1.6
3. Unable to initialize Minecraft 1.13.x
4. Minecraft 1.14.X ~ 1.15.X has rendering problems
5. Too fast key input may cause lwjgl to crash

@longjunyu2

The software is distributed under GPL v3 with additional terms.

1. 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).]
2. You must not remove the copyright declaration displayed in the software. [under GPLv3, 7(b).]

This project exists thanks to all the people who contribute.

• ALL
• MCredbear
• TSaltedfishKing
• All people who put forward issues.

If you want to submit a pull request, there're some requirements:

• IDE: Android Studio
• TargetSDK: 21
• MimniumSDK: 21
• Do NOT modify gradle files.

BoatApp (CosineMath,MIT)
Gson (Google,Apache 2.0)
XZ for Java (Lasse Collin,Public Domain)
JNDCrash (ivanarh,Apache-2.0)
GL4ES (pitiSeb,MIT)
FileDownloader (lingochamp,Apache-2.0)
BubbleLayout (MasayukiSuda)
AndroidRocker (kongqw)
colorpicker (shixiuwen)
OpenJDK-8 (CosineMath,GPL-2.0)
lwjgl2.x (CosineMath)
lwjgl3.x (CosineMath)
glfw (CosineMath)
openal-soft (kcat,GPL-2.0)