0 of 0

File information

Last updated

Original upload

Created by


Uploaded by


Virus scan

Safe to use

About this mod

OBME extends the Oblivion magic system to make it more general and open to mod makers.

Permissions and credits
Name: Oblivion Magic Extender
Version: v1.0
Date: 2010-09
Category: Magic - Gameplay
Author: JRoush
Forum Thread: Bethesda Forums
Contact: [email protected]

NOTE: using OBME with the wrong verison of Oblivion or the CS will, *at best*, cause it to crash.
  • Oblivion v1.2.0416
  • TESCS v1.2.404 (only if you are planning to make mods using OBME)
  • Oblivion Script Extender (obse) v0018 or higher. v0019 recommended.

[size=+1] Description:
[/size]OBME extends the Oblivion magic system to make it more general and open to mod makers. It is a pair of plugin libraries for OBSE that hack the game/CS to change it's behavior. This is the same principle behind OBSE itself - it's quite safe, and legal. OBME does not alter Oblivion.exe or TESConstructionSet.exe in any way. The key features are:
  • More control in editing Magic Effects and Effect Items in the CS
  • Creating new magic effects, both in the CS and from scripts in-game
  • *Any* effect item may now override select properties of it's magic effect: Name, School, VFXCode, Hostility, Icon, Base Cost, Resistance AV, and numerous of other properties.
  • Expanded ModifyActorValue handler to specify what modifier is affected
  • Expanded SummonActor effect handler to allow custom summoning limits
  • Expanded ScriptEffect handler to allow scripts specified for an entire magic effect, not just individual effect items
  • Expanded Dispel effect handler to allow partial dispelling of effects, to selectively dispel effects based on magic effect, effect handler, hostility, and magic item type
  • When an active effect is dispelled by recasting the spell or exceeding a summoning limit, its remaining magicka may be "reclaimed" to strengthen the effect that replaces it.

OBME is a modding *resource*. All of it's features are modular, and are disabled by default. A 3rd party mod like the included examples is required to actually use any of these features. For more details and technical information, please see the accompanying document 'OBME Features.pdf'. This file has background information and technical details.

[size=+1]Compatibility with the Oblivion Script Extender:
[/size]Some obse functions will not work with OBME, and some have been deprecated. See the full readme for details.

[size=+1]Compatibility with other mods:
[/size]OBME doesn't add any actual content to the game, so there is no chance of conflicts with any traditional mods.
Mods made for OBME can be loaded even if OBME isn't installed. Any OBME-specific features are disabled, so the mod may not be very useful.
Savegames made with OBME can be loaded after OBME is uninstalled, provided the 'Uninstallation' directions above are followed.
OBME is designed to be compatible with AddActorValues.
OBME is incompatible with Custom Spell Icons v3.1. This is because both attempt to patch the same game code.

[size=+1]Compatibility with 3rd party Mod Editors (TES4Edit, WryeBash, etc):
[/size]OBME alters the savegame and esp format slightly. Other programs that display or edit these files may run into trouble.
- TES4Edit v2.5.3 can load/save OBME mods just fine, but may crash if a magic effect or magic item is selected.
- WryeBash v287 can manage OBME mods just fine, but problems will arise if you try to build a bashed patch that includes magic items.
The maintainers of these programs (Elminster and Waruddar, respectively) have graciously agreed to add support for OBME in future versions. If you get the chance, please be sure to thank them for this.

[size=+1]Questions & Bug Reports:
[/size]If you have a question, *look in the included 'Features' pdf*. It has a table of contents; you don't have to read the whole thing to find what you're looking for. If your question isn't answered there, I would be glad to answer it on the forum thread.

To report a bug or ask for help with troubleshooting, follow these steps:
  1. Read this readme carefully.
  2. Reproduce the problem. If it's a crash, restart the game or CS and try to make it crash again.
  3. Narrow down the cause. If it's a conflict, try to figure out which mod it's conflicting with.
  4. Send me an email at JRo[email protected] or PM me on the TESNexus/Bethesda forums
When you do contact me, be sure to include:
  • Include the problem details and the version of Oblivion, TESCS, and OBSE you are using
  • Include a list of other OBSE plugins you are using (OBGE, CSI, MenuQue, Oblivion Stutter Remover, etc.)
  • Attach the savegame or mod file that you were using when you discovered the problem
  • Attach the log files "OBME.log" and/or "OBME_CS.log", which can be found in your Oblivion folder.

I'll need all of this information to have any chance of reproducing your problem. And if I can't reproduce it, it doesn't get fixed.

[size=+1] Included Demo Mods:
[/size] Included are several small demo mods with names like "OBME_***_example.esp". Each demonstrates a different feature of OBME, and provides an assortment of spells, items, etc. that can be used to test it. See the mod descriptions for details. When playtesting these mods, remember to wait about 5 seconds after loading the game for all scripts to fire up.

[size=+1]Installation & Uninstallation:
[/size]See the full readme for instructions.

[size=+1]Changes in v1.0:
  • Fixed issue where ModAV effects couldn't modify base actor values below zero, which was breaking some ability weakness effects.
  • Removed dependancy on AddActorValues. OBME is still compatible with AAV, but does not requires it and is no longer packaged with it.
  • Standardized format of drop-down lists for magic effects and handlers in CS
  • Several small bugfixes
  • Removed overrides to CopyThEI, CopyAllEI, and GetScriptActiveEffectIndex obse functions, as v0019 made these overrides unnecessary
  • Added overrides to GetSpellMagickaCost, GetSpellMasteryLevel, GetSpellSchool, and GetEnchantmentCost

  • Bethesda Softworks, whose game has sucked up far, far too much of my free time
  • The OBSE team for their incredible modding resource.
  • scruggsywuggsy the ferret, who has been making a considerable effort behind the scenes to make OBSE compatible with OBME.
  • everyone on the TESNexus and Bethesda forums who took an active interest in the project - DragoonWraith, tejon, Waruddar, shadeMe, kyoma, and many others.
  • special thanks to SpeedyB, Kamikaze, and Statttis for helping track down and solve bugs
  • Statttis, for doing the extensive legwork necessary to implement effectitem icon overrides.

[size=+1] Tools Used:
  • Oblivion Script Extender (OBSE): http://obse.silverlock.org
  • TES4Edit: http://www.tesnexus.com/downloads/file.php?id=11536
  • TES Construction Set: http://www.tesnexus.com/downloads/file.php?id=11367
  • Microsoft Visual Studio 2008: find a download yourself ;)
  • IDA Pro v4.9: http://www.datarescue.com/idabase/ida.htm
  • Perforce SCM: http://www.perforce.com/perforce/downloads/index.html