Name: Dynamic Drop Lit Torches
Version: 1.0.0
Date: 04/12/2017
Category: Miscellaneous
Requirements: Oblivion Patch 1.2.0.416, Oblivion Script Extender 0021 or Newer (http://obse.silverlock.org)
Author(s): Malonn
Source:

Description
===========
Drop Lit Torches with surprises. Optionally hotkey a torch for quick equip/unequip. Quickly adjust torch brightness and coloration. Throw and
fight with torches.

Details
=======
* Drop Lit Torches: The core of this mod is automagically dropping lit torches. A torch will be dropped if it is equipped and your hands are full.
This means if you attempt to equip a torch while your hands are full, or if you have a torch equipped already and you draw a weapon that will result
with both hands being occupied. There is an additional "weight" factor given to torches when they are dropped. This weight is simulated via scripting
and is optional, however. Sometimes, when active, a torch will fall through the ground which can be annoying. So, this feature can be disabled,
resulting in falling through the ground much less frequently. Torches rarely fall through the ground with the "weight" feature active, but your mileage
may vary, so it is optional. So what is different from other DLT mods? The scripting used to accomplish this is minimal. There will be no wasted
CPU cycles. I have added the feature of ZERO savegame bloat. Other DLT mods create dynamic references, which persist in the savegame and build up
over time. This causes several problems for Oblivion, including long saving time (the game will freeze for a period of time that grows the more the
savegame bloats), and, eventually, will lead to corrupt saves and the inability to load a game. All dynamic references are tracked and destroyed in
this mod; it will do nothing to create bloat in your savegame.

* Hotkey Torches: This mod adds a torch hotkey that allows you to quickly equip or unequip a torch by pressing the hotkey. This is fully compatible
with all hotkey mods. The hotkey is optional and can be disabled in the INI. If you choose to use the hotkey, the scripting required to enable the
drop lit torches effect without the hotkey item will be disabled, saving CPU cycles. Alternatively, not using the hotkey disables it's scripts, and
enables the torch scripts, still allowing you to have the DLT effect. So, essentially, using one disables the scripting for the other, and vice versa.
I recommend using the included hotkey. If you choose to, you must assign the inventory hotkey item (the icon of a torch with the word "hotkey"
written across it) to a hotkey and equip/unequip then by pressing the key. If you choose not to use the torch hotkey menu item, then just assign a
torch directly to a hotkey (as-in vanilla Oblivion). Either way, you get the "drop lit torches" action.

* Torch Configuration Menu: The mod comes with an optional inventory menu item that allows you to control torch light radius, color components and the
like through that menu. The ability to control these things via hotkey will also be available, but if you prefer a menu, then you have it. If at any
time you decide you do or do not want this menu, set your preference in the INI and the mod will adjust accordingly. If you do not want the menu, then
the scripting associated with it will not run, saving CPU cycles.

* Torch Light Radius Control: This mod gives you the ability to modify the torches light radius via hotkey or menu. Are you running a darker
nights mod? A darker dungeons mod? With the (default - configurable via INI) key combination of "LEFT ALT" + "NUMPAD +" you can increase torch brightness.
Think torches are too bright? "LEFT ALT" + "NUMPAD -" will lower the torch light radius. These key combinations are configurable via an INI file.
You can also use a menu to increase/decrease the torch light radius, if hotkeys aren't your thing.

* Torch Light Color Control: Want to tweak the color given off by torches? Just use a key combination or menu item, and you can. By pressing "NUM 0"
for red value, "NUM 1" for green value, and "NUM 2" for blue value, plus the "NUM +" (to increase the color component) and "NUM -" (to decrease the
color component), you can tweak the torch color to whatever Oblivion will allow. This can also be done through a menu item.

* Throw Torches: By pressing the torch throw key, which is configurable in the INI file, you can throw a torch for a distance or until it hits something.
This is useful to light up further down dark passages. If the thrown torch hits an NPC, that NPC will catch on fire, taking damage as it does so. The
default throw key is "R", but you can change it to whatever you like in the INI file.

* Wield Torches as Weapons: At any time, you can now choose to equip a torch as a weapon. Equip a torch as a weapon via a specific key. While a torch is
equipped, hold down a configurable key (see the INI file) for three seconds and you will be presented with a message asking if you'd like to use the torch
as a weapon. Torches catch actors on fire when they are struck. The torch damage is set to the base object's value by default. In the INI this can be
changed to be 10%, 20%, or 30% stronger.

* Also, at any time, if you want to check the current red/green/blue component of the torch light color (just to see where it stands), as well as the current
torch light radius, press "NUMPAD 0" + "NUMPAD /" to bring up a quick message box. This is not configurable but can be with demand.

Install - Manual
================
1. Extract the files to a temporary location.
2. Examine the folder structure and make corrections where necessary.
3. Copy files to (Install Folder)\Oblivion\Data\
4. Start your prefered mod manager and place a checkmark beside "Dynamic DLT.esp".

Uninstall - Manual
==================
1. Start your prefered mod manager and uncheck "Dynamic DLT.esp".
2. Delete the files/folders associated with the mod.

Delete:
Oblivion\Data\Ini\DynamicDropLitTorches.ini
Oblivion\Data\Meshes\DynamicDropLitTorches\
Oblivion\Data\Textures\Menus\Icons\DynamicDropLitTorches\

Upgrade
=======
Initial Release: N/A

Incompatibility
===============
This mod was designed to be as compatible with other mods as possible. It accomplishes most of it's goals through scripting, which ensures a broad
range of compatibility. The only major incompatibility is a "Drop Lit Torches" mod. It just doesn't make sense to run more than one mod that offers
the ability to drop toches.

Known Issues or Bugs
====================
None at this time.

History
=======
1.0.0, 2017/04/12 - Initial release.

Contact
=======
I can be contacted through the mods' official page on Oblivion Nexus -- either by posting a comment or PM'ing me (Malonn).
I also regularly visit the official Bethesda Forums; you can PM me there or post in a thread.

Credits
=======
Special Thanks to forli for scripting help. This guy is practically a god of Oblivion scripting knowledge.
Special Thanks to lubronbrons for scripting help.
Thanks to underground09 for his drop lit torches mod that inspired me.
Thanks to QQuix for scripting help.
Thanks to syscrusher for scripting help.
Thanks to TheNiceOne for scripting help.
Thanks to HeyYou for scripting help.
Thanks to shadeMe for his CSE.
Thanks to Nexusmods.com for the a one-stop-shop resource for authors and players.
Thanks to Bethesda for creating Oblivion.

Tools Used
==========
Oblivion Script Extender (OBSE) - http://obse.silverlock.org/
TES Construction Set - http://www.nexusmods.com/oblivion/mods/11367/?
TES Construction Set Extender - http://www.nexusmods.com/oblivion/mods/36370/?
GIMP - https://www.gimp.org/
7-Zip - http://www.7-zip.org/

Licensing/Legal
===============
You must contact me and obtain my permission before re-packaging any part of
this mod. If I do not respond within 2 weeks, feel free to do whatever you
like with this mod.