http://www.gamesas.com/topic/1530052-rel-oblivion-script-extender-obse-0021/

OBSE - The Oblivion Script Extender
OBSE is a modder's resource that expands the scripting capabilities of Oblivion.

It doesn't make any modifications to Oblivion.exe, TESConstructionSet.exe, or any other files in your Oblivion install, so don't worry about permanent side effects. As of v0017, OBSE requires the 1.2.0.416 version of Oblivion.

http://obse.silverlock.org/download/obse_0021.zip - current stable version, recommended for general use
http://obse.silverlock.org/
http://obse.silverlock.org/obse_command_doc.html - link is for v20 documentation. v21 documentation is included in the download.
https://github.com/llde/Oblivion-Script-Extender/issues - use this page to report bugs and suggestions.
https://github.com/llde/Oblivion-Script-Extender - need to be compiled
What's new:


Readme (abbreviated):

One function that would be really useful would be one which allows the copying of facegen data from one npc to another npc/the player. Lots of cool things could be done with that (copyrace already allows race morphing).

Heyaa !

as usual

I have something to report

this code is not working, just because the symbol ' & ' made the code think that is something else

if IsModLoaded "Dungeon&ExteriorActorsHaveTorchesCT.esp"

and this one works, the ' & ' symbol separated from another word/character (has space)

is there a way to escape that character ??

if IsModLoaded "Dungeon & ExteriorActorsHaveTorchesCT.esp"

thanks Llde for your hardwork !

re: GetAVSkillMasteryLevel/C uses base actor value for the skill

Can you confirm this is correct? Last I checked it wasn't going off of the base AV, so I created my own function in the sdr.dll.

Also, if there are any functions in sdr.dll that you think would be helpful in OBSE, feel free to use/take 'em. There's a few that people wanted to use without having to install SDR, but I didn't want to create a separate .dll just for the one or two people that made the request. So I figured maybe it would be better if I just donated them to the core OBSE, assuming that they fall within what you want OBSE to do.

From the OBSE documentation:

This means those commands only want the base object (either the passed object or the base object of the calling reference).

You can't assume all commands still work if you pass a reference as "object" parameter, so it's better if you always pass them a base object.

If base object is what they want, then give them a base object!

You can extract the base object yourself and ensure you can use those commands no matter what they do.

If IsReference refVar
   Let refVarBase := refVar.GetBaseObject
Else
   Let refVarBase := refVar   ;already a base object. No convertion.
EndIf
;... now refVarBase is surely a base object and you can pass it as Object parameter to any double-sheath command.

@saebel
These functions internally call GetSkillMasteryLevel(actor->GetBaseActorValue(skillCode)) both of them are call into the original gameocde.
So I actually don't know. Never checked these function functionality.
Thanks for the offer. Will check.

@lubrons
Some functions internally first check explicity for a passed ThisObj (the object passsed with reference syntax) and only then get the object with ExtractArgs.
The issue you were experiencing with OBME and Add Actor Values is that Jroush replaced the OBSE functions with its own implementation of the functions modifying the commandtable.
However he forgot(or maybe he didn't this purposefully) to account for the reference passing syntax.
I have not the intention to remove this possibility however.


Fun fact: I just stumble upon the Obse Whishlit on cs.elderscrolls.com. One of the feature requested was the ability to do pointer arithmetics on references.
The unsafety is strong in this one.

Wait...

But the OBSE documentation says:

@forli yes it's true, I remebered wrongly.

@lubrons There isn't any list for this kind of function. This is an information that should be in the docs. The only way to check if a function support the dual syntax is checking in the sourcecode.

Not many plugins replace OBSE functions, becouse it require to iterate manually in the command list. Dangerous thing that require pointer aarithmetics.
I'm thinking about exporting a Replace function in the PluginAPI becouse there exist valid and legit reasons to do so.

I'm actually not very familiar on how the string is passed on these functions.
I need more information about the bug. If you try to console print the mod name what give to you? And with a messagebox?

report !

sorry, man !

the script is working as intended !!

hmm ... strange

yesterday I'm pretty sure that ' & ' symbol gave me some trouble

I will let you know if I can replicate the errors

Isn't replace already in ? I'm almost sure I copied it into NVSE.

@hlp The function exist in OBSE native code, (so I can change a native script function with my own implementation directly from OBSE sourcecode,a s I did for GetDisease) but it isn't exported into the PluginAPI.
Changing the commandlist is still possible but it require iterating with pointer arithmetics from the start.
Exporting is Replace will make this easier and less error prone.
An example:
OblivionReloaded change sleeping for the player, so it introduce a slight incompatibility with mod that use IsPCSleeping functions that return true even with a simple wait.
To fix the incompatibility Alenet should write a new function in his plugin and replace the original one with his own.

A Replace function would be very welcome|

In EMC2 I need to patch the StreamMusic command with _asm code to make it work with the EMC2 music system.

If I could directly replace the "execute" function of StreamMusic command (while keeping the same parameters and return type) it would be much better.

JRousch did replace the functionality of some of the commands to work with his AddActorValues OBSE plugin, rather than create new commands (although he added a few of those as well). He documented the changes, so it may be worth looking at.

You're right, there are only get functions in NVSECommandInterface. Though this is enough to replace the content of a CommandInfo.