Skip to content
This repository has been archived by the owner on Nov 26, 2022. It is now read-only.

Latest commit

 

History

History
106 lines (60 loc) · 7.23 KB

README.md

File metadata and controls

106 lines (60 loc) · 7.23 KB

Inner Core Mod Toolchain

FAQ Windows Linux

Inner Core Mod Toolchain for Horizon is a toolchain that allows you to efficiently develop and build modifications for mobile Minecraft: Bedrock Edition directly from your PC.

Requirements

To work correctly, this toolchain requires:

  • Python 3.7 or higher
  • node.js 10.15.1 or higher (for TypeScript modding), tsc must also be installed (to do this, run npm install -g tsc)
  • Android NDK version r16b (for C++ modding), otherwise it can be installed by toolchain when needed
  • Java Development Kit 1.8 (for Java modding)

It is obligatory to install only first component, the rest can be installed when necessary.

Inner Core/Horizon Mods Development | Setting up the Environment

Installation

You can simply download repository, however we recommend using install script. It will help you install all necessary components for more efficient use. Open a terminal in the folder that will be used to install toolchain and enter command following the information from interactive console.

python3 -c "from urllib import request; exec(request.urlopen('https://raw.githubusercontent.com/zheka2304/innercore-mod-toolchain/master/toolchain-setup.py').read().decode('utf-8'))"

Alternatively, save toolchain-setup.py for more installation and import options. Run the following command for more details.

python3 toolchain-setup.py --help

Modding with Visual Studio Code

For the best user experience, it is recommended to install Visual Studio Code. This environment is great for modding and can be easily improved with extensions and toolchain itself. This repository already contains all necessary files for easy interaction with this editor.

It is also recommended to install the following extensions:

  • ESLint (Microsoft), TSLint now deprecated
  • C/C++ Extension Pack (Microsoft)
  • Extension Pack for Java (Microsoft)

Just clone or download this repository and open toolchain.code-workspace, it contains everything you need to start your journey! Use Ctrl+Shift+B to access all available options.

Modding with IntelliJ IDEA

Most of the features are also implemented to work with IntelliJ IDEA. Use build menu to access the available scripts, or use console for more information.

Modding with a third party editor

Inner Core Mod Toolchain does not require an installed editor, much less an environment, to develop mods. You can run build and configuration scripts directly from console or by opening files located in toolchain/toolchain folder. We recommend checking out the toolchain/toolchain/python/task.py script for details.

Multiproject? I really want it?

Now toolchain works with projects as separate components. We've just made things easier for you by separating the settings of toolchain from most build.

Use the imports below to simply copy your make.json project into updated toolchain, and if you don't like something, you can always revert to old one. Shall we try?

First build

To start the first build, use Build task or run ./build-all.bat or ./build-all.sh from console. You will be prompted to select a project, install additional components, and connect to the device. Most of these operations will no longer be required.

Configuration files

There are three types of configurations for managing projects, builds, and the toolchain itself. They describe complete process of building your project.

  • make.json - to control the assembly of projects
  • toolchain.json - toolchain configuration and basic properties for make.json
  • template.json - template for subsequent generation make.json

A detailed description of each of the files can be found in article.

Importing, creating and removing projects

For each of the operations, tasks Import Project, New Project and Remove Project are provided, respectively, as well as commands ./import-project.bat, ./import-project.sh, ./new- project.bat, ./new-project.sh, ./remove-project.bat and ./remove-project.sh. All operations are accompanied by interactions in console, which means that a detailed description of each of them is not required.

Selection between your projects

Use the Select Project task or ./select-project.bat or ./select-project.sh command to open selection menu. In case you can't find your project, check projectLocations property in your toolchain.json or import the project using toolchain.

In addition, for Visual Studio Code tasks Select Project by Active File, Build by Active File, e.g. are provided. They are hidden from Ctrl+P > Tasks: Run Task menu by default, but are available from the build menu Ctrl+Shift+B and can be displayed by changing .vscode/tasks.json manually.

Distribution update

Run the Check for Updates task or ./update-toolchain.bat or ./update-toolchain.sh command. Local components and toolchain itself will be rechecked for updates. When updating, only the folder of toolchain itself is affected, only configuration files and scripts are changed. The rest of files cannot be deleted under any circumstances, or they will be moved to a copy with .bak suffix.

Component management

Components can be installed using Integrity Components or commands ./component-integrity.bat or ./component-integrity.sh. You can install or update them at any time using the same command, there is no uninstallation for components.

Publishing project

Once development is complete, the next step is to publish to Mod Browser. Execute the Assemble Mod for Release task or ./assemble-release.bat or ./assemble-release.sh command. An archive <folder_name>.icmod will be created at the root of folder. It is already completely ready for publication to site. Read article for details.

Documentation and futher steps

All documentation is available at https://docs.mineprogramming.org. Here you can find information about available APIs, learn the basics of modding and get acquainted with existing projects.

Slightly outdated, but no less useful information can be found at https://wiki.mineprogramming.org.

Contribution

Yes, and yes again! Fork repository to yourself, we will all be happy with the new functionality. Development is done on develop branch, any pull requests outside this branch will be rejected.