Name: Poison Equipper
Version: 1.0
Date: 8/23/2007
Category: Miscellaneous
Requirements: Oblivion Patch 1.1.511, Oblivion Script Extender (OBSE) v12
Author(s): haama
Source: http://www.tessource.net/files/file.php?id=12851
Thread: http://www.bethsoft.com/bgsforums/index.php?showtopic=747514

===========
Description
===========
Lets you cycle through and equip any poison with a single key-press: no more "Would you like to poison your weapon?", and you don't have to open your inventory each time. Just place any poison(s) you want to be able to use inside the provided pouch. Cycle through with '[' and ']', and poison your weapon with 'p' (you can change all of these). Also, you can get more uses out of each poison (see Options for details).



======
Using
======
The Poison Pouch will automatically be added to your inventory. Equip it to open it (either hotkey or in your inventory works). Place any poison you want readily equippable into the pouch. You can also access the options from here (Options details below). Close the pouch, and you're ready to use the poisons.

There are 2 modes: Manual Mode (default) where the poison is set when you press the poison key, and Auto-Mode where the poison is automatically set whenever your weapon is drawn (Auto-Mode has 4 different styles, see below).

Manual Mode
-----------
(Default) Press 'p' to equip the poison to your weapon, '[' to cycle to the previous poison, and ']' for the next poison (both will return to the other end of the list). A message will pop up telling you which poison is currently equipped. It's set to only display the last poison equipped, but if you find the delay for the message too long or that there are too many messages, see the "Previous/Next Poison Message (and timing)" section in Options (under "Messages").

Auto-Mode
---------
Cycle through your poisons with '[' and ']' as with Manual Mode. There are 4 different styles in Auto-Mode that you can cycle through with the Poison key (default 'p'). These styles determine when a new poison will be applied to the weapon after the old poison is used (the enemy is struck with the poisoned weapon): Off - poisons won't be applied; Immediate - right after the strike; Close-Range - once the effects of the old poison have worn off; Ranged - 3 seconds before the old poisons's effects wear off. To use this mode, you'll need to choose it in the Options menu, where you'll also find more details and tips.


Pouch Buttons
-------------
The pouch has several 'buttons' when you open it. Simply click on one to press the button. There are 3 buttons:
	(Auto) Add Poisons to Pouch - automatically moves all poisons from your inventory to the pouch.
	Mix Poisons - Mixes any stacks of poisons with the same effect(s), but different potencies into 1 stack of the averaged potency.
	Options - opens the options menu.


Options (more details in-game)
------------------------------
There are quite a few options. To give you an idea of what can be modified, here's the list:
Equipping Options
	Set Manual Mode/Auto-Mode
		Manual Mode (default)
		Auto-Mode
			Set Style
			Range Mode Timing Options (for multiple-effect poisons)
			Tips	
	Set keys: Change which keys are used for equipping the poison and cycling through the poisons.
	'Faster' Previous Poison method

Replace/Add Poison if Weapon is Already Poisoned:
	Do nothing (default): If you try to equip a poison when your weapon is already poisoned, nothing will happen.
	Replace: The poison on the weapon will be replaced
	Add: The poison will be added to your poison. Good for mods that automatically apply poisons to your weapon, such as Locational Damage.

Longer Lasting Poisons: Increases the number of uses you can get from each poison. You must set this in options to use it.

Expert Modes:
	Allow Scripted Poisons
	Allow potions to be used as poisons

Pouch Options:
	Auto-Add poisons upon opening pouch
	Auto-Mix poisons upon closing pouch
	Pouch Weight Multiplier

Messages: Turn on and off various messages
	Weapon Poisoned Message
	Previous/Next Poison Message (and timing)
	Weapon is already Poisoned (or, Replacing Weapon Poison)
	'Your Pouch is Empty' Message



=======
Install
=======
1. Extract the files to (install folder)\Oblivion\Data\
2. Start Oblivion Launcher, click 'Data Files', place a checkmark beside the .esp file(s).



=========
Upgrading
=========
Replace the old Poison Equipper.esp file with the new one.



=========
Uninstall
=========
1. Take everything out of the Poison Pouch (the buttons won't run if you use "Take All", so it's safe to use)
2. Start Oblivion Launcher, click Data Files, uncheck the .esp file(s).
3. Delete the files/folders associated with the mod.



=========================
Incompatibility
=========================
This will not work with the Inventory Tracker version of the Poison Equipper; choose one or the other.

When using mods that automatically apply poisons to weapons (i.e., Locational Damage) you need to set 'Add Poison' by opening the Options menu, selecting 'Replace/Add to already poisoned weapon", and select "Add". If you're using Auto-Mode, you may notice some oddities if you change weapons/poisons/etc. Most notably, any time you select a new poison it will be added to the stack of effects, rather than replace your old poison. 



====================
Known Issues or Bugs
====================
The cycle and equip keys won't work if a menu is open and the game is paused (inventories, spell lists, options, etc.)

The order of the poisons is a bit weird - it's not the order you see it in when you open the menu, and it's not quite the order that you place the poisons into it. However, the order will always remain the same, even if you run out of a poison and then add more to the bag.

Don't place the Poison Pouch into itself...
If you need another Poison Pouch, open the console (default ~), enter, without quotes, "StartQuest PEInit", and press <Enter>.

The pouch buttons will seem to disappear after you use them. They will return once you click on something else in the menu, or switch back and forth between the player's inventory and the pouch inventory. The "Add Poisons to Use" button will disappear once you click it, however...

In Auto-Mode and Replace/Add, if you change weapons and then poison, and then switch back to the weapon, you will have the wrong poison added back to your pouch. To avoid this, you can lower your weapon to un-apply the poison, then switch weapons.

The weight of the bag won't change (only visually?) until you close and re-open the player's inventory screen.

No icon for the 'Next' poison message, sorry.



=======
History
=======
v1.1 (09/07/2007)
-----------------
Added:
	Now able to Add your poison to an existing poison (good for Locational Damage)
	Auto-Mode - automatically poisons your weapon
	Now able to Mix several stacks of poisons into one
	Now able to use Potions as poisons
	Options for all of the above
	
Now compatiable with Oblivion v1.1.0511

Fixed bugs where using 'Previous' Poison would seem to empty out your pouch.

Various other bug fixes and background changes.


v1.0 (08/24/2007)
-----------------
Initial release



=======
Contact
=======
You can find me on the official Elder Scrolls forums as 'haama'
You can find me on TESSource.net as 'haama'



=======
Credits
=======
Thanks to the OBSE team for making this anywhere near possible.



===============
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.