|
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
Contents
Background
Change Log
Build
Release
Usage
Preview
Known Issues
Maintainers
License
Contribution
Related
Q&A
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
English
Chinese
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)
|
