MCinaBox - A Minecraft Java Edition Launcher on Android

Table of Contents

• Background
• Change Log
• Build
• Usage
• Preview
• Known Issues
• Maintainers
• Contribution
• Related Efforts
• License

Background

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. Thanks to Boardwalk, it left a deep impression on me, and since then I have also developed interest and love in programming. I learned Java programming for 8 days through 'Head First Java', and started to write my first Android program MCinaBox with the support of BoatApp Project.

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

Change Log

v0.1.2

• Fix reediting keys caused a crash while repairing virtual keyboard configurations
• Fix some control behavior exceptions in Boat-3 mode
• Add a new downloader to provide visual download progress feedback
• Add the Minecraft Json Parsing Tool Library
• Add multilingual support (preliminary)
• Add Forge and LiteLoader support (see documentation)

v0.1.1

• Fix crashes caused by asynchronous message manager refresh when memory is empty
• Fix crashes caused by null values when adding custom keys
• Fix downloader to duplicate download of existing files
• Fix invalid custom keys with primary key value of mouse in boat-3 mode
• Fix Gallery crash caused by Android media scanning minecraft folder
• Change custom key dialog action button set top
• Add drag to change position when adding custom keys
• Add a status indicator to increase the limit on memory size settings
• Remove temporary removal of integration package import function entry
• Remove more options for temporarily removing Toolbar

v0.1.0

• First Release Version.

Chinese Translation:

v0.1.2

• 修复 虚拟键盘配置时重新编辑键导致的崩溃
• 修正 Boat-3模式中的一些控制行为异常
• 添加 新的下载程序以提供可视化的下载进度反馈
• 添加 Minecraft Json解析工具库
• 添加 多语言支持（初步）
• 添加 Forge和LiteLoader支持（请参阅文档）

v0.1.1

• 修复 内存为空时因异步消息管理器刷新而引发的崩溃
• 修复 添加自定义按键时一些值为空引发的崩溃
• 修复 下载器重复下载已经存在的文件
• 修复 boat-3模式下主键值为鼠标的自定义按键无效
• 修复 Android媒体扫描minecraft文件夹而引发的图库崩溃
• 更改 自定义按键对话框操作按钮置顶
• 添加 自定义按键时拖动来改变位置
• 添加 状态指示器增加对内存大小设置的限制
• 移除 暂时移除整合包导入功能入口
• 移除 暂时移除Toolbar 更多选项

v0.1.0

-第一个发行版本

Build

Environment

• Android Studio
• Android NDK
• Git

Clone

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

Import

• Import this project in your Android Studio.

Build

• Build via Android Studio.

You can also get released apk from here.

Usage

Install

1. Download the lastest 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.

Play

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.

Forge

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

Matters needing attention

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

Preview

Known Issues

Launcher

1. Asynchronous message manager at risk of crashing
2. Language options can not be reloaded well
3. Unable to request more memory from the system, the upper limit is determined by the system
4. Sometimes the downloader gets stuck at 99%. It can be solved by canceling and retrying

Launch Minecraft

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

Maintainers

@longjunyu2

License

The software is distributed under GPL v3 with additional terms.

Additional terms under GPLv3 Section 7

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).]

Chinese Translation:

附加条款（依据 GPLv3 协议第七条）

1. 当你分发本程序的修改版本时，你必须以一种合理的方式修改本程序的名称或版本号，以示其与原始版本不同。 [依据 GPLv3, 7(c).]
2. 你不得移除本程序所显示的版权声明。[依据 GPLv3, 7(b).]

Contribution

This project exists thanks to all the people who contribute.

List of contributors:

• wjyue2001 provides Japanese translation
• MCredbear provides new English translation.(will be used)

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

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

Related Efforts

CosineMath 's BoatApp https://github.com/CosineMath/BoatApp