Updating Your Mods for Seekers of the Storm
report on discord here if you find anything else, please and thanks
General
Before Updating Libraries
there is a namespace that begins Assets.RoR2
if you have a class named Assets
(all henry survivors will), code attempting to call this class will be intercepted by that namespace. Before updating. Rename Assets
class to just Asset
or ModAssets
or something
Update Your Projects
- in visual studio, right click your csproj > properties > General > set Target Framework to 2.1 if it isn't already
- I'm copypasting this to update my nuget libraries
<PackageReference Include="BepInEx.Core" Version="5.*" /> <PackageReference Include="RiskOfRain2.GameLibs" Version="1.3.2-r.1" /> <PackageReference Include="UnityEngine.Modules" Version="2021.3.33" /> <PackageReference Include="MMHOOK.RoR2" Version="2024.9.5"> <NoWarn>NU1701</NoWarn> </PackageReference>
- update your unity project to version 2021.3.33
- update your wwise project to v2023.1.4.8496 and rebuild your soundbanks
- I had issues loading the soundbank through code, so I just cut that code and renamed my soundbank from .bnk to .sound and let r2api do it
- if your weaver doesn't weave, make sure your post build is targeting the right destination (2.1 folder instead of 2.0) and throw this dll in your libs folder haha woops who put that there
Code Changes
TemporaryOverlay
changed toTemporaryOverlayInstance
- instead of
TemporaryOverlay overlay = someModelGameObject.AddComponent<TemporaryOverlay>();
TemporaryOverlayInstance temporaryOverlayInstance = TemporaryOverlayManager.AddOverlay(someModelGameObject);
- rest of the fields are generally the same, sans
AddToCharacerModel
being corrected - instead of destroying the component, now do
if(temporaryOverlayInstance != null) temporaryOverlayInstance.Destroy()
- Achievements now give lunar coins.
RegisterAchievementAttribute
now has a field for lunar coin rewards - mastery skins give 10
- some skill achievements give 3, some 5. check the game's achievements for more examples
- On that, UnlockableAPI hasn't been updated to work with this. I believe it's ripperino for that. you should update your achievements to just use the registerachievementattribute. Henry Tutorial has a good way of doing this.
- a lot of catalog.init functions have been changed to be coroutines returning
IEnumerator
instead ofvoid
. doyield return Orig()
instead of justorig()
DamageType
changed toDamageTypeCombo
(due to the addition ofDamageTypeExtended
which is justDamageType
again cause they ran out of room for more damagetypes)- This doesn't affect r2api damageapi. that should be working the same. if you are seeing issues with that, report them
BulletAttack.BulletHit
is pooled now. If, for whatever reason, you were instantiating any directly (with e.g. = default(BulletHit)), it'll now cause some weird NREs -- capable of, among other things, completely killing the BepInEx logger if you try to log it directly.- This needs to be replaced with BulletAttack.GetBulletHit(), and probably something to clear the pool manually later if you aren't doing stuff during existing BulletAttack code
- function
GenericSkill.OnFixedUpdate
now has afloat deltaTime
parameter EntityStateCatalog.InstantiateState
now needsref
before theSerializableEntityStateType
parameter
Character Stuff
- some Effects and ProjectileGhosts are pooled now.
- if your projectiles aren't set up for this, I just did a
projectileController.ghostPrefab.AddComponent<VFXAttributes>().DoNotPool = true;
to avoid it for now - I would highly suggest looking into adding an
EffectManagerHelper
component to pool your effects. pool is cool. I will update this with more detail when I do it myself - if you set up your
KinematicCharacterController
yourself, set theplayerCharacter
value to true for survivors. - Henry clones commando's body for his setup so you're likely not to need to
Misc
- If your mod is translated, in addition to
es-ES
for Spanish (Spain), there is nowes-419
for Spanish (Mexico)
How to upgrade a 2019.4 Thunderkit project to 2021.3.33
- Create a new branch for the upgrade process, you'll want this in case you fuck something up.
- Open your project on the 2019.4 version of unity
- Ensure no errors are present, push your commit to your new branch
- proceed to open your project on 2021.3
If you get a message regarding the project having compilation errors and wanting to init the project in safe mode, do not enter safe mode, it disables thunderkit and we'll need it to reimport the game.
- Once your project is open, close it and browse to your "Packages" folder on the project root
- Open your
manifest.json
file. - Update any and all GIT dependencies on your project. bellow are the current latest versions of the common git projects used for modding
- ThunderKit - 9.0.0 or Greater
- Risk of thunder multiplayer HLAPI
- 1.1.1 or Greater
- RoR2EditorKit - 5.2.1 or Greater
- RoR2ImportExtensions - 1.7.0
- MSU - 2.0.0 or Greater (if used)
- On the same folder where the manifest.json is located, delete the packages-lock.json file.
- Once this is done, select every folder inside "Packages" and delete them, we're going to reimport the game.
- Open the Project, you may get prompted to initialize R2EK, up to you if you initialize it now or later.
- on your "ThunderKitSettings" folder, delete the following if present:
- MaterialEditorSettings
- R2EditorSettings
- RoR2EditorKitSettings
- ShaderDictionary
-
Open your Thunderkit settings window, configure your import configuration and import.
- If using MSU, make sure that the WWise BlackLister is ENABLED, this will save us time for later
-
Post import, if youre using WWIse, follow the following lettered steps, otherwise, skip to 14 a. If using the WWIse integration, you'll want to delete the WWise assemblies imported by the game, which are the following:
* Ak.Wwise.API.WAAPI * AK.Wwise.Unity.API * AK.Wwise.Unity.API.WwiseTypes * AK.Wwise.Unity.MonoBehaviour * AK.Wwise.Unity.Timeline * Note: if you where using MSU and you had the wwise blacklister enabled, these assemblies where already ommited during import process.
b. Once you ensure only the WWise AssemblyDef and WWise Editor assembly defs are present, fix any and all compilation issues. c. Once your project is free of compilation issues, travel to your mod's AssemblyDef, if the "useGuids" option on the assembly definition references is toggled, untoggle it. d. Open your assemblyDef on a text editor, make sure the strings inside the "references" array has the following entries. do not remove "Wwise", as otherwise the integration step update will fail * "Ak.Wwise.Api.WAAPI", * "AK.Wwise.Unity.API", * "AK.Wwise.Unity.API.WwiseTypes", * "AK.Wwise.Unity.MonoBehaviour", * "AK.Wwise.Unity.Timeline" e. Once you've ensured no errors remain, close your project and open the wwise launcher. f. ensure you have version
2023.1.4.8496
of Wwise installed. g. on the "Recent unity projects" tab, locate your project, clik "Upgrade WWise in project" h. Ensure the settings are correct, and then click "Upgrade" (or integrate, i forgot the exact word) i. The wwise launcher will proceed to upgrade your project to 2023.1.4 version of wwise, this will also keep any script references to your project's assets. Its important that there where no compilation errors because otherwise WWise fails to integrate. j. Once you finish integration, click the wwise icon shown on the image below k. You'll be prompted to upgrade your wwise project to the specific version, proceed with the upgrade. 14. once import is complete, you should be good to go. if you used the "LanguageTree" datum from R2EK, your manifest is going to have invalid entries in it. you can either remake your manifest or fix it yourself.