Name: Co-opOblivion
Version: 0.9
Date: 9/9/2011
Category:
Requirements: Oblivion Patch 1.1.511, Shivering Isles Patch 1.2.0.201, Oblivion Patch 1.2.0.214, Oblivion Patch 1.2.0.416, Oblivion Script Extender (OBSE)
Author(s): Melkiah
Source: http://www.tesnexus.com/downloads/file.php?id=8440

Description
===========
This mod enables two players to play Oblivion as two separate characters in the manner of Baldur�s Gate I and II (console versions)

Location
========
The recruit and start spells are added to the player once the mod starts.


Install
=======
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 Oblivion Launcher, click 'Data Files', place a checkmark beside the .esp file(s).

Uninstall
=========
1. Start Oblivion Launcher, click Data Files, uncheck the .esp file(s).
2. Delete the files/folders associated with the mod.
3. Delete the Co-op Mod folder from the Oblivion/Data/Meshes/ directory.

Details
=======
This mod is currently at the BETA stage. Please report all bugs/problems/suggestions as clearly as possible in the comments page.

OBSE 20 or higher is required to use.

Both player characters can:
Use Blade/Blunt/Marksman weapons. Blade, Blunt and Hand to Hand power attacks can be done by holding the attack button.
Cast Self/Touch/Target spells
Jump
Open doors - load and animated
Loot dead bodies
Talk to npcs
Lockpick doors and containers
Access individual inventory, spell and stats screens
Set up and use shortcut keys (up to 6 shortcuts for player 1 and 4 shortcuts for player 2)
Buy and sell items and spells from shops independently (i.e. if player 2 buys a spell it will only appear in their spell list)
Ducking/sneaking work but not (yet) for pickpocketing and stealth hitting
Give items and gold directly to each other.


Starting and Stopping Co-op mode:
To start cast the Recruit Player 2 spell on the npc you would like to be player 2.
Currently any friendly npc can be recruited as player 2's character. To un-recruit them cast the spell on them again.
Then (in a clear area) cast the Start Co-op Mode spell.
To exit Co-op mode at any time press BACKSPACE. Player 2's character will revert to following player 1.


Features:

Attack Damage
Blade, Blunt, Hand to Hand and Arrow damage are calculated using a close approximation of the games standard formulae. In other words the damage your character does directly relates to your weapon, attribute and skill values.

Target Lock.
To assist with casting spells and firing bows use the Target Lock function. If they are fired without target lock they will fire directly ahead of the player character on a flat trajectory.
When the Target Lock button is pressed the targeted npc will briefly flash red (for player 1) and blue (for player 2)
The player character will now move relative to the targeted npc. If close enough all blade, blunt and hand to hand attacks will hit the target.
Arrows and Target spells will fire at the targeted npc.
Touch spells can only be used with Target Lock.
Press the target lock button again to switch off target lock. Target Lock will automatically switch off if the targeted npc dies.
Target Lock won?t target the other co-op player character to do this press the Target Other Player button. Targeting the other player enables you to cast Touch spells on them as well as damage them with melee attacks.

Friendly hits:
Unless a Player is targeted by their co-op partner they will not take melee hits from them. Arrows and targeted spells will damage them as normal.

Activating:
To activate a door, npc or a container walk up to them, face them with your character and press the Activate button. Unfortunately this (currently) won?t work for containers that are lower than the player characters chest level. Crouching helps does help in some situations.

Camera:
IMPORTANT - the camera will be jerky if the player is in third person view - change to first person.
The camera is intended to focus on a point between the two players.
The camera will move back the further apart the players move from each other - I haven?t set a limit to how far apart they can go.
Moving the mouse left and right will swing the camera around the players.
Pressing up/down/left/right on the arrow keys moves the camera up/down and further away/closer. The angle is still controlled by mouse.
Pressing Right Control will revert the camera height and distance to the mod?s default settings.
Pressing Right Shift will switch follow cam on/off
Whilst in interiors the camera will be closer and lower.

Getting knocked down
In Co-op mode both player characters are essential so cannot be killed only knocked unconscious. However if both players are knocked unconscious then the real player 1 will die.


Controls:

This mod has been designed for keyboards which have a number pad on the right hand side (see the control layout picture). If you plug a second USB keyboard into your PC it should enable each player to use a separate keyboard. This should also works with extra mice.

Player 1 (this is the original player)
I have attempted to keep these controls close to the default Oblivion settings.

Walk/Run Up - W
Walk/Run Down - S
Walk/Run Left - A
Walk/Run Right - D
Toggle Walk/Run - R
Jump - SPACE BAR
Open Inventory/Stats screens - I
Attack - E
Draw/Sheath weapon - F
Cast spell - Q
Activate (Door/NPC/Container) - C
Target Lock On/Off - LEFT TAB
Target Other Player - V
Toggle Sneak - LEFT CONTROL
Shortcut 1 - 1
Shortcut 2 - 2
Shortcut 3 - 3
Shortcut 4 - 4
Shortcut 5 - 5
Shortcut 6 - 6
Give Items to other Player - G

Player 2:
Walk/Run Up - NUMBER PAD 8
Walk/Run Down - NUMBER PAD 5
Walk/Run Left - NUMBER PAD 4
Walk/Run Right - NUMBER PAD 6
Toggle Walk/Run - NUMBER PAD /
Jump - NUMBER PAD ENTER
Open Inventory/Stats screens - NUMBER PAD *
Attack - NUMBER PAD +
Draw/Sheath weapon - NUMBER PAD 9
Cast spell - NUMBER PAD 7
Activate (Door/NPC/Container) ? NUMBER PAD DEL
Target Lock On/Off - NUMBER PAD -
Target Other Player - NUMBER PAD 3
Toggle Sneak - NUMBER PAD 1
Shortcut 1 - HOME KEY
Shortcut 2 - END KEY
Shortcut 3 - PAGE UP
Shortcut 4 - PAGE DOWN
Give Items to other Player - NUMBER PAD 2

Camera:
Move camera up - ARROW KEY UP
Move Camera Down - ARROW KEY DOWN
Move Camera Closer - ARROW KEY LEFT
Move Camera Away - ARROW KEY RIGHT
Revert camera height and distance to default - RIGHT CONTROL
Switch Follow mode On/Off - RIGHT SHIFT


Elements to be implemented:
Blocking (and being affected by an enemy blocking)
Ability to pick up inventory items from the floor (swords/shields etc)
Ability to interact with all doors, containers and switches.
Create an ini file so that player controls can be customised
Riding horses.
Power attacks using bows.
Ability to use staffs.
Improving the target Lock function and adding ability to cycle through targets
Enable hits whilst sneaking/undetected to do more damage
Enable wait function.
Prevent the player characters from equipping their own items after loading.
Include experience increases for player 1 - so when you hit an enemy with a sword you also increase your Blade xp.

Known bugs:
For a second or two after starting co-op mode or moving through a load door the player characters may not move. They will respond shortly afterwards.
Unable to open animated Oblivion realm tower doors.
Unable to open most containers.
It is possible to jump through solid objects/Walls - use caution
Unable to open some load doors - particularly imperial city doors.
If co-op mode is started close to a wall then player 1 may appear in the wrong place.
Swimming tends to cause the player characters to get stuck on the surface of the water. If this happens press BACKSPACE to revert to one player mode.
Sometimes when a player is knocked unconscious they don?t fall to the ground and they may also slide away.
Entering Pillaged Mine (west of Chorrol) can cause the characters to stop responding but pressing BACKSPACE will still revert to one player mode. If you encounter this problem elsewhere please let me know.


Tips:
As with any mod save before installing it and save regularly whilst running it.

Bear in mind that whilst you can recruit any npc to be Player 2 some situations may require certain npcs to do specific things - for example if you recruit the Emperor in the starting dungeon then scripted events may not occur correctly.

In most situations where you have encountered a problem pressing BACKSPACE should revert you to one player mode.



Incompatibility
===============
This mod is likely to be incompatible with other mods that add extra functions to the keyboard keys.


Contact
=======
You can find me on TESNexus as 'Melkiah'


Credits
=======
Bethesda
Elder Scrolls Construction Set wiki
The Unofficial Elder Scrolls Pages wiki
Tesnexus
The makers of OBSE
Chainsaw for ideas and artwork
Boilingover for ideas and game testing assistance
Thanks to LHammonds for the Readme Generator this file was based on.


Tools Used
==========
7-Zip - http://www.tesnexus.com/downloads/file.php?id=15579
NIFSkope - http://niftools.sourceforge.net/wiki/NifSkope
Oblivion Script Extender (OBSE) - http://obse.silverlock.org/
TES Construction Set - http://www.tesnexus.com/downloads/file.php?id=11367
Readme Generator - http://HammondsLegacy.com/obmm/tools_readme_generator1.asp

Licensing/Legal
===============
You can do whatever you want with this mod but all I ask in return is that
you give me credit if you distribute any part of this mod.