Repository navigation
Home
github-actions[bot] edited this page Nov 7, 2026
·
15 revisions
Legacy Connector runs unmodified legacy Forge mods (1.7.10, 1.12.2) on NeoForge 1.21.1 by translating them at load time. This is the technical documentation; the README has installation and the status overview, and the compatibility site lists how each mod works.
| Page | What |
|---|---|
| Architecture | Loader, shim, synthesized API, runtime; the legacy loader behaviour that is reproduced |
| Cache and Redistribution | What the translation cache contains, the provenance watermark, why translated jars are not loaded from mods/ |
| Bridges | Outdated dependencies replaced by modern mods, and every engine bridge with its state |
| Library candidates | Modern libraries that could replace hand-rolled code (Pehkui adopted for entity size) |
| World generation | Biomes, world types, structures, fluids and input |
| Mod dimensions | Dimensions registered by legacy mods, runtime dimensions, mixed 1.7.10/1.12.2 packs |
| Entities | Entity hosts, AI, attributes, renderers and models |
| Rendering | Textures, block models, tile entity renderers, item renderers |
| Create and Sable | Legacy blocks on Create contraptions and Aeronautics/Sable ships |
| Recipes | Changing legacy recipes with data packs, KubeJS and MineTweaker |
| Configuration | config/legacyconnector.properties |
| Performance | Measured memory, frame rate and startup cost |
| Troubleshooting | Join failures such as "length wider than 21-bit", measuring join payload sizes |
| Compatibility and status | Status per legacy version, known issues, reading the report |
| Development | Building, testing, project layout |
| Addon API | Writing addons for legacy mods |
| Legacy 1.20.1 estimate | Effort, approach options and risks for supporting 1.20.1 Forge (and Sinytra) mods |
| Version roadmap | Which versions come when, and why |
| Legacy 1.6.4 estimate | Effort and approach for a 1.6.4 layer on top of the 1.7.10 shim |
| Legacy 1.6.4 corpus | Measured API usage of 43 real 1.6.4 mods (numeric ids, old packets, renamed classes) |
| Legacy 1.4.7 estimate | Effort and approach for a 1.4.7 layer (obfuscated names, ModLoader, sprite sheets) over the 1.5.2/1.6.4 layers |
| Legacy 1.4.7 corpus | Measured API usage of 65 real 1.4.7 mods (notch names, sprite sheets, ModLoader, numeric ids) |
| Legacy 1.5.2 estimate | Effort and measured state of a 1.5.2 layer (a delta over the 1.6.4 one) |
| Legacy 1.5.2 corpus | Measured API usage of 67 real 1.5.2 mod files (EntityLiving split, string textures, zips) |