0 of 0

File information

Last updated

Original upload

Created by

crozierb

Uploaded by

crozierb

Virus scan

Safe to use

About this mod

Automatically uses filled soul gems and varla stones in the player\'s inventory to recharge the currently equipped weapon when required.

Permissions and credits
Name: Keep Weapon Charged
Version: 2.1
Date: 20/12/2010
Category: Gameplay Effects and Changes
Requirements:OBSE 19+
Shivering Isles
Author:crozierb


Description
=============
Have you ever been wandering through a dungeon hitting things with a big stick only to realise that the big stick has run out of juice? Well, you don't need to worry about it any more. This mod uses soul gems and varla stones in your inventory to recharge your currently-equipped weapon as and when required. So, whack away! - just make sure you have a collection of soul gems and varla stones with you. Even better, go get Azura's Star and enchant your weapon with Soul Trap.

The set of rules used to determine whether or not to use a soul gem/varla stone are, in order:

1. Only the currently-equipped weapon is affected (weapon slot only, no offhand weapon recharging).
2. If the weapon requires less charge than is held in a petty soul gem, no action is taken.
3. Quest items and the Soul Tomato will never be used to recharge a weapon.
4. The highest-value soul (in any gem) is used to recharge the weapon without exceeding the maximum charge for the weapon. So, if you have a weapon requiring more charge than a petty soul but less charge than a lesser soul, a petty soul will be used.
5. If the player doesn't have a soul of the right size in his/her inventory, then the largest soul smaller than the required size will be used.
6. If all of the souls in gems carried by the player are larger than the charge required (and would result in loss of extra charge if used), and if the player has a Varla Stone and the currently-equipped weapon is at less than 5% of its charge, the Varla Stone is used to fully recharge the weapon. Did that make sense? No? Try this then:
if ((I don't have big enough soul gems) &&
(my weapon is at 5% charge) &&
(I have a varla stone))
then
I'll use a varla stone
endif
7. If all of the souls in gems carried by the player are larger than the charge required (and would result in loss of extra charge if used), and either the player does not have a Varla Stone or the currently-equipped weapon has at least 5% charge left, no action will be taken.
8. When deciding which soul gem to use to recharge the player's weapon, the smallest-capacity gems will be used first. For example, between a lesser soul gem with a petty soul and a grand soul gem with a petty soul, the lesser soul gem will be used first. This saves larger capacity soul gems in case the player is using a mod that can empty soul gems.

When you load a game, a lesser power (Toggle Weapon Charger) is added to your spellbook to allow you to switch this mod on and off as desired. The mod is disabled by default.

The main script for the mod runs every 15 seconds so as not to waste CPU cycles. This should be frequent enough for most/all uses.



Install
=========
1. Extract the plugin to "(install folder)\Data\".
2. Place a tick next to the ESP under "Data Files", OBMM, etc.


Uninstall
===========
1. Remove the ESP from the installation folder.


Limitations
=============
Not really a limitation, more of a caveat: just be aware that Azura's Star will always be used in preference to soul gems. If the player's weapon only needs a petty soul to recharge it but Azura's Star currently contains a grand soul, Azura's Star will still be used. This is by design.


Known Bugs
============
Once (just once), the main script for the mod stopped working in the middle of combat. Restarting the game fixed the problem. Not sure what happened there. I haven't been able to reproduce this problem and may have fixed it without realizing.


Compatibility
===============
This mod is compatible with mods that alter the charge soul gems can carry. The altered charge values will be used.


History
=========
0.1, 14/06/2010- Initial release.
1.0, 26/06/2010- Changed name from 'Soul Gem Automater'.
Added the use of varla stones.
Tidied up the "Limitations" section of the readme.
1.1, 20/12/2010 - Mod now works with Azura's Star, but requires OBSE 19+.
Added in check for OBSE version 19+.
2.0, 21/12/2010 - Completely overhauled the logic of soul gem selection.
Mod now works with soul-trap-filled soul gems.
2.1, 30/12/2010 - Automated use of Azura's Star can no longer overcharge weapon.
Tidied up output messages on soul gem use


Contact
=========
You can find me on TES Nexus as 'crozierb'.


Credits
=========
Thanks to Bethesda for creating a game so addictive it has prevented me from getting a life.
Thanks to the creators of OBSE without which this mod wouldn't have been made.
Thanks to 'eastmanns' for helping me with testing.


Licensing/Legal
=================
If you find this mod useful, you're free to take it and use/change it as you wish. Please let me know, though.