Version: 0.704
Date: 10 July 2013
Author: kuertee
Source: http://skyrim.nexusmods.com/mods/27452/
Requirements:

• Skyrim 1.9
• Skyrim Script Extender http://skse.silverlock.org/
• The [camera] section in your Skyrim.INI exists when Custom 3rd-person camera positions features is used.
  

Compatibility

• When used with another 3rd-person camera mod, set userChange3rdPersonCameraPos to False so that my mod's 3rd-person camera changes are disabled.
  

Automatically switches to your preferred view depending on these conditions: bow is drawn, ranged weapon is out, spell or staff is out, melee weapon is out, sprinting, sneaking, in interior or otherwise.

0.704, 10 July 2013:
• New feature: You can set your preferred view for when swimming.
• Tweak: You can now change user settings before the main quest is at stage 5 (e.g. before leaving Helgen).
  

• Simply deactivate and uninstall the previous version then install and activate this version. Note that you do not need to stop the mod in-game. If you do, you will lose your accumulated mod-specific data. Let the new version back-up the data of its old version, clean-up the old data (i.e. zero-out) by stopping itself, restart itself and restore the data of the old version.
• If you have Sky UI's MCM, you can check the settings in Sky UI's MCM wihtin the game.
• Or check the settings in "Data\Ini\kuerteeAutoFirstThirdPersonView.ini". If you change any of it, execute your changes by typing {bat "ini\kuerteeAutoFirstThirdPersonView.ini"} (without the brackets) in the console.
• After the update is finished, the message "kuAFTPV v0.704" will appear.
  
  

Auto-point-of-view

Unlike the Oblivion version (http://oblivion.nexusmods.com/mods/21834/) of this mod, this version doesn't learn your preferences from use. It will use the defaults. Or you'll need to specify the point-of-views for each condition manually in MCM, in the console or via the INI file. Remember that you need to execute the INI before its changes take effect. Read the Install section if you need more information on this. However, most other features of the Oblivion version is present in this Skyrim version.

When any of these conditions change, the mod will automatically press the Switch Point-Of-View button to put your view into your preferred point-of-view as listed in the INI.

The order of conditions and their default point-of-views are:
In dialogue: 1st-person
Torch is out: 1st
Bow is drawn: 1st-person
Range weapon is out, ranged weapon is out indoors: 3rd-person
Spell/Staff is out, spell/staff is out indoors: 1st
Melee weapon is out, melee weapon is out indoors: 3rd
Sneaking: 1st
Sprinting: 3rd
Swimming: 1st
In interiors: 1st
Otherwise: 3rd

You can temporarily switch to the other point-of-view and the mod will keep this view until it detects another required change. For example: Your melee weapon is out and the mod puts your view into 1st-person - but for this one fight, you'd rather that it is in 3rd-person. Manually switch your view and the mod will keep on the 3rd-person view until it detects another required change. Putting your weapon away or switching to a new weapon will trigger the required change. And so the mod will go through each condition and choose the new point-of-view.

The mod will also return the 3rd-person view to it's previous distance from the player. However, some game events will return this distance to its default. Examples of these events are vampire feeding and using a crafting station.

Note that when the game takes control of the camera (e.g. during kill-views, when on a horse or when using a crafting station), this mod pauses itself and leaves the game to control the camera. It'll take control of the camera again after the game releases its control.

Custom 3rd-person camera positions

By default, this is enabled. Turn off userChange3rdPersonCameraPos in the console, INI or in the MCM to disable this feature. This feature changes the 3rd-person camera's X and Z positions and Y combat modification for these conditions: no weapons equipped, with a spell ready while standing, with a spell ready while sneaking, with a melee weapon while standing, with a melee weapon while sneaking, with a ranged weapon while standing and with a ranged weapon while sneaking - in that order of priority. Also, this feature requires that the [camera] section exists in your Skyrim.INI file. Simply add it in if it doesn't exist.

Note that because the 3rd-person camera changes only when you change your equipped weapons (i.e. it does not change when the mod changes any of these variables), going to and from sneak mode without changing your equipped weapons will not change the 3rd-person camera's position. I've already requested a function from the SKSE developers to address this.

Also note that these changes are not written into the Skyrim.INI file. Uninstalling this mod (or turning off this feature), will restore your original 3rd-person camera positions.

Turn this feature off when playing with another 3rd-person camera mod.



You can configure this mod with SkyUI's MCM or in the Console by typing "SetPQV kuAFTPVq {mod data} {value}". Below are the various mod data that you can change, their default values and a short description of their effects.

The allowable values are:
-1: don't check against this condition
0: 3rd-person-view
100: 1st-person-view
(Note that the score range from 0 to 100 range was to be used in scoring your changes in the different conditions. This will allow the mod to learn what you use. However, this is currently disabled.)

userWhenInDialogue = 100
When in dialogue.

userWhenRangedWeaponStart = 100
When you pull on your bow.

userWhenRangedWeaponDrawn = 0
userWhenRangedWeaponDrawnIndoors = 0
When you have a ranged weapon out.

userWhenSpellDrawn = 100
userWhenSpellDrawnIndoors = 100
When you have a spell or staff out.

userWhenMeleeWeaponDrawn = 0
userWhenMeleeWeaponDrawnIndoors = 0
When you have a melee weapon out.

userIgnoreLeftHand = False
userIgnoreRightHand = False
When set to true, the mod ignores changes to the hand, allowing you to change equipped items without changing the camera.

userWhenSprinting = 0
When sprinting.

userWhenSneaking = 0
When sneaking.

userWhenInInterior = 100
When you're in an interior cell.

userWhenOtherwise = 0
When no other conditions are met.

userSnapTo1st = False
When true, the camera doesn't transition in to 1st-person view. When false, it does. Note that when true, there are some cases when this will force 3rd-person view to snap also.

userSnapTo3rd = False
When true, the camera doesn't transition out to 3rd-person view. When false, it does. Note that when true, the camera snaps back to the default distance for the 3rd-person view. It is recommended that this is kept at false. However, there are times when the game takes control of the camera and snaps it to 3rd-person view. When this happens, the 3rd-person camera returns to its default distance. An example of this is when the game takes control of the camera during feeding as a vampire.

userChange3rdPersonCameraPos = True
When true, the position of the 3rd-person camera will change in these conditions: no weapons equipped, with a melee weapon while standing, with a melee weapon while sneaking, with a ranged weapon while standing, with a ranged weapon while sneaking, with a spell ready while standing and with a spell ready while sneaking. Turn this feature off when playing with another 3rd-person camera mod.

userCameraPosWhenNoWeaponsX = 30, userCameraPosWhenNoWeaponsY = 0, userCameraPosWhenNoWeaponsZ = -10
userCameraPosWhenMeleeWeaponDrawnX = 0, userCameraPosWhenMeleeWeaponDrawnY = -100, userCameraPosWhenMeleeWeaponDrawnZ = 20
userCameraPosWhenMeleeWeaponDrawnX2 = 0, userCameraPosWhenMeleeWeaponDrawnY2 = -100, userCameraPosWhenMeleeWeaponDrawnZ2 = 20
userCameraPosWhenSpellDrawnX = 0, userCameraPosWhenSpellDrawnY = -100, userCameraPosWhenSpellDrawnZ = 20
userCameraPosWhenSpellDrawnX2 = 0, userCameraPosWhenSpellDrawnY2 = -100, userCameraPosWhenSpellDrawnZ2 = 20
userCameraPosWhenRangeWeaponDrawnX = 0, userCameraPosWhenRangeWeaponDrawnY = -100, userCameraPosWhenRangeWeaponDrawnZ = 20
userCameraPosWhenRangeWeaponDrawnX2 = 0, userCameraPosWhenRangeWeaponDrawnY2 = -100, userCameraPosWhenRangeWeaponDrawnZ2 = 20
These are the 3rd-person camera's custom positions. Note that for weapon drawn camera positions the first 3 numbers are for when you are standing and the next 3 are for when you are sneaking. The values above are the game's default 3rd-person camera position. When you first install the mod, the mod will take these values from your Skyrim.INI - in case you've already customised the 3rd-person camera positions.

userCommit3rdPersonCameraPosNow = False
Set to True after changing any of the camera positions. The values will then be inserted into their appropriate Array properties.

A configuration file (data\ini\kuerteeAutoFirstThirdPersonView.ini) is provided with the relevant console commands. If you want to change any of the default values above, change them in the INI file then run the file by typing {bat "ini\kuerteeAutoFirstThirdPersonView.ini"} (without the brackets) in the console. You only need to do this when you want to change the values of the property. Your changes will be saved in your game.

• Use Wrye Bash (http://skyrim.nexusmods.com/downloads/file.php?id=1840) to install this mod. Just drag the package (which is a normal ZIP file) into Wrye Bash's Installers tab. However, the package is only a normal ZIP file, so if you know the game's mod file structure, install it manually.
• Change your settings within the game in Sky UI's MCM or check the settings in "Data\Ini\". If you change any of it, execute your changes by typing in the console {bat "ini\kuerteeAutoFirstThirdPersonView.ini"} without the brackets.
• Activate the mod.
  
  

• In the console, type "SetPQV kuAFTPVQ uninstallNow True." Or with Sky UI's MCM, set the uninstallNow toggle to True then exit the menus.
• Wait for a message confirming the uninstallation. Save the game.
• Deactivate the mod with Wrye Bash. If you installed this manually, simply delete all the files you installed. (Wrye Bash keeps track of files used, so installing/uninstalling the mod with it is 100% simpler.)
  
  

• You can reset the mod by typing {SetPQV kuAFTPVQ resetNow True} (without the brackets) in the console. Or with Sky UI's MCM, set the resetNow toggle to True then exit the menus.
• When it resets it will ask you either reset all of its data or continue with the current data. Resetting all its data will remove all your configurations and set the mod as if you have first installed it.
• You can check all the mod's data by typing {SQV kuAFTPVQ} in the console. You can check if your configurations were set in the mod properly with this.
• If you find that your changes (with the command SetPQV or from executing the INI) does not appear in the mod, check the command again for spelling errors. Then try again.
• If you find that resetting (with resetNow) and uninstalling (with uninstallNow) don't seem to work, the mod may have been suspended. It is best to simply start-over (i.e. reinstall the mod) after a "clean" save.
• Creating a clean save:
  
  • If you can uninstall the mod from the console with {SetPQV kuAFTPVQ uninstallNow True}.
  • Wait for the mod to confirm the uninstallation. It may take a minute. If no confirmation appears, then simply continue to the next step.
  • Save the game manually from the console by typing {save uninstalledMod}.
  • Uninstall all the mod's files (*.ESP, *.PSC, *.PEX) from the game folders. Make sure that none of the mod's Scripts are left. A mod manager like Wrye is best used for this.
  • Load the "uninstalledMod" save.
  • Save the game manually again from the console by typing {save cleanSave}. Because all of the mod's files were removed, all of its data will be "zeroed" in this game.
  • Play from this game.
    
    

As a last resort, you can also enable script logging and investigate it and/or send it to me. Contact me first either on TESNexus or the official Bethesda forums. To enable script logging, read this thread from the official Bethesda Creation Kit Forum: http://forums.bethsoft.com/topic/1345130-having-papyrus-trouble-here-are-some-things-to-try/.

[size=7]History[/size]

0.703, 2 July 2013:
• Bug fix: Fixes to the MCM's ping-back code - again. This will be the last time this bug will resurface - I hope. I found another instance when the RegisterForModEvent () for the ping-back is not registered or loses its registration in the previous version.
  0.702, 30 June 2013:
• Bug fix: Fixes to the MCM's ping-back code - again.
  0.701, 16 June 2013
• Tweak: When the MCM "pings" the main mod (to check if it has not stalled), it will wait for the "ping-back" for 60 seconds. Previously this was 10 seconds. In normal play, the ping-back only takes a fraction of a second. But during initialisation on a clean install or an update to a new version, the main mod would not have been set-up to listen for the ping from the MCM yet - which causes the MCM's ping-back test to fail and then presenting it's "stalled message". In this version, I've increased the time the MCM waits for the ping-back to 60 seconds.
  0.7, 14 June 2013:
• Tweak: Now uses SKSE's Game.UpdateThirdPerson () to automatically update the camera position in third-person view. Previously, the camera had the default game's behaviour of updating only when your weapon changes between melee weapons and ranged weapons. In this version (with Game.UpdateThirdperson ()), the third-person camera position changes when you change your equipped weapon or spell or when you enter and leave sneak mode.
• Tweak: The main package and the MCM can now be merged manually (with TES5Edit). Removing the reliance on GetFormFromFile () from the MCM discovery code made this possible. In this new version, SendModEvent () is used by the main package and the MCM to "ping" each other.
  0.632, 30 April 2013:
• Bug fix: Cancelling a bow attack now triggers the camera to change.
  0.631, 7 April 2013:
• Tweak: Recompiled the main mod with Skyrim's 1.9 patch and the MCM component with SkyUI's 3.4 patch.
• New version: Crossbow support.
• New version: Custom 3rd-person camera positions. By default, this is enabled. Turn off userChange3rdPersonCameraPos in the console, INI or in the MCM to disable this feature. This feature changes the 3rd-person camera's X and Z positions and Y combat modification for these conditions: no weapons equipped, with a spell ready while standing, with a spell ready while sneaking, with a melee weapon while standing, with a melee weapon while sneaking, with a ranged weapon while standing and with a ranged weapon while sneaking - in that order of priority. Also, this feature requires that the [camera] section exists in your Skyrim.INI file. Simply add it in if it doesn't exist. Turn this feature off when playing with another 3rd-person camera mod. Note that because the 3rd-person camera changes only when you change your equipped weapons (i.e. it does not change when the mod changes any of these variables), going to and from sneak mode without changing your equipped weapons will not change the 3rd-person camera's position. I've already requested a function from the SKSE developers to address this. Also note that these changes are not written into the Skyrim.INI file. Uninstalling this mod (or turning off this feature), will restore your original 3rd-person camera positions.
• Compatibility: Previously, when in a special form (e.g. Vampire Lord or Werewolf), the script failed. It resumed when the player reverted back.
  0.628, 12 February 2013:
• Tweak: When you override the mod (by pressing the Toggle View button), it will now be cancelled by changes of any condition. Previously, it changed only when a higher-priority condition than what the camera was set for changed. E.g. Previously, when you have a weapon out and you override the mod, the mod will not take control of the camera until you sheathe your weapon. So you can go into sneak or go in/outdoors, and the camera will not change. This is because having a weapon out has a high priority over the movement conditions (e.g. being on a horse, sprinting, sneaking) and location conditions (e.g. indoors, outdoors). In this version, changes to any conditions will make the mod cancel your override. When you have a weapon out and you override the mod, simply going in/outdoors or going into sneak will cancel your override.
• Tweak: Made the sneaking condition have a higher priority over the other movement condition. This allows you to do the Silent Roll without the camera switching to your sprinting view preference.
• Tweak: Returned the 3-second buffer between between changes. In the previous version, I set this to 1 to try to get the mod to respond quicker to changing conditions. It caused some problems.
• Bug fix: The mod shouldn't do a double-take anymore. A double-take is when the mod will change the camera incorrectly then change it back soon after.
  0.627, 2 January 2013:
• New features: userWhenRangedWhenDrawnIndoors = 3rd (default), userWhenSpellDrawnIndoors = 1st (default), userWhenMeleeWeaponDrawnIndoors = 3rd (default). These equipped item conditions are applied when indoors. Set to -1 to disable.
• New features: userIgnoreLeftHand = False (default), userIgnoreRightHand = False (default). When set to true, the mod ignores changes to the hand, allowing you to change equipped items without changing the camera.
• New feature: SkyUI's MCM (Mod Config Menu) support. The configuration tool is a separate download from my mod's Nexus files section. It requires Sky UI's beta 3 version or better which can be downloaded from Sky UI's thread in Bethesda's official Skyrim mods forum: http://forums.bethsoft.com/forum/183-skyrim-mods/
  <!--
• New feature: Vampire feeding unsticker. Uses playerRef.PlayIdle (IdleStop_Loose) near the end of each feeding animation to force the player back to the "idle" state.-->
• Bug fix: Will try to prevent a double camera switch which used to occur when conditions change rapidly.
  0.624, 16 December 2012
• New feature: userSnapTo1st and userSnapTo3rd. By default, these are false. When true, the camera will snap to position instead of zooming in/out. There are some cases when userSnapTo1st, when true, will also force 3rd-person view to snap. When true, the camera transitions out to 3rd-person view. When false, it does. Note that when true, the camera snaps back to the default distance for the 3rd-person view. It is recommended that this is kept at false. However, there are times when the game takes control of the camera and snaps it to 3rd-person view. When this happens, the 3rd-person camera returns to its default distance. An example of this is when the game takes control of the camera during feeding as a vampire.
• Bug-fix: Reworked the in dialogue detection to use SKSE's OnMenuOpen ("Dialogue Menu"). Previously, the mod searched for nearby NPCs with a Cloak Spell and checked each NPC with IsInDialogueWithPlayer (). This was so the mod can specifically target the NPC. However, using this method had bugs like affecting brawlers and when training with Vilkas at the start of the Companions Quest. Checking for the Dialogue Menu being open is safer. Thanks to Corvyr for finding this bug.
• Tweak: The mod now queries the Switch POV key at every iteration - in case the user changes it's binding after mod installation. Previously, this was only performed at the initialisation of the mod.
• Tweak: Faster response of camera switches between drawing the bow and releasing the bow.
  0.619, 5 December 2012
• Bug fix: In previous versions, the in-dialogue feature stopped working after the first game-load.
• New feature: Holding torches now trigger a camera change. By default, this sets the camera to 1st-person view. Change userWhenHoldingTorch in the INI or on the console to change your preference.
• Tweak: Rebuilt the NPC in dialogue with player check. It now doesn't attach a Ability/Script to each NPC like before.
• Bug fix: The temporary manual switch of POV wasn't working. Fixed in this version. As a reminder: this feature lets you switch the POV - albeit only temporarily. The POV you switch to sticks until the mod detects a new condition to switch the camera to.
• Tweak: Removed the internal code for OnMenuMode since it is not required.
  0.616, 29 November 2012:
• New feature: Dialogue view. By default this is set to 1st-person view.
• Bug fix: The mod was getting prevented in switching to the correct view after putting your weapon away sometimes.
  0.614, 27 Novmeber 2012:
• Initial release.
  

[size=7]Credits[/size]

kuertee in http://www.bethsoft.com/bgsforums/

[size=7]Tools Used[/size]

Creation kit - http://www.creationkit.com

[size=7]Licensing/Legal[/size]

You can do whatever you want with this mod but all I ask in return is that you give me credit. I would also like to be contacted when you include this mod in part or in full in a public release.