{"id":15027382,"url":"https://github.com/aof-dev/mcinabox","last_synced_at":"2025-04-08T04:14:35.976Z","repository":{"id":37442340,"uuid":"237358779","full_name":"AOF-Dev/MCinaBox","owner":"AOF-Dev","description":"MCinaBox - A Minecraft: Java Edition Launcher for Android.  An Encapsulation of [CosineMath's BoatApp](https://github.com/AOF-Dev/BoatApp).","archived":false,"fork":false,"pushed_at":"2024-02-05T17:56:02.000Z","size":16215,"stargazers_count":1290,"open_issues_count":443,"forks_count":181,"subscribers_count":136,"default_branch":"dev","last_synced_at":"2025-04-08T04:14:29.266Z","etag":null,"topics":["android","boatapp","minecraft","minecraft-java-edition","minecraft-launcher"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AOF-Dev.png","metadata":{"files":{"readme":"docs/README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-31T04:19:07.000Z","updated_at":"2025-04-04T07:32:47.000Z","dependencies_parsed_at":"2024-12-21T09:05:47.967Z","dependency_job_id":"44f9798d-5569-4b61-a3d0-2e6e89ae7481","html_url":"https://github.com/AOF-Dev/MCinaBox","commit_stats":{"total_commits":515,"total_committers":24,"mean_commits":"21.458333333333332","dds":0.3864077669902912,"last_synced_commit":"bb13b45ecceddee5dd1313b520a29a931da820cf"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AOF-Dev%2FMCinaBox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AOF-Dev%2FMCinaBox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AOF-Dev%2FMCinaBox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AOF-Dev%2FMCinaBox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AOF-Dev","download_url":"https://codeload.github.com/AOF-Dev/MCinaBox/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247773719,"owners_count":20993639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","boatapp","minecraft","minecraft-java-edition","minecraft-launcher"],"created_at":"2024-09-24T20:06:20.540Z","updated_at":"2025-04-08T04:14:35.957Z","avatar_url":"https://github.com/AOF-Dev.png","language":"Java","readme":"# MCinaBox - A Minecraft Java Edition Launcher on Android\n[Now in English] [切换为简体中文](./README_zh-cn.md)\u003c/br\u003e\n\n\nIf you find problems when you run MCinaBox, you can check [Q\u0026A](./Q\u0026A.md) first.  \n\n## Instruction\n- MCinaBox is a Launcher of Minecraft Java Edition on Android. The core functionality is powered by [CosineMath](Https://github.com/CosineMath)'s [BoatApp](https://github.com/AOF-Dev/BoatApp) project.\n## Discord\n[Join](https://discord.gg/55GECvHuNd)  \n\n![Discord Banner 2](https://discord.com/api/guilds/808182854718062623/widget.png?style=banner2)\n## Contents\n- [Background](#Background)\n- [Change Log](#Change-Log)\n- [Build](#Build)\n- [Release](#Release)\n- [Usage](#Usage)\n- [Preview](#Preview)\n- [Known Issues](#Known-Issues)\n- [Maintainers](#Maintainers)\n- [License](#License)\n- [Contribution](#Contribution)\n- [Related](#Related)\n- [Q\u0026A](./Q\u0026A.md)\n\n## Background\n- `MCinaBox` is an open source project with the goal of building and developing a Minecraft Java Edition launcher that runs on an Android.\n- `Front End` provides User Management, Minecraft Version Management, Minecraft Game Controller, Minecraft Startup Parameter Generation, Configuration Backend, etc`Configuration` and `Management` functions to reduce the workload of complete launcher development.\n- `Backend` provides JRE runtime environment, Minecraft runtime environment, etc `core` functionality.\n- `Composition` MCinaBox consists of a front end and a back end.\n\n## Change Log\n- [English](./CHANGELOG.md)\n- [Chinese](./CHANGELOG_zh-cn.md)\n\n## Build\n\n### Environment\n- Android Studio\n- Android NDK\n- Git\n\n### Clone\n- ```git clone https://github.com/AOF-Dev/MCinaBox.git ```\n\n### Import\n- Import this project in your Android Studio.\n\n### Build\n- Build via Android Studio.\n\n## Release\n- You can also get released apk from [here](https://github.com/AOF-Dev/MCinaBox/releases).\n\n## Usage\n\n### Installation\n1. Download the latest APK and runtime to your Android phone.\n2. Then start APK and find `Launcher Settings` - `Import Runtime`. Click `Import` to import runtime.\n3. Alternatively, you can move the runtime to `/ sdcard / Android/ com.aof.mcinabox/files/MCinaBox/runtime` , and then repeat the previous step.\n\n### Start\n1. First, you need to create a user. Click `User` - `Add new User` to create a user.\n2. Second, you need to download Minecraft. Click `Game List` - `Install new version` to download Minecraft.\n3. Finally, you will start the game. Please select a Minecraft version on `home page` and start the game.\n\n### Forge API\n1. First, download Forge-Installer from Forge. It must be in `Universal` and `jar` format.\n2. Then put the downloaded jar file in `/sdcard/Android/com.aof.mcinabox/files/MCinaBox/forge`.\n3. Finally, open the MCinaBox and click `Launcher Settings` - `Forge Installer` to select and install the forge.\n\n### Customize\n1. MCinaBox offers a number of customization options, you can configure your launcher parameters in the `Game List` - `Global Game Settings`.\n2. MCinaBox provides the ability to customize your Minecraft working directory by configuring your Minecraft working directory in the `Game Directory`.\n3. MCinaBox provides the ability to customize your game controller by creating your virtual keyboard layout in the `Virtual Keyboard Settings`.\n\n### Online\n1. 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.\n2. 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.\n3. MCinaBox will not record your password in any way.\n\n## Preview\n\n## Known Issues\n\n### Launcher\n1. Microsoft Authentication API is not added, so you'll not be able to login with Microsoft Account.\n\n### Launch Minecraft\n1. Forge's loading animation will cause a crash\n2. It seems that there will be an X11 error when starting the Minecraft version below 1.6\n\n## Maintainers\n[@AOF-Dev](https://github.com/AOF-Dev)\n\n## License\nThe software is distributed under [GPL v3](https://www.gnu.org/licenses/gpl-3.0.html) with additional terms.\n### Additional terms under GPLv3 Section 7\n1. 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).]\n2. You must not remove the copyright declaration displayed in the software. [under GPLv3, 7(b).]\n\n## Contribution\nThis project exists thanks to all the people who contribute.\n\n### List of contributors:\n- [ALL](https://github.com/longjunyu2/MCinaBox/graphs/contributors)\n- `MCredbear`\n- All people who put forward issues.\n\n\nIf you want to submit a pull request, there're some requirements:\n* IDE: Android Studio\n* TargetSDK: 22\n* MimniumSDK: 21\n* DO NOT modify `gradle` files.\n\n## Related\n* [BoatApp (CosineMath,GPL 2.0)](https://github.com/AOF-Dev/BoatApp)\n* Gson (Google,Apache 2.0)\n* XZ for Java (Lasse Collin,Public Domain)\n* [JNDCrash (ivanarh,Apache-2.0)](https://github.com/ivanarh/jndcrash)\n* [FileDownloader (lingochamp,Apache-2.0)](https://github.com/lingochamp/FileDownloader)\n* [BubbleLayout (MasayukiSuda,All)](https://github.com/MasayukiSuda/BubbleLayout)\n* [AndroidRocker (kongqw,All)](https://github.com/kongqw/AndroidRocker)\n* [colorpicker (QuadFlask,All)](https://github.com/QuadFlask/colorpicker)\n- `Runtime Pack`\n* [GL4ES (ptitSeb,MIT)](https://github.com/ptitSeb/gl4es)\n* [OpenJDK-8 (CosineMath,GPL-2.0)](https://github.com/CosineMath/openjdk-jdk8u-aarch32-android)\n* [OpenJDK-8 (CosineMath,GPL-2.0)](https://github.com/AOF-Dev/openjdk-aarch64-jdk8u-androidport)\n* [lwjgl2.x (CosineMath,All)](https://github.com/CosineMath/lwjgl-boat)\n* [lwjgl3.x (CosineMath,All)](https://github.com/CosineMath/lwjgl3-boat)\n* [glfw (CosineMath,All)](https://github.com/CosineMath/glfw-boat)\n* [openal-soft (kcat,GPL-2.0)](https://github.com/kcat/openal-soft)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faof-dev%2Fmcinabox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faof-dev%2Fmcinabox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faof-dev%2Fmcinabox/lists"}