Skin Clone Compatibility

Compatibility fixes for specific legacy Risk of Rain 2 skins: missing models caused by unrecognized lobby skin clones, and incorrect colors caused by lost base-skin inheritance.

This plugin does not include skin assets or replace the original skin DLLs. It is not a fix for every invisible model or recoloring issue.

Model compatibility targets

The model fix recognizes the following audited DLL builds. Package versions alone do not guarantee a match: files must also match the supported SHA256 and callback structure.

The audited Commando and Mercenary DLLs were local variants that differed from the corresponding cached files. Compatibility with a fresh public download of those versions has not been verified. A different file hash is skipped, even when its displayed version matches.

Exact hashes are listed in supported-model-targets.json. The model module patches 16 callbacks in these 9 assemblies so matching lobby clones can execute the skin's original bone initialization. Other skin plugins are not automatically added to this list.

Color inheritance fix

R2API.Skins' lobby conversion can replace a custom skin's intended base skin with the character's default skin. Skins that inherit an alternate skin's materials may consequently display the default palette.

This module preserves the intended base-skin mapping when the corresponding display skin can be verified. It does not force a color or replace textures. Unlike the model module, it is not restricted to the nine skin packages above; it applies to skins passing through this specific conversion path.

The following inheritance corrections were recorded in the tested setup. Names below are internal skin identifiers, not necessarily their translated menu names.

FemmandoHornet's coloring was confirmed in the lobby: the runtime base changed from skinCommandoDefault to skinCommandoAlt, the body used matCommandoDualiesAlt, and the player confirmed the restored appearance. Other entries above have logged mapping corrections, not individual visual verification.

Requirements and limits

• Tested game: Risk of Rain 2 1.5.0#1224.
• BepInExPack 5.4.2122 and the original skin mods.
• DynamicSkinsFix 1.0.9.
• R2API.Skins 1.4.11 and its dependencies. The color module requires the audited R2API.Skins DLL SHA256: 9A67B1D407604A5AA3D710DEA3DF248152B62E7D5CA029F80127F96937F47C08.

Unknown DLL builds or unexpected method structures are skipped with a log message. This includes newer dependency builds that have not been audited. Keep the original skin files; this package contains only the compatibility plugin.

Stage transitions, respawns, multiplayer, and every individual skin variant have not been fully verified. This does not repair missing textures, damaged asset bundles, unrelated material overrides, or every possible bone/mesh incompatibility.

Installation

Install this package with your mod manager, or copy BepInEx/plugins/SkinCloneCompatibility/ into the corresponding folder of your mod profile. The manager installation route follows the BepInEx package layout; a local manager import has not been separately tested.

When upgrading, remove the old compatibility DLL first. Do not keep multiple copies of SkinCloneCompatibility or combine it with the earlier replacement Commando DLL. Original skin mods remain installed. Restart the game after installing or removing this plugin.

Logs

• PATCH: the targeted runtime patch was installed.
• CLONE MATCH: a lobby clone was recognized by a model callback.
• BASE INHERIT: an intended base-skin mapping was restored.
• SKIP / BASE MAP SKIP: the corresponding patch or mapping was not applied.

These messages establish what the code did; they do not by themselves establish a visual test pass.

Attribution

This mod was generated by GPT-6.1 Sol. I was responsible only for acceptance testing.

中文说明

本补丁覆盖上表列出的 9 个皮肤插件特定 DLL 的模型兼容问题，以及 R2API 大厅转换导致的基础配色继承错误。模型修复按文件哈希识别；指挥官和佣兵两项目前仅核查过本地变体，同版本的其他文件可能被跳过。

配色表列的是日志确认发生继承修正的皮肤，其中指挥官 FemmandoHornet 已由玩家确认外观恢复。其他配色条目、关卡内、复活和联机效果尚未逐项验证。它不保证修复所有皮肤问题。

此 Mod 由 GPT-6.1 Sol 生成，我只负责了验收。

0.2.1

• Preserve the intended base skin during the audited R2API.Skins lobby conversion.
• Correct the runtime method-name check for MonoMod's dynamic method copy.
• Retain the legacy skin clone/bone compatibility module.
• Document audited model builds, logged color-inheritance corrections, and verification limits.

0.2.0

• Initial color inheritance candidate. Its runtime name guard rejected the color patch; superseded by 0.2.1.

0.1.0

• Initial audited legacy skin clone/bone compatibility module.