RshCCL

中文指南

⚠️ RshCCL is a compatibility bridge only.

Developers should always prefer using CUCoreLib directly.

Players should ask mod authors to migrate to CUCoreLib as their API dependency.

GitHub | NexusMods | CUCoreLib

A compatibility bridge that forwards legacy RshLib API calls to CUCoreLib (CCL).

Overview

RshCCL is a drop-in replacement for RshLib (in most cases). It keeps the Plugin. RegisterItem(string, RshItem) API surface so older mods work unchanged, while internally routing all registrations through CUCoreLib.

Key features:

RegisterItem – Converts RshItem → CustomItemInfo, then calls ItemRegistry. Register

onSpawn callback – Injected via CCL SpawnComponents + RshSpawnCallback MonoBehaviour

krokMpEnabled / togetherMpEnabled – Provided as backwards‑compatible fields

Conflict avoidance – Removes self from Chainloader. PluginInfos so mods like NewClothing use their native CCL path

Console autofill – Patches spawn command to include every CCL‑registered item

Recipe‑list crash guard – Harmony finalizer catches NRE in RefreshRecipeList

Installation

Install BepInEx 5.x for Casualties Unknown.

Install CUCoreLib ≥ 1. 0. 1 — place CUCoreLib.dll in BepInEx/plugins/.

Download the latest RshCCL.dll from Releases.

Place RshCCL.dll in BepInEx/plugins/.

Remove the old RshLib.dll if it exists.

⚠️ Important: RshCCL uses the same BepInEx GUID as old RshLib (com.rushellxyz.rshlib).

Only one RshLib.dll should be present in your plugins folder.

Notes

RshLib itself never provided path or resource‑loading APIs. Older mods that hard‑code paths like "BepInEx/plugins/MyMod/image.png" must update their own resource‑loading code.

Consider migrating to CCL's AssetLoader which resolves paths relative to the calling DLL.

For those, install CUModFixer as well.

Project Structure

├── Plugin.cs # Entry point: compatibility API + conflict avoidance

├── RshItem.cs # Legacy RshItem type (backwards compat)

├── RshItemAdapter.cs # RshItem → CustomItemInfo converter + onSpawn callback

├── Patches.cs # ConsoleScript, GlobalDark, RefreshRecipeList guard

├── RshLib.csproj # Project file (depends on CUCoreLib)

├── CHANGELOG.md # English changelog

├── CHANGELOG_ZH.md # Chinese changelog

├── README.md

└── README_ZH.md