القائمة
Create a new version shim to add support for transforming mods between two Minecraft versions. Use when adding support for a new MC version or filling gaps in the shim chain.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Create a polyfill provider that re-implements a removed API so old mods still work. Use when mods crash with ClassNotFoundException or NoSuchMethodError for completely removed classes.
Debug a Minecraft crash caused by a mod that Retromod transformed. Use when a mod crashes after transformation and you need to find and fix the root cause.
Work with Minecraft name mappings: intermediary, Mojang official, SRG, and Yarn. Use when adding new mappings to IntermediaryToMojangMapper, generating mapping files with MappingComposer, or debugging name mismatches.
Work on mod loader compatibility for Fabric, NeoForge, Forge runtime integration, version constraint relaxation, and mod metadata patching. Use when fixing mod loading issues, version rejection errors, or adding support for a new loader version.
Search, download, and work with mods from Modrinth. Use when downloading test mods, checking mod compatibility, or finding mods for a specific MC version and loader.
Test that Retromod correctly transforms mods for a target Minecraft version. Use when verifying transforms work, testing new shims, or debugging mod compatibility.
| name | add-version-shim |
| description | Create a new version shim to add support for transforming mods between two Minecraft versions. Use when adding support for a new MC version or filling gaps in the shim chain. |
| argument-hint | source-version target-version loader (e.g. 1.21.11 26.1 fabric) |
Creates a new VersionShim implementation that maps API changes between two Minecraft versions for a specific mod loader.
Identify the version gap. Check src/main/java/com/retromod/shim/ for existing shims. Find what source→target versions are missing. Use ShimRegistry BFS to verify no chain already exists.
Research API changes. Compare the two MC versions to find:
net/minecraft/class_1234 → net/minecraft/world/entity/Entity)method_5678 → getBlockState)field_9012 → STONE)Create the shim file at src/main/java/com/retromod/shim/<loader>/:
<Loader>_<source>_to_<target>.java
Use underscores for dots in versions (e.g. Fabric_1_21_10_to_26_1.java).
Implement VersionShim interface:
public class <ClassName> implements VersionShim {
@Override public String getShimName() { return "<Loader> <source> → <target>"; }
@Override public String getSourceVersion() { return "<source>"; }
@Override public String getTargetVersion() { return "<target>"; }
@Override public String getModLoaderType() { return "<loader>"; } // "fabric", "neoforge", "forge", or "common"
@Override
public void registerRedirects(RetromodTransformer transformer) {
// Class redirects
transformer.registerClassRedirect("old/class/Name", "new/class/Name");
// Method redirects
transformer.registerMethodRedirect(
"owner/Class", "oldMethod", "(Larg;)Lreturn;",
"owner/Class", "newMethod", "(Larg;)Lreturn;"
);
// Field redirects
transformer.registerFieldRedirect("owner/Class", "oldField", "owner/Class", "newField");
}
}
Register in ServiceLoader. Add the full class name to:
src/main/resources/META-INF/services/com.retromod.core.VersionShim
Add version aliases. If the new version has sub-versions (e.g. 26.1.0, 26.1.1), add aliases in ShimRegistry.java:
VERSION_ALIASES.put("26.1.0", "26.1");
Add tests. Create test in src/test/java/com/retromod/ verifying:
src/main/java/com/retromod/shim/<loader>/src/main/java/com/retromod/shim/ShimRegistry.javasrc/main/resources/META-INF/services/com.retromod.core.VersionShimsrc/main/java/com/retromod/core/VersionShim.javasrc/test/java/com/retromod/RetromodTest.javaclass_XXXX, method_XXXX, field_XXXXEntity, getBlockState)func_XXXXX, field_XXXXX) up to 1.20IntermediaryToMojangMapper for Fabric intermediary→Mojang mappings