Name: Fore's New Idles for Skyrim
Version: 2.0
Date: 05/14/2012
Category: Animation Adding and Presenting
Requirements: -
Author(s): fore (fore06151@yahoo.com)
Source: http://www.skyrimnexus.com/downloads/file.php?id=11811
Video at: http://www.youtube.com/watch?v=cgG6QutxadE

___________________________________________________________________________________

[size=4]This mod allows you to [color=yellow] add and play new Idle Animations[/color][color="CDCCAA"] without having to deal with nasty work-arounds[/color], like replacing existing animations and creating temporary pseudo-races. It does this by [color="CDCCAA"]creating new animation slots in the Skyrim Behavior files[/color].[/size]

[color=orange][size=3]Update 2012-05-14: New Version V2.0[/size][/color]
[size=4][color=yellow]This is the first version which a truly seperate behavior file (FNIS_behavior.hkx)[/color][/size][list]
[*]Functionality separated into FNIS_behavior.hkx for maximum maintainability. Standard behavior files are minimally changed for a little hook in 0_master.hkx, and the list of all added animation files (defaultmale.hkx, defaultfemale.hkx).
[*]Added functionality for acyclic animations (400 slots)
[*]Added functionality for Animated Objects (100 cyclic, 100 acyclic)
[*]Added 400 more cyclic slots (800 total)
[*]Improvements: All animations stop the previous idle (no need to PlayIdle/cast only to stop the previous one), Head tracking disabled during animation, Blending between previous pose and current animation (0.6 sec) 
[*]FNIS Spells: added example animations for the new animation types
[/list]
[color=orange][size=4]When installing FNIS V2.0 make sure to delete Data/Meshes/actors/character/behaviors/[b]mt_behavior.hkx[/b][/size][/color]


This mod serves both gamers and modders.

[color=yellow]Gamers[/color] can use it to make NPCs [color="CDCCAA"]perform any standard or custom animation[/color] by simply copying the (.hkx) animation file under a pre-defined name into a special directory, and activate them by casting the FNIS spells. 
(Note: although there can be different NPCs performing different animations at one time, this mod does not provide any synchronization of these animations, as needed for example in somne adult type animation mods).

[color=yellow]Modders[/color] can use the [color="CDCCAA"]new animation slots[/color] to implement their own (behavior independant) animation invocation and synchronization.  

The animation slots are implemented by extending Beth's behavior files (which was only possible thanks to TheFigment aka TheHologram's amazing [url=http://skyrim.nexusmods.com/downloads/file.php?id=1797]hkxcmd[/url]). Because of the anti-modding structure of these behaviors, my mod will always be incompatible to all other mods which modify behaviors as well (none known as of today). To make 2 behavior modifying mods compatible, they have to be integrated into one set of behaviors.

[color="CDCCAA"]Currently this mod provides 1400 additional animation slots:[/color][list]
[*] FNISc0001 to FNISc800: 800 cyclic
[*] FNISa0001 to FNISa400: 400 acyclic (1-timer)
[*] FNISo0001 to FNISo100: 100 cyclic with AnimObject
[*] FNISb0001 to FNISb100: 100 acyclic with AnimObject[/list]
All AnimObject related slots ('o' and 'b' animations) assume that AnimObject are defined with CK. The AnimObject names have to match the animation: AnimObjectFNISo001 to AnimObjectFNISo100, and AnimObjectFNISb001 to AnimObjectFNISb100

FNIS animations can be used for all kind of simple animation tasks, (hopefully) including idle based combat overhauls like Oblivion's DR6 and CCAO. However due to the lack of necessary behavior information they cannot be used for regular combat animations.

[size=3][color=yellow]Slots used by the following mods:[/color][/size]
[list]
[*]c001 to c045 . . FNIS Idle Spells (part of this mod)
[*]c010 to c027 . . [url=http://skyrim.nexusmods.com/downloads/file.php?id=2658]Dance Animation for Modder[/url] by Umpa, SergeyWR (as part of this mod)
[*]c050 to c099 . . [url=http://skyrim.nexusmods.com/downloads/file.php?id=8714]Adult Show XXX[/url] by RainOfChaos, theru, Messenjah, Persacom (using)
[*]c200 to c230 . . [url=http://skyrim.nexusmods.com/downloads/file.php?id=6786]Forbidden Romance[/url] theroll, Don Juan (using)
[/list]

___________________________________________________________________________________
[size=3][color=yellow]Usage for GAMERS[/color][/size]

On start-up the player automatically receives [color="CDCCAA"]3 spells[/color]:
[list]
[*][color="CDCCAA"]FNIS Spell Selector[/color]: This (self) spell allows you to select 1 of 72 Idle Animation which will be used for successive Idle Spells (NPC or player). By installation, most of these animations are pre-set with standard animations, but it also includes all 17 of Umpa's [url=http://skyrim.nexusmods.com/downloads/file.php?id=2658]Dance Animation for Modder[/url] at slots C10 to C26.
See "Installation" on how to change these files with animations of your choice.

[*][color="CDCCAA"]FNIS NPC Idles[/color]: This (target) spell makes the casted NPC perform the selected idle. On standing NPCs the idle will run until you interrupt by casting again. But (unfortunately), because the animation slots are fully integrated into the behavior files, the animation will be also interrupted by other standard animation event's of the NPC's animation schedule. 

[*][color="CDCCAA"]FNIS Player Idles[/color]: This (self) spell forces the player into 3rd person and makes her perform the selected idle. The will run until you interrupt, e.g. by jumping up (space bar).
[/list]


___________________________________________________________________________________
[size=3][color=yellow]Usage for MODDERS[/color][/size]

Simply [color="CDCCAA"]copy your animations into the "animation/FNIS" folder, using the predefined names (see above)[/color]
and call your idles with PlayIdle() by using the corresponding anim events (e.g. zFNISc051 for animation FNISc051).

PLEASE DO NOT USE RESERVED SLOTS (see above). I will gladly reserve the slots you need for your mod, and will add new slots to FNIS, if necessary.

Please keep in mind that you will interfere wih all other modders that use the same animation names. In the long run I have plans for a managing utility, which generates a wrapper layer around FNIS, based on the user's mod list.


___________________________________________________________________________________
[size=3][color=yellow]Known Restrictions and Incompatibilities[/color][/size]

[list]
[*][color=orange][size=3]This mod is incompatible with every other mod which modifies the same behavior files 0_master.hkx, defaultmale.hkx, and defaultfemale.hkx. In particular FNIS is incompatible with 
- Animated Prostitution - Skyrim (AP)
- Joshs Skyrim Behavior File Patcher[/size][/color] 

[*]The FNIS Idle Spell work in most situations. Some walking NPCs will just continue their way after a short interlude. So will most NPCs standing, leaning or sitting in dedicated places. I have implemented a 10-quest/quest idle management to make most casts successful. But there are still misses due to specific situations. To make these work it would be necessary to implement rather complicated packages (based on scenes). But I didn't think it's really worth this effort. 

[*]It's a little tricky to end the player's idles. Reason is that the CK doesn't provide an event for hitting a key (for interruption). The easiest way to end a player idle is to use space to jump up, then toggle to 1st to re-gain casting ability. Note: this spell DOES NOT change your standard idle(s). It only makes the the player character play the idle until you interrupt.
[/list]


___________________________________________________________________________________
[size=3][color=yellow]Required & Recommended Mods/Tools[/color][/size]

None required


___________________________________________________________________________________
[size=3][color=yellow]INSTALLATION[/color][/size]

Uninstall any previous FNIS version. In particular, [color=orange][size=4]make sure that Data/Meshes/actors/character/behaviors/[b]mt_behavior.hkx[/b] is removed[/size][/color]

Install the files as usual, either using NMM, or with manual installation

There are 2 seperate uploads coming with the mod:

[list]
[*][color="CDCCAA"]FNIS Behavior Files[/color]. Required. Replaces 3 original behavior files (0_master.hkx, defaultmale.hkx, defaultfemale.hkx) and adds an additional one (FNIS_behavior.hkx)
- Install files 
[*][color="CDCCAA"]FNIS Idle Spells[/color]. Optional (if you want to use described FNIS spells)
- Install files 
- Activate FNISspell.esp
[/list]

If you want to play your own animations, you can simply replace the files in meshes\actors\character\animations\FNIS by your own files (but unless you want to change the scripts, YOU HAVE TO USE EXACTLY THE SAME NAMES):
[list]
[*]FNISc001.hkx to FNISc045.hkx (for cyclic animations)
[*]FNISa001.hkx to FNISa009.hkx (for acyclic animations)
[*]FNISo001.hkx to FNISo009.hkx (for cyclic animations using AnimObjects)
[*]FNISb001.hkx to FNISb009.hkx (for acyclic animations using AnimObjects)
[/list]
If you change AnimObject ('o' or 'b') animations, you should also change the corresponding AnimObjects in meshes\AnimObjects\FNIS


[color=yellow]Uninstall[/color]

Uninstall with NMM, or manually delete
[list]
[*]Data/Meshes/actors/character/behaviors/0_master.hkx
[*]Data/Meshes/actors/character/behaviors/FNIS_behavior.hkx
[*]Data/Meshes/actors/character/characters/defaultmale.hkx
[*]Data/Meshes/actors/character/characters female/defaultfemale.hkx
[*]Data/FNISspell.esp
[*]Data/Meshes/actors/character/animations/FNIS
[*]Data/Meshes/AnimObjects/FNIS
[*]Scripts/FNIS*.* and Scripts/Sources/FNIS*.*
[/list]

___________________________________________________________________________________
[size=3][color=yellow]History[/color][/size]

2012/03/01 V1.0 . . Initial Relase
2012/03/18 V1.1 . . (Idle spells only) 
. . . . . . . . . . . Added player spell, increased to 45 idles
. . . . . . . . . . . New PlayIdle concept, which allows to cast more NPCs (although still not all NPCs in all situations)
2012/03/21 V1.5 . . Adapted Behavior Files and Idle Spells to Skyrim 1.5
2012/05/14 V2.0 . . Moved all FNIS Behavior funvtionality into a seperate file (FNIS_behavior.hkx)
. . . . . . . . . . . Added functionality for acyclic, cyclic AnimObject, and acyclic AnimObject. Added 400 cyclic slots.

___________________________________________________________________________________
[size=3][color=yellow]Credits[/color][/size]

TheFigment aka The Hologram for his invaluable [url=http://skyrim.nexusmods.com/downloads/file.php?id=1797]hkxcmd[/url]
Umpa for his [url=http://skyrim.nexusmods.com/downloads/file.php?id=2658]Dance Animation for Modder[/url]


___________________________________________________________________________________
[size=3][color=yellow]Future Plans[/color][/size]

[list]
[*]Furniture Idles
[*]Paired Animations (although I falied to make them in earlier weeks, but maybe with increasing experience ...)
[/list]


___________________________________________________________________________________
[size=3][color=yellow]Licensing/Legal[/color][/size]

[size=4]The [color=orange]FNIS Behavior Files[/color] can only be downloaded and used in the described way. Without my express permission you are NOT ALLOWED[/size][list]
[*][size=4]to upload contents of the FNIS Behavior Files TO ANY OTHER SITE[/size]
[*][size=4]to distribute contents of the FNIS Behavior Files as part of another mod[/size]
[*][size=4]to distribute modified versions of the FNIS Behavior Files[/size]
[*][size=4]to distribute tools which can generate modified versions of the FNIS Behavior Files[/size][/list]

With the [color=orange]FNIS Idle Spells[/color] you can do whatever you want. Simply inform me when you include it into your mod.
