메뉴
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 직업 분류 기준
| 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 mappingsCreate 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.