Name: Ashara's Batman and Catwoman mod
Version: 2.3
Date: 24-2-2010
Category: Weapons and Armour
Requirements: Fallout 3 Patch 1.7
Author(s): Ashara
Sources:
* Fallout3Nexus
* PlanetFallout
* Filefront
* Spanish version: Mod de Batman y Catwoman
* French version (translated by Sylom): Tenue de Batman et Batarangs
* German version (translated by Vannar): Asharas Batman and Catwoman Mod DV
* Russian version (translated by Resident92): Ashara's Batman and Catwoman mod
* Fallout New Vegas version (by TedMani): Batman Suit
* Catsuit Skyrim version (by Halofarm): UNPCv2 Project


FILES TO DOWNLOAD
====================
MAIN FILE: REQUIRED
------------------------------------
* Ashara's Batman and Catwoman mod

OPTIONAL FILES: NOT REQUIRED
----------------------------------------------
* BatBobbleheads replacer: Replaces the displayed bobbleheds with Batman themed ones. It also replaces the Bobblehead stand in your home.
* More transparent Catgoogles patch: It replaces the default texture of the Catggogles with one that is still blue but a little more transparent.
* No Batman symbol patch: It replaces the default textures of the Batsuit and Batbelt with other textures that don't have the Batman symbol on them.
* Opaque Catgoogles patch: Fallout is not able to handle correctly two objects that are semi transparent and are placed one on top of the other. The default Catgoogles glasses are semitransparent, so if you hair uses also transparency and covers the Catgoogles, you may see how the glasses dissapear. This patch replaces the default Catgoogles with ones whose glasses are completely opaque.
* Silent sonar sound patch: If you don't want to hear the sonar ping that sounds when you activate Batman's Sonar Vision, install this patch that replaces the default sound with a silent one.


Description
===========
This mod adds the Batman suit from the film "The Dark Knight", my own version of Catwoman's suit and some Batarangs to Fallout 3.

The Batarangs come in two versions: a normal version and an explosive version.
The normal batarang can be repaired using other batarangs, any knife and any combat knife. You can also pick them up after having throwned them.

A Batfist (unarmed weapon) has also been added. It can be repaired using any of the batsuit and catsuit armour pieces, combat armours, Talon company armours, Ranger armours, Tenpenny Security armours and Rivet City Security armours.

Batman suit comes in five pieces:
* Batsuit (uses upperbody slot)
* Belt (uses bodyaddon1 slot)
* Cape (uses bodyaddon3 slot)
* Batsuit All Items: equips the Batsuit and the Belt at the same time (uses upperbpdy slot)
* Cowl (uses hair, hat and headband slots)

Catwoman suit comes in five pieces and two versions:
* Catsuit (uses upperbody slot)
* Catsuit - Open Jacket (uses upperbody slot)
* Belt (uses bodyaddon1 slot)
* Catsuit All Items: equips the catsuit and the Belt at the same time (uses upperbpdy slot)
* Catsuit All Items - Open Jacket: equips the Catsuit - Open Jacket and the Belt at the same time (uses upperbpdy slot)
* Backpack (uses backpack slot)
* Cowl (uses hair, hat and headband slots)
* Googles (uses eyeglasses slot)

Inlcuded are also 4 chokers with their matching earrings, for female characters.

You can repair all the batsuit and catsuit items using any of the items, combat armours, Talon company armours, Ranger armours, Tenpenny Security armours and Rivet City Security armours.

As the Batsuit and the Catsuit cover the whole body they are compatible with any body replacer you may use. The Open jacket version of the catsuit has been made for Dimon's Type 3 body and may look weird if you use other female body mod.

You can find all the items in an Enclave crate that is at the main entrance of Hubris Comics (see picture and this Hubris Comics for location) and in another crate that is in Rivet City Marketplace, just beside the motorbike at the top of the stairs. The crate contents should respawn after some days (usually 3 days).

FOSE functionality (optional)
=============================
From version 1.3 some optional FOSE funcionality has been added to the mod.

Toggle Sonar Vision, Night Vision and Eyes Sonar Effect using keys
------------------------------------------------------------
If you use FOSE, you can toggle the sonar vision and the sonar eyes effect of the Batcowl, and the night vision of the Catgoogles, on and off using hotkeys.

The default keys are:
.- B for Sonar Vision: press B to activate/deactivate Sonar vision when you have the Batcowl equipped.
.- B for Night Vision: press B to activate/deactivate Night vision when you have the Catgoogles equipped.
.- G for Sonar Eyes effect: press G to activate/deactivate Sonar vision when you have the Batcowl equipped.

Both keys are set in the mod as global variables so you can easily change the default hotkey to the one you prefer. "AsharaSonarVisionKey" is the variable that stores the hotkey used for switching Sonar vision on and off. "AsharaEyesEffectKey" is the variable that stores the hotkey used for switching Sonar vision on and off.

How to change the default hotkeys:
* To change the Sonar Vision and the Night Vision hotkey from B to another key use this console command: set AsharaSonarVisionKey to nn (where nn is the code of the new key according to this table: http://fose.silverlock.org/fose_command_doc.html#DirectX_Scancodes).
* To change the Sonar Eyes Effect hotkey from G to another key use this console command: set AsharaEyesEffectKey to nn (where nn is the code of the new key according to this table: http://fose.silverlock.org/fose_command_doc.html#DirectX_Scancodes).
* To see the current value of the global variables, type in the console: show AsharaSonarVisionKey (or show AsharaEyesEffectKey).

Gliding ability
---------------
From version 1.4, if you have FOSE installed and the Batcape equipped you can glide.

* To start gliding, press the J key.
* To move forward press the Arrow Up key.
* To change the direction of movement, just move the mouse to face the direction where you want to go. If you want to go up, look up, and if you want to go down, look down.
* To change speed of movement (increase or decrease), press the H key.
* To land either press the K key or get close to a place where you can land (e.g. the ground or the roof of a building).

You have to be in 3rd person mode to see the gliding animation.
You cannot fire a weapon when gliding.
In the DC don't try to go to another cell gliding, it is impossible (there is nowhere to go). You'll have to use the tunnels or the metro to change cells.
Be careful when landing on roofs, as some of them don't have good collision and you can get stuck or fall though the building when trying to land.

SAVE ALWAYS before gliding, just in case things go wrong.

The control keys are set using Global variables:
* Start Gliding: global AsharaJumpKey (default value J)
* Stop Gliding: global AsharaLandKey (default value K)
* Change speed (increase or decrease): AsharaFasterKey (default value H)
* Move Forward: AsharaForwardKey (default value Up arrow)

To change the value of the control keys use the console command:
* Set name_of_the_global to code_of_new_key
where name_of_the_global is the name of the global variable whose value you want to change and code_of_newkey is the numerical value of the key you want to assign to the global.
You can look up for the codes of the keyboard keys here: http://fose.silverlock.org/fose_command_doc.html#DirectX_Scancodes

To see the value of the control keys use the console command:
* Show name_of_the_global.


Required mods
=============
* Fallout latest official patch

If you want to use the FOSE funcionality (optional), you'll need FOSE.

For Batman and Catwoman suits no mod is required. As the suits cover the whole body they are compatible with any body replacer you may use.

Catwoman - Open Jacket suits have been made for Dimon's Type 3 body so you will require one of this mods:
* Dimon's DIMONIZED TYPE3 female body WIP
* Luchaire's Type V Female Body and Armor Replacer

Recommended mods
===================
* Quarn's ArchiveInvalidation Invalidated
If you have any problem with textures not loading correctly, use this utility from Quarn and everything will work fine.

* Timeslip's Fallout Mod Manager:
If you have any problem with textures not loading correctly, press the button Toggle Invalidation in FOMM and everything will work fine.

* Dimon's DIMONIZED Expiremental female small hands

* Stewb's Batcave

Install
=======
1. Extract the files of this mod to a temporary location (you can use 7zip, to unzip them) and chek the folder structure.
2. Copy to (install folder)\Fallout 3\Data\:
.- the AsharasBatmanItems.esp
.- the meshes folder
.- the textures folder
.- the sound folder
If asked if you want to overwrite existing files say "Yes to all".
3. Start Fallout 3 Launcher, click 'Data Files' and place a checkmark beside the .esp file.


Upgrade
=======
1. Extract the files of this mod to a temporary location (you can use 7zip, to unzip them) and chek the folder structure.
2. Copy to (install folder)\Fallout 3\Data\:
.- the AsharasBatmanItems.esp
.- the meshes folder
.- the textures folder
.- the sound folder
If asked if you want to overwrite existing files say "Yes to all".
3. Start Fallout 3 Launcher, click 'Data Files' and place a checkmark beside the .esp file.


Uninstall
=========
1. Start Fallout 3 Launcher, click Data Files, uncheck the .esp file(s).
2. Delete:
.- the AsharasBatmanItems.esp file, associated with the mod.
.- the folder \meshes\Ashara\Batman\ and its contents
.- the folder \textures\Ashara\Batman\ and its contents
.- the folder \sound\fx\Ashara\Batman\ and its contents


Incompatibility
===============
None that I am aware of. If you find any, please tell me.


Known Issues or Bugs
====================
None that I am aware of. If you find any, please tell me.


History
=======
2.3, 24-02-2010 - Fixed Catsuit - Open jacket statistics.Modified the speed script again: the effects of the change of speed are applied immediately and, if your intial speed was of 150 or lower taking the suits off will reset it to its vanilla value of 100.
2.2, 21-02-2010 - Fixed the Catgoogles' night vision script. Now you don't need to have the Catcowl equipped to activate the night vision.
2.1, 13-02-2010 - Modified the Speed script again: now it sets your speed multiplier to 150 if your speed is under that value and does nothing if it is already higher.
2.0, 11-02-2010 - Added Catwoman suits plus four sets of chokers and earrings. Made a female version of the Batcape. Fixed problem with distortion in the hands after gliding in 1st person view. Changed spread values of blade batarangs to improve their hitting chance when used in VATS. Increased Action points required in VATS for explosive batarangs from 12 to 18. Reduced health of blade batarangs to 1,000. Increased health of all armour pieces to 1,000. Added a new unarmed weapon: the Batfist. Modified the speed bonus: now, if you have speed of 100 or higher, it will add 75 units to your speed.
1.6, 04-01-201 - Fixed Batcape textures. Fixed damage for the Classic batarangs - explosive, that I unintentionally lowered in version 1.4. Now their damage statistics are the same as they were in previous versions.
1.5, 02-01-2010 - Added the TDK batarangs to the crate in Hubris comics. Added another crate to Rivet City Marketplace, just beside the motorbike at the top of the stairs.
1.4, 01-01-2010 - Added The Dark Knight Batarangs. Changed the explosion visual effect of the Classic Batarang - Explosive to the one used by the Pulse grenades (blue). Added Increase speed bonus to the Batsuit. Added gliding ability to the Batcape. The Batsuit - All Items does not equip the Batcape anymore.
1.3, 24-12-2009 - Added sonar sound. Added Sonar eyes effect. Added optional FOSE funcionality to toggle sonar vision and eyes effect on and off using hotkeys.
1.2, 13-12-2009 - Fixed the duplicated batarangs issue.
1.1, 11-12-2009 - Fixed 1st person batarang meshes. Changed the way you can pick up the normal batarang.
1.0, 11-12-2009 - Initial release.


Contact
=======
You can contact me leaving a comment at the mod's thread, sending me a PM or leaving a comment at the mod's thread at the official forum.


You can find me on TESNexus as SydneyB.
You can find me on Fallout3Nexus as SydneyB.
You can find me on the official Elder Scrolls forums as Ashara.
You can find me on Clan Dlan as Ashara.


Credits
=======
Thanks to Bethesda for creating Fallout 3.
Thanks to Skykappa for the Batarangs.
Thanks to The 3rd Type for the Batsuit pipboy icon.
Thanks to Skykappa and AndyW for helping me to fix the duplication of batarangs.
Thanks to Scanti for the Conformulator.
Thanks to Elminster for FO3Edit.
Thanks to tazpn for the kfupdater.
Thanks to Saltare for his flying script for Oblivion.
Thanks to Guerrero del Yermo for the reset animation.
Thanks to Kaw for the claws and thanks to Apachii and Loth DeBonneville for the original claws made for Oblivion.
Thanks to Xiamara for her Oblivion amulets that were the base of my Oblivion jewels which have been the base for the ones included here.
Thanks to Stweb for the idea of making Batman themed Bobbleheads.
Thanks to LHammonds for the Readme Generator this file was based on: .
Thanks to Fallout3Nexus.com for the a one-stop-shop resource for authors and players.
Thanks to all the modding community for all their tutorials, tools and help. Especially, thanks to the Clan Dlan and Bethesda Official Forum communities.
Thanks to all of you that are using this mod and are helping me to improve it with your suggestions.


Tools Used
==========
* Blender
* The Conformulator
* GIMP
* NifSkope
* G.E.C.K.
* FOSE
* FO3Edit
* Kfupdater
* 7zip
* Readme Generator


Licensing/Legal
===============
You can reuse any part of this mod into your own mod but all I ask in return is that you give me credit if you distribute any part of this mod.
If you are using the Batarangs, give credit to Skykappa, too.
If you are using the Batsuit pipboy icon, give credit to The 3rd Type, too.
If you are using the reset animation, give credit to Guerrero del Yermo, too.
If you are using the claws, give credit to Kaw, Apachii and Loth DeBonneville, too.
If you are using the chokers and earrings, give credit to Xiamara, too.