Skip to content
This repository has been archived by the owner on Jun 1, 2023. It is now read-only.

Latest commit

 

History

History
17 lines (11 loc) · 1.87 KB

README.md

File metadata and controls

17 lines (11 loc) · 1.87 KB

Forgework API

A best-effort reimplementation of the Minecraft Forge API.

Contribution

If you know Java and would like to contribute, check out our contribution guide, and join our Discord server.

Technical details

Forgework API aims to re-implement the entirety of Minecraft Forge as a set of small and modular Fabric mods. This is in order to run Minecraft Forge mods patched using Patchwork Patcher on Fabric.

However, Forgework aims not only to simply run Forge mods on Fabric but additionally aims to maintain a superior level of code quality to Forge. We feel the Fabric toolchain is superior to Forge on a technical level, but lacks both the sheer quantity of hooks and features as well as existing mod support. Thus, Forgework seeks to provide both the benefits of Fabric and the benefits of Forge.

This modular organization is modeled after the organization of Fabric API. This may seem like a confusing decision because Minecraft Forge itself is monolithic, but there are a few good reasons:

  1. Porting. Since each module is a separate compilation unit, it is possible to port individual modules at a time to newer Minecraft versions. Less critical modules can also be disabled until more critical modules have been ported first.
  2. Organization. Modules keep related code together and unrelated code separate. This means that Mixins are located in the same place with code using them. Keeping related code close together makes it easier to reason about the code, and analyze each module in isolation.
  3. It works. The modular organization has already been used by Fabric API to great success.