About This File
Heya all, so here it is! The much-requested Multi-NPC support for ZAP Furniture Placer.
v2.01 Released with minor bugfix! Please update your install! (will not cause issues to saved games)
v2.02b released with (beta) support for multi-npc furniture (such as vampire supply). See changelog notes.
This will probably be the final release for now unless a game-breaking critical error is found.
Now compatible with Paradise Halls! Furniture will stop slaves escaping - use 2.02b + 2.02b Compatibility Patch! 
Bug hotfixes: (both versions): -Fixed error of ZFPStartup not running on a new game/install (Player spells now get added correctly on new game)
-Removed leftover Iona (RIften Housecarl) records in the .esp file (should fix broken custom housecarl races)
-missing ZFPMenuScript masterscript fixed, Placement menu now places items from list 6 correctly.
EXTENSION FEATURES:
-NPC support to lock up to 60 NPCs into the various items of furniture from ZAP 8.0 (Also tested on and compatible with ZAP 8.0+)
-10 Selectable NPC slots with immersive dialogue and animations
-50 Locked NPC slots (Assigned from the Selectable slots or by grabbing random NPCs off the street with magic ?)
-6 new control spells to help manage the various locked NPCs. (11 spells in total now).
Requirements:
ZaZ Animations Pack 8.0 or 8.0+
JaxonzPositioner (Recommended)
A follower mod of your choice to manage the inventory of locked NPCs (Extensible Follower Framework or similar - Recommended)
Installation:
Either remove your existing ZAP Helper installation or just replace it with the files from this one, it shouldn't matter.
This can either be done manually or with your favourite Mod Manager.
There are two archives! Use only one. They are labelled as Female and Male, and basically the only difference is whether you get called Mistress or Master in some of the dialogue options ? (This was a late addition, as I'd set it up to use only female pronouns but thought this wouldn't suit everyone, so I'm offering the choice).
This Extension includes all original files and should not need ZAP Helper 1.x in order to work.
To Update:- copy all files from the archive => Skyrim/Data.
(Or just use mod manager Should not cause any issues to save games)
Compatibility:
Aside from needing its requirements, this mod should not cause issues with other mods. Tested as part of an extensive (200+ mods) bondage-themed Skyrim with no real issues.
Made on LE (Oldrim). Someone has confirmed that it should work fine on SE too.
PAHE-ZFPe Compatibility Patch:
-Download the correct archive for your version (2.02b male/female currently supported -required for the patch!)
-Overwrite existing files in your Skyrim/Data folder
This patch makes Paradise Halls slaves unable to run away/escape while locked in furniture using ZAP Helper
ZAP Helper Extension How to use/FAQs:
(To Update an existing ZAP Helper install on a saved game)
(Also known as "help, where are the new spells?" 
)
(1) The first time you use the 'Furniture Placement' spell, ZAP Helper will update and add the new control spells.
(To Select an NPC)
(1) Select zbfFurniture using the Furniture Select Spell. The next time you talk to an NPC, you will have dialogue options starting from "(Restrain NPC) Hey you... You're mine now!" to order them into a furniture selection. They will stay there until released.
(To release a Selected NPC)
(1) Talk to them and say "(Release NPC) .... " OR (2) Use the Unlock All Selected NPC Spell
(To Lock an NPC):
(1) While they are in the furniture, you can either: (1) Talk to them again and say "(Lock NPC) I'm going to lock you in..." OR (2) Cast Spell "Lock Selected NPC" while looking at the restrained NPC in the crosshair (so their name shows up, if you're unsure). This will assign the (x of 10) Selected NPC to the next free (of 50) locked slot. (Selected NPCs will also stay in their furniture until released, "locked" is just for extra slots without the immersive dialogue).
(2) Select zbfFurniture using the Instant Lock spell. Cast it again at an NPC and they will be ordered to stay in that furniture, using the next free (of 50) locked slot.
(To release a Locked NPC):
(1) Talk to them and say "(Release NPC) .... " OR (2) Use the Unlock All Locked NPC Spell
(To align NPCs)
(1) Using either of the two Align spells will align ALL selected or locked NPCs to their furniture (depending on which spell is used).
(To clear empty Furniture selections)
(1) Using either of the two Clear Unused/Debug spells will clear ALL unused (but still selected) furniture targets and checked for orphaned Aliases (depending on which spell is used).
Changelog:
v2.20b: - Removed the conditions that prevent you from double selecting furniture. This enables multiple NPC furniture to be used, but also gives the possibility of other errors caused by the user (I cannot take responsibility for these).
- I have also modified the spells to add extra debug to clean up loose actor aliases that have been sent to unavailable furniture. (If you send 2 actors to the same furniture, the second actor will just stand around next to it until released).
Caution: If you send npcs a long distance to the furniture, if they are still walking there when you cast the debug spell they will also be released! If you are uncertain that all npcs you want to keep are safely locked, cast the Align spell first.
SAVE GAME SAFE - copy all files from the archive and overwrite the existing scripts/esp
v2.01: -Fixed error with dialogue still showing up without any addition Furniture selected
(simplified use of conditions and variables in the dialogue tree)
SAVE GAME SAFE - copy ZFPFurnitureSelectScript.pex and ZFPAliasControlScript.pex to => Data/Scripts, and ZFPFurniturePlacer.esp to => Skyrim/Data
Known Issues/Bugs:
(1) Bug: Character gets stuck after a dialogue animation
Symptom: Cannot cast spells, shout or sheathe/unsheathe weapon.
Frequency: Occasional/rare
Cause: Unknown/glitch in Skyrim animation system caused by certain slow animations (can happen on Vanilla)
Fix: De-equip and Re-equip any spell from your magic inventory and the glitch should immediately resolve itself.
(2) Bug: Dialogue Clutter.
Symptom: The options 1-10 to lock an NPC away appear before they have been greeted, cluttering up the dialogue (especially if you have lots of dialogue mods).
Frequency: Caused by user (depends on you, basically! )
Cause: Using Tab to quit the dialogue without choosing a furniture selection
Fix: Use the "(Cancel) On second thoughts..." dialogue, This will ungreet the alias properly. Otherwise using any other ZFP Selection spell or dialogue option will also fix this.
(3) Bug: Selection spells return an error on first attempt:
Symptom: Furniture select spell returns error "Error with selection "n"", but if recast on the same target works
Frequency: Caused by user (depends on you, basically! )
Cause: Moving too quickly while casting the selection spell. Depending on the script load of your game, it can take perhaps up to half a second for Papyrus to run the targeting selector. If you move too quickly or are moving when you cast a selection spell, sometimes it can glitch between conditions and return an error notification.
Fix: Re-cast the spell while standing still and it should work fine. (Encountering this error occasionally does not mean you have caused a persistent script error, it is safe to continue.)
(4) Bug: Furniture Delete not working / list 6 items not working / ZFP not starting up properly on a fresh install / Iona (riften housecarl) custom race glitches
Cause: Me being an idiot 
Fix: Redownload archive, it's been hotfixed now.
(5) Bug: NPC goes for walk instead of staying in furniture
Frequency: Rare
Cause: 1. Sending more than 1 actor to furniture that only 1 actor can use. -OR- 2. Bugged scripts running on an NPC caused by interactions between multiple mods
Fix: Reload a save game before those scripts were run on that NPC.
(6) Bug: All spells not added correctly on script-heavy new install (Special Edition)
Frequency: Believed to be user-specific
Cause: Unknown - possibly excessive script load during new game setup
Fix: Download ZFPe Troubleshooting Pack. This contains a few options to help you. You can add the missing spells manually using the ID numbers provided, or there is an esp that will let you craft the spellbooks at a forge. (Thanks to T-Lam for the spellbooks).
Original ZAP Helper Addon by Tyrant99: (See for original Mod documents/readme)
Credits:
T.ara for ZAP 8.0/+
Tyrant99 for the original ZAP helper
T-Lam for the craftable spellbooks
Everyone who posted a message of support while I was working on this, really helped with motivation ❤️
----------------------------------------------------------------------------------------
This is provided only for the purposes of Fantasy, Roleplay and Entertainment.
Please Kink Responsibly.
----------------------------------------------------------------------------------------
Edited by Cycorix
