菜单
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.
用 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.
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.
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 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 | mapping-work |
| description | 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. |
Handles Minecraft's various naming systems and the transitions between them.
| System | Used By | Format | Example |
|---|---|---|---|
| Intermediary | Fabric (pre-26.1) | class_XXXX, method_XXXX, field_XXXX | class_1297 = Entity |
| Mojang Official | All loaders (26.1+), NeoForge (1.17+) | Human-readable | Entity, getBlockState |
| SRG | Forge (pre-1.20) | func_XXXXX, field_XXXXX | func_70070_b = getBlockState |
| Yarn | Fabric community (discontinued 26.1) | Human-readable | Entity, getBlockState |
IntermediaryToMojangMapper: src/main/java/com/retromod/mapping/IntermediaryToMojangMapper.java
registerWithTransformer() bulk-registers all mappings as redirectsMappingComposer: src/main/java/com/retromod/mapping/MappingComposer.java
Bundled mappings: src/main/resources/mappings/intermediary-to-mojang.tiny
In IntermediaryToMojangMapper.java, add to the loadBuiltInMappings() method:
classMap.put("class_XXXX", "net/minecraft/path/ClassName");
// Key format: "ownerClass.methodName.descriptor"
methodMap.put("class_XXXX.method_YYYY.(Lnet/minecraft/class_ZZZZ;)V",
new MethodMapping("class_XXXX", "newMethodName", "(Lnet/minecraft/path/ArgType;)V"));
fieldMap.put("class_XXXX.field_YYYY", "newFieldName");
Use MappingComposer to generate a full intermediary→official mapping file:
# Download source files
# 1. Fabric intermediary: https://github.com/FabricMC/intermediary/blob/master/mappings/<version>.tiny
# 2. Mojang official: https://piston-data.mojang.com/v1/packages/.../client.txt
# Compose them
java -cp retromod.jar com.retromod.mapping.MappingComposer \
intermediary.tiny mojang-client.txt output.tiny
intermediary-to-mojang.tiny)isDeobfuscatedVersion() to verify 26.1+ detectionremapDescriptor() for descriptor mismatchesretromod analyze <mod.jar> to see what names the mod uses