[ <<>> ] Succubus Heart [ <<>> ]
[<>] The Succubus Gameplay Mod [<>]

created by : Michael Stanich aka Spirit Shard
Site - michaelpstanich.com
YouTube - youtube.com/michaelpstanich
Twitter - twitter.com/Michael_Stanich

[ <<>>] Self Promotion [ <<>> ]
So.. I work hard on the mod, but I also work hard at making YouTube Videos! If you're looking for a great Gaming and Design focused YouTube channel and creator please check me out at https://www.youtube.com/michaelpstanich ! I also run a gaming Discord Community called "The Broken Chatbox" ( https://discord.gg/v9cbQrx ). We're small now, but to growth we go!~

Also I do game-dev stuff, but it's "hush-hush" till a playable alpha... (My social media will explode with details when it's available)

[ <<>> ] Latest News [ <<>> ]
Succubus Heart 4.32 is releases! This version comes with some requested features/fixes and an overhauled crafting system (yeah, I know it was just added but I didn't like the original implementation). Notable changes from this version : New Crafting system and MCM, New Spider Soul Pet (requested), Seduction Spells are now Touch only (requested). This version is somewhat untested so please back-up your save before trying, it should work but I'm not 100% sure.

SSE Version Update Notice :
I 'think' I can port everything over now, but I haven't fully tried yet since re-installing SSE is proving to be a pain. I am working on it tho, so it'll release eventually...

_____

[ <<>> ] What is Succubus Heart? [ <<>> ]
Succubus Heart is an adult gameplay mod focused on creating new ways to approach playing Skyrim with both new progression and new game mechanics. These mechanics give the player the power of a succubus enabling the use of life-drain and great sacrificial powers. Succubus Heart is built around the idea of being a complimentary mod and should be compatible with nearly every mod out there!

[ <<>> ] What's So Unique? [ <<>> ]
Succubus Heart isn't a transformation mod, or a power fantasy mod, instead mechanics are focused on making gameplay more interesting and offering the player new ways to approach situations. Succubus Heart can also be used on male characters, turning them into a soul sucking Incubus! While most succubus mods focus on the demon-archtype Succubus Heart's approach is based on a fantasy race of life-weavers giving a more human-but-powerful vibe. However if you want some succubus transformations or want to use Succubus Heart alongside other succubus mods nothing is stopping you!

[ <<>> ] Mechanics [ <<>> ]
<-> Status Drain - Drain Health/Magicka/Stamina from your victims and use them to your advantage!
<-> Heart System - Earn XP through sex acts and spend them to improve your succubus abilities!
<-> Skill Leveling - Use overlowing Force from your victims to level skyrim's native skills (no more grinding iron daggers, grind NPCs instead!~)
<-> Succubus Passives - Enable strong Succubus Powers as you level to improve your abilities across the board!
<-> Sex/Death Drops - Extract Sperm and Breast Milk from orgasms or take their souls after victims are drained away!
<-> Crafting - Use excess forces to craft useful items on the fly!
<-> Soul Pets - Summon Incubus/Succubus Pets to fight/hump alongside you!
<-> Combat Seduction - A simple combat submit mod, integrated right into Succubus Heart for an easy all-in-one experience!
<-> Death Override Mode - Tired of death? DOM turns Skyrim into a Rouge-Lite with a new respawn system and mechanics!

[ <<>> ] WARNING : Script Mod [ <<>> ]
While Succubus Heart is fairly light weight in the majority of cases it is a heavily script based mod. If your game is already having issues with script latency and overload I recommend backing up your saves before trying out Succubus Heart (and/or possibly decreasing your script load). I've done what I can to ensure Succubus Heart is as bug/error free as possible however under script lag any mod can begin throwing up errors and I can't guarantee Succubus Heart's performance.

[ <<>> ] What's Included [ <<>> ]
- Docs (Read Me - ChangeLog - Help Document)
- Data (Everything for the core mod)
- Optional Uncapper Settings (Customized Skyrim Com. Unc. Settings)

[ <<>> ] Requirements [ <<>> ]
- Skyrim and all DLC (Skyrim Legendary Edition essentially)
- SKSE 1.07.03 or newer [ http://skse.silverlock.org/ ]
- SexLab v1.62 or newer
- Sky UI 5.1 or newer [ http://www.nexusmods.com/skyrim/mods/3863/? ]

[ <<>> ] Recommended Mods [ <<>> ]
- Skyrim Community Uncapper [ http://www.nexusmods.com/skyrim/mods/1175/? ]

[ <<>> ] Installing / Updating [ <<>> ]
Installing : Simply copy Succubus Heart's "Data" folder to your Skyrim install, merging with that "Data" folder, then install any optional content you wish to use.

Updating : If you're using version 2.73x or below you'll need to do a 'clean' save before moving to 3.0+.

[ <<>> ] Uninstalling / Removal [ <<>> ]
Disable the mod then perform a clean save. After the clean save delete the "Succubus Heart.esp" and all files pre-fixed with "SuH_" and other files from the Succubus Heart mod from your Skyrim's "Data" folder. It is recommended to either load a game from before you had Succubus Heart installed or start a new game after uninstalling.

[ <<>> ] External Mod Support [ <<>> ]
Succubus Heart features are easy to access and modify, if anyone wants to create add-ons and additional mods feel free! If you have questions or any issues feel free to message me.

[ <<>> ] Incompatible Mods [ <<>> ]
- AFT/UFO (Advanced Follower Tweaks / Ultimate Follower Overall) is incompatible with Soul Pets. While using these mods expect issues when using Soul Pets. (and no, I can't fix them, AFT/UFO need to be updated with skyrim's creature handling.)
- Any mod that 'locks' player status or tries to manage stats based on non-dynamic values. (Succubus Heart dynamically changes values and can have issues with mods that try to do this with Skyrim's default values without dynamically checking. Sadly this is on them and there's nothing I can do about it.)
- Regal Glow applies an 'invisible' armor and can cause some issues with mods detecting nudity. In these cases add an exception to 'SuH_armor_regalglow' or the blank name entry in the mod's exception MCM (if it has one). I've done what I can on my end to try and make it compatible.

[ <<>> ] Known Issues [ <<>> ]
- Horse Pet may fast travel with you if you don't already own a primary horse.
- Using Soul Pets with other Animal Follower mods may cause strange behavior on both mods. (I recommend not summoning a Soul Pet while the other Animal Follower is following you)
- Soul Pets will sometimes and sometimes not teleport to the player when they should or shouldn't, if your pet is missing just re-summon them.
- Soul Pets sometimes spawn dead/won't revive. This is a bug in skyrim and I haven't found a work-around yet...
- Combat Seduction will sometimes trigger 'overlapping' animations under heavy script lag
- Death Override Mode can cause major issues with certain quests if you die and move outside of the quest's dedicated area. (When in this situation disable Death Override for the quest's duration)
- General script latency problems do to the nature of script modding (Heavy script lag may cause issues with Succubus Heart)
- Some lists in the MCM may bug out when canceled out of. No idea why.
- Combat Seduction's Cooldown Counter can get stuck on NPCs when using DOM (working on a fix...)

[ <<>> ] FAQ [ <<>> ]
Q: Is this mod still being developed and updated?
A: Short answer is yes, long answer is a bit more complicated. The framework for everything is now built, so all that is left now is to bug fix and add in more spells/effects/whatever. While I still work on the mod from time to time updates will usually be far apart since I have many other projects + a day job to tend to. If anyone wants to add in new features themselves I'm all for it, just contact me if you run into any problems and I'll help when/where I can!

Q: I don't understand, when I use the "Sexual Entice/Enrage" I have no health!
A: Read the spell and it's mechanics carefully (it's explained in several locations, including on the spell itself). Sexual Entice and other seduction spells reduce the player's Max Health/Magicka/Stamina by a large percentage. This percentage is decreased by a Passive found in the MCM.

Q: Can I still level like in vanilla?
A: Of course! Succubus Heart doesn't alter any external scripts so other leveling methods should work as they always have.

Q: Can I use this mod as a male character?
A: Yep! Succubus Heart supports both genders.

Q: The MCM isn't showing and nothing seems to work!
A: Sounds like something installed incorrectly, try a clean install of the mod and make sure your files downloaded/extracted properly.

Q: _____ feels overpowered / underpowered, can you balance it?
A: I can try! If you have balance concerns make sure to send them my way and I'll try my best to work on it.

Q: I thought Soul Pets was going to be a completely separate mod, why is it now integrated?
A: In honesty I completely screwed up the stand-alone's code so instead of re-writing from scratch (again) I just moved onto making an integrated version first. I'll work on the stand-alone version at some point (maybe... seems unlikely at this point tho).

Q: But I didn't want Soul Pets, can it be removed?
A: No, however I've built it in such a way that it doesn't do anything if you don't use it so just ignore the Soul Pets MCM if you don't want to use it. Sorry!

Q: You're not making anymore Succubus Spells? What is "Legacy"?
A: Legacy refers to features that are in the mod but no longer supported, I didn't really feel like 'removing' more content in-case people wanted to still use it. As for spells I'm still working on Seduction (sex) spells but combat and support spells were impossible to balance and didn't really add to the mod in any interesting ways, so I'm spending that development time elsewhere.

Q: Why did you re-write the mod and end up removing features?
A: Removing features was never part of the plan but rather just a side effect. The original write was based on a flawed framework and the entire mod had become a grouping of work-around, causing bugs which I couldn't fix. The re-write allowed me to rebuild the foundation and build a more cohesive mod with better mechanics and synergy.

Recent Changes (Check the full changelog for more info)
[Spoiler]
Succubus Heart 4.32
- Changed "Succubus Realm" Spell can no longer be cast while in combat (no more free escapes!)
- Added "Calm enemies During Acts" option that attempts to stop combat while in an act
	- This is a super basic implementation since my other methods failed... better than nothing I guess.
- Added "Clean Arrows off Character" option that attempts to remove arrows and other projectiles in acts.
- Added some highlight text to the MCM and added "Crafting" to help section
- Fixed Crafting Points not being rewarded
- Fixed Crafting Item lists being cut-off (not showing all items)
- Fixed Some Items in the Crafting MCM Not showing their cost or costing 0c
- Fixed Bristle Level Not Showing in MCM
_____
Succubus Heart 4.31
- Fixed Sexual Enrage/Entice not being actual spells (wouldn't cast)
- Fixed Spider not leveling up?
_____
Succubus Heart 4.30 (This version is mostly untested, keep a save backup)
- Changed Crafting system got an overhaul (More items will be added in the future)
- Changed Crafting Menu now has a list based system (easier to find what you need)
- Changed Seduction Spells are now touch spells and don't have range
- Added Crafting Points are now earned through absorption to spend on crafting
- Added Spider Soul Pet (It's the small one... it's the only one I got to work properly)
- Fixed / Changed Skill Trainer Bug Detection should no longer infinitely level skills for free
- - - Will now take SP but won't allow any more increases until the skill is leveled normally
- Fixed? Always Drain Kill should now work properly (probably)
- Fixed Added a 'cap' to HeartXP to prevent overflow errors (still can't find the actual cause, this is a workaround. Cap is 2 billion and -1 which are impossible to reach normally)
_____
Succubus Heart 4.21
- Changed Regal Glow passive no longer counts as body armor and should no longer conflict with body-checking, SOS, or other similar mods (However, it now takes Slot 48 and will conflict with some outfit mods that use way too many slots)
- Changed CoS now hungers gold value as well, and is more grateful than ever...
- Changed Help menu has been redone and simplified (Now has general descriptions)
- Added Craft Menu/System (This allows the exchange of Status for Items/Gear with leveling)
- Added Lockpicks/Weapons/Armors to the Craft Menu
- Fixed Perk's Progress Bars being broken at level 0
[/Spoiler] 