Ersh
patreon
Open Animation Replacer 0.8.0
🕑 Added 2023-04-23 06:32:38 +0000 UTCHey!
This version unfortunately has a breaking change that will require recreating all the .json files. Hopefully won't happen again, but it was necessary.
Conditions underwent a major rework yet again, this time vastly improving their flexibility to allow creating new conditions through the OAR plugin API. This will let other SKSE plugin authors create new conditions. I will also provide the source code of an example plugin to make it easier.
Notable changes and additions:
- Animation log: This is a debug overlay that shows up in the upper right corner of your screen and displays all the recent activated/interrupted animation clips. You can open the overlay by clicking the Animation Log button next to the Settings button in the ingame UI. Then either select the character by clicking them with the console open, or type the actor's FormID in the OAR ingame UI. You can configure some settings of the animation log in the Settings menu.
- New submod parameter: "override animations folder" - this will cause the submod to load animations from the specified folder, instead of its own directory. This was added because many animation replacer mods duplicate the same animations in each submod so they have different condition sets. This lets you use the same animations in multiple submods without duplicating them. I've update the EVG Conditional Idles OAR Example with this change if you want to see how it's supposed to be structured.
Implementing this feature actually made me realize I could do more, which led me to the next feature... - Duplicate animation filtering: This feature calculates a checksum hash of every replacement animation file before adding it to the animation list inside the behavior project. The hashes are supposed to be unique, so if another animation has the same hash, it's the same file - and it won't be loaded again, the replacer mod will just use the first loaded one.
This has the potential to massively cut down on the amount of loaded replacement animations, depending on the replacer mods you're using.
The hashes are cached in a .bin file stored next to the plugin so the relatively expensive hash calculation doesn't need to happen every time you launch the game. The file can be safely deleted, either manually or by clicking a button in the Settings menu. - SKSE Plugin API: While not useful right now, this is a major feature that I wanted to have ready for public release. It's fully functional now and I've tested it with an example plugin.
- Replacing animations on Echos: (Brought to my attention by Maxsu) Some animation clips that aren't technically looping animations, but can loop into themselves (a good example is the left handed dual wielding attack - it combos into itself) don't actually Deactivate/Activate the clip, but instead add something that Havok calls Echo. It's basically a way to allow a clip to blend into a copy of itself. The fact that the Activate function wasn't running meant that the animation wouldn't be re-evaluated for replacements on Echo. This has now been fixed and every time an Echo is started the animation is checked for potential replacements.
- Convenience editor buttons: There are new buttons letting you copy and paste a condition set, and you can now right click on a condition to copy/paste it somewhere else.
- Random condition fix: The previous version had a major logic error, the condition should work as expected now.
Please remember that THIS UPDATE REQUIRES DELETION AND RECREATION OF ALL THE .JSON FILES, or the replacer mods won't function correctly.
For anyone confused what that means, vai1lyn has posted a perfect explanation in the comments so I'll just paste it here:
The JSON files are the new file format for OAR, an advanced version of the DAR conditions.txt in "meshes\actors\character\animations\DynamicAnimationReplacer\_customConditions". If you only use OAR with your preexisting DAR mods, there is nothing you should worry about. But if you used the in-game GUI to edit your conditions or ported mods to the new OAR format, you need to remove the files in the following location: "meshes\actors\character\animations\OpenAnimationReplacer", and redo your edits/ports for v0.8.
OAR now has all the features I had to have for v1.0. I'll focus on cleaning up the plugin source and getting ready for public release.
EDIT 0.8.1: Fixed the issue with controls being unresponsive after closing the menu.
Comments
No it's absolutely not normal, that's horribly slow. Thing is, that process is entirely done by the game, I just queue up the animations - so it should be the same speed as with DAR. My Animation Queue Fix on the Nexus should speed it up for both OAR and DAR. Aside from that, it's probably related to the speed of your disk and CPU.
Mahbod Morshedi
Hi, I've been using OAR for a while now, and the animation loading is taking about 12 min (for the yellow bar at the corner to complete and do its thing). Is this normal? I have about 10000 animations.
I'm using the vanilla game function there; I think DAR does too. The condition will remain like that by default (it should, I want 100% parity with DAR for legacy mods) but I can add a toggle inside that condition that could be set in OAR's config to change its behavior so it only checks active magic effects.
Ricardo Evans
Hello Ersh, I find out that the HasMagicEffect condition of DAR calculates all magic effects instead of only active magic effects. Is it also the behavior of OAR?
Would't the config file conflict as the folders get merged into one folder by MO2? There's no way around this with DAR's structure; however OAR's structure lets you name folders however you want, and define priority in the config file.
someusernameiguess
General question: how does OAR handle the case of a first person animation pack having the same folder number somewhere as a third person animation pack that's also being loaded? In that case there are no loose file conflicts whatsoever in like MO2 obviously. Looking at DAR's page it doesn't seem to have ever been clear about what it did for that, so I was just kind of wondering for OAR at least.
Yep, in SKSE/Plugins. If you're using Mod Organizer, then it's probably in the overwrite folder as it's generated on first launch.
Yukavii
Hey, where is the .ini supposed to be stored? I can't find it in the skse/plugins I'd like to change the keybind for the GUI if possible :)
Good idea, but it might be very tricky to do with ImGui.
TKCen
Working great, minor UX improvement request if possible: Clicking on the anim log entries of recent animation should open the matching mod.
It worked correctly in the previous version, right? Doesn't happen to me, but I changed related stuff in this update so I'll probably have to take a look at it again.
Good point, I forgot to look into that. I'll see what can be done.
tridbee
Hello, I have a problem with the GUI. After I close the GUI by either using the hotkey or click the close button on GUI, the menu disappeared but I did not regain any of my game's controls, forcing me to close the game.
Cederien
That Duplicate filtering is a genius development! One question though, the editors font and buttons are painfully small, any way to increase them. (Got the same with the ENB editor, but I rarely mess with that one. I'm getting the impression I will soon spend a good amount of time with the OAR Editor and that would be painfull for my old eyes.)
Pardon the noob question. But which json files? Where? How are they created and what should I delete?
