R2API Skins

v1.4.10·Updated 2026-10-11

R2API Submodule for adding custom Skins and Skin-related utilities to the game

About this mod Author’s original text

R2API.Skins - Adding new Skins, Skin-Specific IDRS and VFX and Skill-Specific parts

About

R2API.Skins is a submodule for R2API that takes the Skin related methods and utilities from `R2API.Loadout` and implements them in this new submodule

Alongside the old skin creation methods from R2API.Loadout, R2API.Skins also contains utilities for improving the skin experience, such as having Skin-Specific ItemDisplayRuleSets, custom VFX for skins, providing a system for overriding Light colors and having Skill-Specific parts

Changelog

1.4.7

  • Fix IDRS issues when adding skin-specific overrides under certain conditions.
  • Fix IDRS issues related to async skin application by refreshing item displays when a skin with a custom IDRS is applied.

1.4.6

  • Fix IDRS issues related to async skin application by refreshing item displays when a skin with a custom IDRS is applied.

1.4.5

  • Fix custom IDRS not working since memop update.

1.4.4

  • Async SetLobbySkinToBodySkin to reduce load time.
  • Add SkinCustomGameobjectComponent component.

1.4.3

  • Add missing nullchecks for SkinSkillVariants.
  • Add lowPriority boolean field to SkinSkillVariantsDef.

1.4.2

  • Update for DLC 3 release 3.

1.4.1

  • Update for DLC 3 release 2.

1.4.0

  • Update for DLC 3 release.

1.3.1

  • Fix missing Patcher / Interop dlls

1.3.0

  • Added SkinSkillVariants feature for adding skill-specific skin parts replacements.

1.2.2

  • Removed the SkinLightReplacement system, as it was not used by a single mod in the entire, alongside the fact that the Memory Optimization patch made its concept obsolete.

1.2.1

  • Moved to SkinDefParams creation
  • SkinDefInfo is now obsolete. Use SkinDefParamsInfo instead.
  • Added precautions to automatically add and populate the ModelSkinsController on displayPrefabs, when necessary. This should be done by the devs.
  • Added validity checks for name and nameTokens

1.2.0

  • Added the ability to replace the color LightInfos for a skin

1.1.2

  • Initial fixes for SOTS DLC2 Release.

1.1.1

  • Added the ability to override DisplayGroupRule per item for a skin. Which allows to add skin-specific item display without requiring to create IDRS with all items. See SkinIDRS.AddGroupOverride().

1.1.0

  • Added the SkinVFX class for adding skin-specific effect replacements.

1.0.0

  • Initial Release

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

RiskofThunder-HookGenPatcherbbepis-BepInExPackRiskofThunder-R2API_Core

File & checksum

Filename
R2API_Skins-1.4.10.zip
File size
46.5 KiB