The main branch of this repository contains the neccessary scripts for remapping Fabric API sources to Mojang mappings. Other branches include:
fabric/<version>
- upstream tracking branches, used to keep track of our reference point for mapped codemojmap/<version>
- remapped Fabric API sources
Please note that to avoid possible merge conflicts, no build system changes have been made to mojmap mapped sources.
Only java
and accesstransformer
source files have been modified.
This repository acts as an upstream remote for the ForgifiedFabricAPI, allowing us to easily update it via git rebasing.
Please make sure the kotlin
command-line compiler is installed on
your system, as it is necessary to run our setup scripts.
After cloning the repository, before importing the gradle project, run kotlinc -script scripts/setup.main.kts setup
.
This will initialize a git submodule for upstream Fabric API, which serves as an input for our remapper.
To sync the mapped sources with upstream, run kotlinc -script scripts/setup.main.kts sync
, which will automatically run
the necessary gradle tasks and perform a few git operations. As updating is done on a per-commit basis, this may take
several minutes to complete based on how far behind we are.
If a mapped branch doesn't exist yet, an initial mapping commit will be created (using your configured committer
information). Once remapping is complete, all changes are pushed from the submodule to the root repository, from where
they can be pushed to origin
.
- Architectury Loom for allowing us to run a modding environment with both Yarn and Mojang mappings available
- Cadix Dev Team for their awesome Java source remapping tools - Mercury and MercuryMixin