R2API Director

版本 v3.1.1·更新於 2026-10-09

API for easily modifiying the Director (RoR2 monster / interactable spawner) behaviour, cloning Spawn Cards and enabling/disabling Combat Directors

模組介紹 作者原文

R2API.Director - Simplified addition of Enemies, Interactables and more to the Director Systems.

About

R2API.Director is a submodule assembly for R2API that allows mod creators to add new Entries to the Director, which allows things such as Interactables, Enemies and more to spawn in runs.

Use Cases / Features

R2API.Director is used for adding new Enemies and Interactables to the Director's SpawnCard pools, the main method of using this is with the events provided by the API, these events are:

  • StageSettingsActions (Modify the the stage settings such as the stage's monster and interactable credits.)
  • MonsterActions (Modify the stage's Monsters's DCCSPool)
  • InteractableActions (Modify the stage's Interactable's DCCSPool)

Alongside this, R2API.Director also comes bundled with DirectorAPIHelpers, which contains helper methods which greatly simplify interacting with the Events described above.

Additionaly you can clone existing spawn cards and set new values for cloned spawn cards using CharacterSpawnCardClone, InteractableSpawnCardClone and MultiCharacterSpawnCardClone.

Also provides an event to easily enable/disable Combat Directors. Provides an extension method IsStageCombatDirector to check is Combat Director part of stage Combat Directors

Related Pages

Changelog

3.1.0

  • Added enabling/disabling Combat Directors event.

3.0.1

  • Fix spawn card clones not being able to be applied more than once for the dccspool in a single game session.

3.0.0

  • Added SpawnCardCloningAPI for cloning existing spawn cards.

'2.3.9'

  • Fix AddressableDCCSPool not adding "Included If Conditions Met" entries with 0 required expansions to the target DCCS pool.

'2.3.8'

  • Backward compat fix for mixEnemyMonsterCards not being assigned as early as before due to a timing change from 1.4.0 Game Update.

'2.3.7'

  • Support for Alloyed Collective DLC3.
  • Added missing spawn cards for DLC2.

'2.3.6'

  • Both AddressableDirectorCardCategorySelection and AddressableDCCSPool now have more intricate validation during upgrading process.
  • This means that they should catch issues such as invalid spawn cards, invalid addresses and more.

'2.3.5'

  • Added MixEnemiesDccsActions action that would allow interaction with MixEnemy artifact DCCS replacement.

'2.3.4'

  • Fixes.

'2.3.3'

  • Fixed custom monsters and interactables being added to stage pool multiple times as a result of SoTS Phase 2 changes.

'2.3.2'

  • Fixed RemoveExistingMonsterFromStage, which by default removed the given monster from family DCCSs, potentially affecting other scenes unintentionally since those are shared between stages.

'2.3.1'

  • Fixed the AddressableDCCSPool's ConditionalPool class not upgrading properly when it was using the new FamilyDCCSOption

'2.3.0'

  • Added an "AddressReferencedFamilyDirectorCardCategorySelection" class, which is used to reference the FamilyDCCS from the base game
  • AddressableDCCSPool's "PoolEntry" can now reference a FamilyDCCS, this FamilyDCCS takes precedence over the AddressableDirectorCardCategorySelection field.

'2.2.1'

  • Add StageSerde struct, which acts as a workaround for Unity's inability to correctly serialize the Stage enum now that it is 64 bits long.

'2.2.0'

  • Add SOTS stages and support Storm Stuff interactable category.

'2.1.3'

  • Initial fixes for SOTS DLC2 Release.

'2.1.2'

  • Add support for 'lakes'/'Verdant Falls' from Devotion update.

'2.1.1'

  • Fix AddNewMonster / RemoveExistingMonster helper methods not properly handling arena stage.

'2.1.0'

  • Added Dependency for the Addressables Submodule
  • Added AddressableDCCSPool and AddressableDirectorCardCategorySelection, both intended for usage in the Unity Editor.

'2.0.0'

  • Fixed issue where DirectorCardHolder's custom category selection weights where integers instead of floats.

'1.1.2'

  • Make the API safer.

'1.1.1'

  • Fix issue where the `Stage ParseToInternalStageName(string) and string ToInternalStageName(Stage stage)` would return invalid values for The Planetarium and Void Locus respectively.

'1.1.0'

安裝與使用 安裝:BepInEx 外掛

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

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

前置依賴

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

RiskofThunder-HookGenPatcherbbepis-BepInExPackRiskofThunder-R2API_CoreRiskofThunder-R2API_Addressables

檔案與校驗

檔案名稱
R2API_Director-3.1.1.zip
檔案大小
54.2 KiB