Oblivion
0 of 0

File information

Last updated

Original upload

Created by

Migck

Uploaded by

miguick

Virus scan

Safe to use

About this mod

A modders resource with a script that set ups basic event handlers for all event types that OBSE allows. They will report the even'ts description and parameters to the console and ConScribe together with the event's exact timing. Useful to learn how the game does stuff, and improving your own handlers.

Requirements
Permissions and credits

EVENT HANDLER TESTING SUITE


REQUIRES
:
OBSE 21+
ConScribe recommended to read the event log out of runtime.
MenuQue event types also included if installed.



This mod sets functions for all event handler types defined by the latest version of OBSE, which will report to the console, and to a ConScribe log if available, the info of what happened in the event, together with the hour, minute, second and milisecond it happened. The log can thus be viewed at runtime by opening the console, which you can navigate with the PgUp and Down keys, or at the ConScribe log created at 'Per-Script/TestHandlers.esp - [XX]000847.log'
Do note that if you use ConScribe, to my chagrin I haven't yet learned how to maintain a more elegant log, so that file will keep growing and growing after every game session. Just be sure to delete it once a month or so before it eats your HD (it won't, but the point is it will keep getting bigger :D)
There are a pair of caveats I found while testing myself. The 'OnPackageStart/Change/Done' handlers can indeed be reported for ALL actors without the 'No Low Level Processing' flag, which there are several hundred of in a normal game. Same deal with the 'OnActivate' handler when such an NPC goes through a load door, since doors are persistent by definition.
To limit the spam this causes, there are a pair of global values you can change in the console:
  • 'set TestHandlersReportPackages to x' limits the event reporting for the package handlers. Default is 0, they don't report at all. With 1, they report for actors in your same cell. With 2 or more, for all actors (useful to verify how truly alive the world of Oblivion really is!)
  • 'set TestHandlersReportActivate to x' does the same for the OnActivate handler. It always report for what you, the player character, does activate.

If you have MenuQue installed, the mod will also set similarly descriptive menu event handlers, but these are not logged by default. They need you to set another global value, named TestHandlersMenu, in the console to match the Menu Mode you're interested in learning about. So for example to make them log info about your inventory menu, just be sure to type in the console 'set TestHandlersMenu to 1002' beforehand. To turn them off, use 'set TestHandlersMenu to 0'.

And that's it! I hope this utility helps you learn how the game, well, handles stuff, so that it might help you with your own event handlers for example.