Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
SkinCloneCompatibility
Compatibility fixes for audited legacy skin model initialization and R2API lobby base-color inheritance. Supported builds and limits are listed in the README.
By Riiin
| Last updated | 13 hours ago |
| Total downloads | 52 |
| Total rating | 0 |
| Categories | Mods Skins Tweaks AI Generated |
| Dependency string | Riiin-SkinCloneCompatibility-0.2.1 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
bbepis-BepInExPack
Unified BepInEx all-in-one modding pack - plugin framework, detour library
Preferred version: 5.4.2122
mwmw-DynamicSkinsFix
Aims to fix skins using dynamic bones that were broken after the optimisation update, as well as some other standard skinbuilder skins.
Preferred version: 1.0.9
RiskofThunder-R2API_Skins
R2API Submodule for adding custom Skins and Skin-related utilities to the game
Preferred version: 1.4.11README
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.
| Skin package | Audited package version | Character |
|---|---|---|
| 12GaugeAwayFromFace-Femme_Bandit | 1.2.0 | Bandit |
| 12GaugeAwayFromFace-Risque_Femme_Bandit | 1.0.0 | Bandit |
| 12GaugeAwayFromFace-Risque_Fem_Captain_Skin | 1.0.1 | Captain |
| 12GaugeAwayFromFace-Risque_Fem_Commando_Skin | 1.3.1* | Commando |
| 12GaugeAwayFromFace-Risque_Fem_Mercenary_Skin | 1.1.2* | Mercenary |
| 12GaugeAwayFromFace-Risque_Huntress | 1.1.0 | Huntress |
| 12GaugeAwayFromFace-Risque_Railgunner_Skin | 1.0.0 | Railgunner |
| 12GaugeAwayFromFace-ThiccArtificerSkin | 1.1.1 | Artificer |
| Anzu-NSFW_Huntress | 1.3.1 | Huntress |
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.
| Character | Skins with recorded inheritance corrections |
|---|---|
| Captain | RisqueFemCaptainMonsoonSkinDefinition |
| Commando | FemCommandoMilSkinDefinition_M6D, FemCommandoMonsoonSkinDefinition_M6D, FemmandoHornet |
| Acrid | FemAcridWhite, FemAcridWhiteNude |
| Engineer | FemgineerEOD |
| Huntress | MasteryGrayNSFW, FemHuntressWinter |
| Loader | TightLoaderClassic |
| Mercenary | Oni (female) Red, RisqueFemMercSkinDef, RisqueFemMercBlankSkinDef, FemMercOni Red |
| REX | FemREXSmoothie |
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.2122and the original skin mods. - DynamicSkinsFix
1.0.9. - R2API.Skins
1.4.11and 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 生成，我只负责了验收。
