R2API Stages

版本 v1.0.3·更新於 2025-06-05

API for Stage creation

模組介紹 作者原文

R2API.Stages - Easy Registration of Stages and Stage Variants + Stage Utils

About

R2API.Stages is a submodule for R2API that adds a single unified method to register both new stages and variants of stages.

R2API.Stages also hosts an abundant amount of utils to assist in stage making.

Use Cases / Features

You can use StageRegistration.RegisterSceneDefToNormalProgression quickly register a SceneDef to its proper place in the normal progression. This method can add both variants and new custom stages. To add a variant, make sure the baseSceneNameOverride in your SceneDef is set to the same string as the stage you want to make a variant of. It also has extra parameters to control if the stage is pre-loop and post-loop.

The StageRegistration class also hosts stageVariantDictionary, which is a readonly dictionary to grab all the variants of a stage by inputting the baseSceneNameOverride. For example, if you input "golemplains" you will get a list of SceneDefs with atleast golemplains and golemplains2.

Related Pages

Changelog

'1.0.3'

  • Support for previewTextureReference in MakeBazaarSeerMaterial

'1.0.2'

  • Stripped the Variant Rebalancer and Blacklister. This was to account for the inconsistencies in the stage weights in DLC2 and give more control to the user.
  • You can now register stages into post-loop scene collections.
  • New way to register scenes to the normal stage progression: RegisterSceneDefToNormalProgression. Supports extra parameters such as weight, preLoop, postLoop.
  • Marked RegisterSceneDefToLoop as obsolete.

'1.0.1'

  • Fix r2api content management DLL being shipped in that package

'1.0.0'

  • Initial Release

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

bbepis-BepInExPackRiskofThunder-HookGenPatcherRiskofThunder-R2API_Core

檔案與校驗

檔案名稱
R2API_Stages-1.0.3.zip
檔案大小
15.8 KiB