Fixes several bugs in IndustrialCraft2 using binary patches.
Note that you may NOT distribute any decompiled code generated by this tool. For more information, see IC2's license.
You can find lists of patches for each supported IC2 Version here.
- IC2-2.8.221 and above
- IC2-2.8.164
- Clone the repository.
- Run the
Setup IC2 Sourcegradle task found inic2 patcher.
This will set up bothIC2-BaseandIC2-Patchedprojects, which contain clean and patched code respectively.
Note that while this code will compile, it's highly unstable and might not work on your OS / IDE.
To apply changes pulled from the GitHub, simply execute Setup IC2 Source task again.
Important Note: If the latest pull contains changes to patches for the Base project,
before running the Setup IC2 Source task, you need to execute Setup Source of the Base project itself.
Important, changes to the IC2 source code are not automatically saved!
Both Base and Patched project have Generate Patches tasks,
that are used to generate patches based on the current changes.
Those patches will later be used for the IC2 Source setup and generation of the binary patches.
Base project is meant to be pure "decompilation" of the IC2. The code should be as close to the original as possible.
Acceptable changes: Code Style changes and fixes of errors from the Decompilation process.
Patched Project should only contain the actual fixes, that are going to be applied to the IC2 on runtime. For cosmetic changes to the code base, edit the Base project instead.
Acceptable changes: Patches meant to be applied on runtime.
To start working on a new version of the IC2,
you need to create folders for the patches in both Base and Patched projects.
The folder name is required to contain the version range, for which those patches are applicable.
Example:
[2.8.164]-> Those patches support only version 2.8.164[2.8.221,+]-> Those patches support version 2.8.221 and above.[2.8.170,2.8.180]-> Those patches support versions from 2.8.170 to 2.8.180.
It is recommended to copy the patches from the closets, already supported version and start from there. Do note that most likely those patches will fail to apply correctly and will need to be fixed / reimplemented.
IC2 Patcher is created to support multiple versions of the IC2. It is recommended to work on the patch on the oldest supported version of the IC2, that the patch is applicable to, and then port the changes to the newer versions — if applicable.
- Run the
Generate Binary Patchestask of thePatchedproject for each version you have done changes to. - Run
Release Jarof thePatcherproject to build the mod.
The resulting jar will be located in thebuild/libsfolder.
Remember that the jar built by thejartask will NOT work outside the dev environment.
All code is licensed under The Unlicense, except for mods.su5ed.ic2patcher.asm.BinPatchManager, which is a modified version
of MinecraftForge's ClassPatchManager class, and is licensed under the GNU Lesser General Public License version 2.1