port-a-mod

Installation
SKILL.md

Port a mod faithfully

When porting an existing mod, the original is the spec. A port rarely fails for lack of code. It fails by drift:

  • values recalled from memory or a wiki;
  • mechanics borrowed from a later rewrite of the same mod;
  • quiet "improvements";
  • renderers that look roughly right;
  • checks that the original made on the client and the port forgot.

The method below carried a Thaumcraft 4.2.3.5 port from Minecraft 1.7.10 Forge to 1.20.1 Fabric:

  • 859 original classes became about 77,000 lines of port code;
  • 323 GameTests cover it, and scripted real-client scenarios check what tests can't reach;
  • the work spanned many sessions and two agent accounts.

The field note knowledge/games/minecraft/porting-thaumcraft-4-1-7-10-forge-to-minecraft-1-20-1-fabric.md has its gotchas. Minecraft-specific mappings are in references/minecraft-1-7-10-forge-to-1-20-fabric.md.

Installs
67
GitHub Stars
7.3K
First Seen
1 day ago