R2API Addressables

版本 v1.1.3·更新於 2025-12-22

R2API Submodule for implementing Addressables functionality

模組介紹 作者原文

R2API.Addressables - Addressable related utility for modding

About

R2API.Addressables is a submodule for R2API that implements systems for working with the AddressablesAPI from Unity.

Currently it adds the AddressReferencedAsset system, which allows you on the Editor or on Code to easily refer to either an explicit Asset, or an Address to said asset.

Changelog

'1.1.3'

  • Added the `NoCataloLoad` attribute, which when implemented on a field and in conjunction with RoR2EditorKit, forces an AddressReferencedAsset to never be loaded from the catalog.
  • Added the `AddressableComponentRequirement` attribute, when used with an AssetReferenceGameObject or an AddressReferencedPrefab, it can restrict the lookup search in RoR2EditorKit to only include Game objects that have the specified component

'1.1.2'

  • Reimplemented version '1.1.0' with fixes, changes and improvements.

'1.1.1'

  • Revert 1.1.0

'1.1.0'

  • Implemented the ability to restrict a load to not use the ingame catalogs, forcing an address to be used instead.
  • implemented IDisposeable an AddressReferencedAsset, which releases an internal handle for the addressable asset.
  • Added the ability to bypass the secure loading by calling ResolveAsset().
  • Replaced most of the Task returning methods with IEnumerator coroutines.

'1.0.4'

  • Added Safeguards for the loading process to avoid loading assets with addresses that are invalid or malformed.

'1.0.3'

  • Fixed a typo on `AddressReferencedAsset(UnityEngine.Object) constructor which would incorrectly set UseDirectReference to false`
  • Fixed issue where `AddressReferencedEquipmentDef` wasnt marked as "Serializable"

'1.0.2'

  • Added utility property to check wether an `AddressReferencedAsset` is "Invalid". Invalid in this instance means that no direct reference to an asset exists, and the string address is null, empty or whitespace.
  • Addedd a utility property to check if an `AddressReferencedAsset` has a direct reference to an Asset.

'1.0.1'

  • Added missing casting operators and constructors for the bundled in, derived classes of `AddressReferencedAsset`

'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_Addressables-1.1.3.zip
檔案大小
27.4 KiB