[ <<>> ] 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!~
_
[ <<>> ] Latest News [ <<>> ]
A new Succubus Update is here! 4.10 [5.0 DEV build] 
_
5.0 will have some new systems, such as Soul Pets being re-worked (and a stand-alone mod version finally releasing afterwords), all new Soul Forge system which will replace Crafting with a more dynamic system, and of course new passives and perks. This will obviously take some time so I can't say when the update will release, but it's in the works!
_
Regarding Skyrim Legendary Edition's Succubus Heart Version : Official support for SLE has been dropped, all new features will be SSE exclusive. Thank you all for the awesome comments/support and hope to see you in SSE someday!
_
_____
_
[ <<>> ] 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 replicate 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)
_
[ <<>> ] Requirements [ <<>> ]
Skyrim Special Edition
- SKSE - Latest Available [ http://skse.silverlock.org/ ]
- SexLab SE v1.63 BETA or newer [ https://www.loverslab.com/topic/91861-sexlab-framework-se-163-beta-2-april-5-2018/ ]
- SkyUI SE 5.2 or newer [ https://www.nexusmods.com/skyrimspecialedition/mods/12604 ]
_
[ <<>> ] 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. When using 5.0 or newer you'll need to enable the mod in the MCM.
_
Updating : If you're updating to 5.0, existing saves will need to install version 4.6 before installing 5.0. After installing 4.6, load your character save, wait for the update to finish (about 1 second), and make a new save. Now exit and install 5.0, now you can load the new character save you made and keep your progress. Updating directly to 5.0 from versions before 4.6 without these steps will result in your Succubus Heart progress being completely lost and things may break beyond repair!

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) and many other follower management mods may have issues with Soul Pets, so expect some weirdness when using these mods.
- 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 [ <<>> ]
- 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.
- 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.
_
[ <<>> ] FAQ [ <<>> ]
Q: Is this mod still being developed and updated?
A: Short answer is yes, long answer is a bit more complicated. I have a lot of projects and a life to live, so updates are usually spaced a bit apart.
_
Q: Why was Official Oldrim (SLE) support dropped?
A: Unfortunately I just can't work with Oldrim's Creation Kit anymore, it just crashes too much on my newer hardware. This means I'm stuck with SSE whether I like it or not, on-top of this new features being added to Succubus Heart now require SSE to function properly and back-porting to SLE just simply takes too much time for me to justify.
_
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 all 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...).
_
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.
_
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-arounds, 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 5.0 DEV [4.11]
	- Added. "Revive Cost" option to Death Override Mode
	 - - Reduces Status Caps by a certain percentage when reviving in DOM
	- Added. "Never Die Mode" option to Death Override Mode (Requires Death Override Mode to be enabled)
	 - - This mode has the player heal and stand back up after the bleed out delay rather than returning to the Succubus Realm
	 - - NOTICE : It's recommended to disable "lose items" and similar options while using Never Die Mode and instead use the Revive Cost option
	= Fixed. "Seducer" passive allowing the player to purchase upgrades without enough Status Cap
	- Fixed. the All Consuming Chest should no longer give free XP every time it was opened and closed
_____
Succubus Heart 5.0 DEV [4.10]
	- Modder Note. All non-pet items now trigger based on keywords, you can now add the "SuH_key_  " keyword to any item to trigger the appropriate effect. (Check SuH_Status or SuH_Main_player for keywords available)
	_____
	- Changed.  Devious Partner Passive
	 - - Gold Up is now +2 stolen every level instead of +1
	 - - Conversion Up is now +5% of Mind Rating instead of +20%
	- Changed.  Seducer Passive
	 - - Status Caps reduce by 60 instead of 20 per rank
	 - - Cost Down decreases by 30% instead of 10% (Requires 3 levels to nullify instead of 9)
	- Changed. Updated some Help and Error text
	- Changed. Added Brackets and slightly changed names of Succubus Heart items
	- Changed. Removed "empty" magic effects on consumables and removed all other ingredient effects
	 - - Will be adding new effects in the future so they can legitimately be used in alchemy without drawbacks
	_____
	- Removed.  guaranteed "+1" effect from all passives that had it
	 - - This means Passives can now have an effect of zero if BDSM isn't high enough (before it would always add +1, preventing this)
	_____
	- Added. Refresh Stone Item
	 - - Resets Passives without costing HeartXP
	 - - Added Refresh Stone to Spirit's potential items for sale
	- Added. Setting "End Act On Attack"
	 - - Attempts to end Acts when a participent is attacked, can cause some animations to end improperly
	- Added. Consuming Sperm should now apply an oral cum effect
	- Added. "Submit Cooldown" Option
	 - - Changes how long a character is immune to Combat Seduction after the end of an act
	- Added. Permanent storage chests near the entry point of the Succubus Realm
	_____
	- Fixed. Perks should now properly effect BDSM Rating similar to items without having to reset passives
	 - - Cap increases should have increased BDSM rating when aquired but wouldn't until BDSM was fully re-calculated by a reset
	- Fixed. Regal Glow should now update its armor rating value properly
	= Fixed. Regal Glow should now display the correct values in the MCM when re-loading/entering the menu"
	- Fixed. Added missing flags on some SuH background functioning spells
	 - - This should prevent NPCs from reflecting/resisting effects, remove some rare visual effects that would randomly appear, and functions like "calm during act" should work more consistantly
	- Fixed. Some timers/cooldowns should no longer count-down when in menus
	- Fixed. Combat Seduction should be more responsive to ignoring acts and behave more reliably
	- Fixed. Sperm and Milk acquisition and application on Orgasms should work more reliably and be compatible with more mods
	- Fixed. Characters that revive should more reliably prevent double drops
	- Fixed. Re-implemented Combat Seduction Cooldown, now called Submit Cooldown. (Still somewhat unreliable)
	- Fixed. Some typos and incorrect numbers in the MCM
	_____
	+ Milk and Sperm calculations are now a SuH_Fun function (MilkCalc and SpermCalc)
	+ Orgasms now use the Milk/Sperm function instead of an equip method
	+ SuH_dyna_active will now try to remove itself OnLoad, this is to help with refreshing the script
_____
Succubus Heart 5.0 DEV [4.9]
	- Changed. DOM now fully recovers Status (or tries to at least - Required to fix some glitches)
	= Changed. Decreased Soul Forge Memory Increase Cost
	- Changed. Passive Reset Cost now scales based on how many points have been spent (was based on level)
	= Changed. Increased value of pet soul items
	- Added. Passive Cap Excel which allows status to exceed the Status Cap (50% Body Rating per-rank) and slow the decay
	 - - Note : When exceeding past the Status Cap, Status will slowly decay and convert into force
	- Added. Soul of Pet Skeever item
	- Added. Soul of Pet Riekling item
	- Added. Soul of Pet Draugr item
	- Added. Toggle for Vigilant of Stendarr Hostility in Settings MCM
	= Fixed. Follower's Temporary Bow is now removed from inventory when returning pets home (Vanilla fix)
	= Fixed. DOM should now return the player to the Succubus Realm properly when knocked down without recovery options (ex. Absorption or external healing)
	= Fixed. Soul Pets not properly gaining XP in combat or being removed on Death
	= Fixed. Soul Forge MCM showing the wrong cost for items in memory
	= Fixed. Soul Forge MCM showing wrong memory increase cost after increasing memory
_____
Succubus Heart 5.0 DEV [4.8]
	- Changed. Updated Soul Pet MCM tutorial pop-up to reflect changes
	- Changed. Spirit will now have more stock for sale
	= Changed. Removed Slot Numbers on Soul Pets MCM
	= Changed. Soul Pets now scale by Status Percentages rather than relying on difficulty scaling
	- Removed. Death Override Mode no longer set status at 30%
	- Added. 'Lose Blood Chips On Death" Option for Death Override Mode
	- Added. Soul Forge is now integrated
	 - - Accessed in the Soul Forge MCM menu, now showing a tutorial message on first entry
	 - - Use Blood Chips to forge items instantly from memory
	 - - To add an item to memory select an item from your inventory (using the Soul Forge MCM) to start analyzing it
	 - - Analysis will complete over time however a small boost is gained when forging other items
	 - - When Analysis reaches 100%, if there is an open memory slot the item will be added
	 - - If Analysis reaches 100% and there are no slots available some progress is lost and Analysis will continue
	 - - If an item is already in memory, doesn't have a name, or is a Succubus Heart Item it can't be Analyzed
	 - - Items can be removed from memory in the MCM to open slots
	 - - Slots available can be expanded (up-to 50) using HeartXP
	- Added. Create Blood Chips from Health Cap to the Soul Forge MCM
	- Added. Summon Most Recent Pet to Pet Self Spell
	= New Soul Pets System Changes
		= When updating to 4.8 DEV Pets will most likely lose their names and need to be re-named manually
	 - - Soul Pets that have no default name will be auto-named "Pet"
	 - - Soul Pets can be renamed using the MCM
	 - - Soul Pets scale their Status based on Level
	- Added. Pet Dog Soul which adds a Dog Soul to an open Soul Pet Slot
	 - - Also added to Spirit's possible items for sale
	- Added. Pet Husky Soul which adds a Husky Soul to an open Soul Pet Slot
	 - - Also added to Spirit's possible items for sale
	- Fixed. Fixed losing gold with Death Override even when Lose Gold on Death was disabled
	- Fixed. Some defaults that should have been disabled on new games
	- Fixed. Succubus Realm 'Return to last entry' just returning directly back
	 - - (Will need to re-enter an interior for this to fix itself)
_____
Succubus Heart 5.0 DEV [4.7]
	- Changed. Succubus Heart no longer auto-starts and must be started using the MCM
	- Changed. Soul Pets has been completely re-done to fall in-line with my WIP stand-alone.
	- Changed. Soul Pets are now vulnerable to Combat Seduction from the player
	- Changed. Blood Chips are now weightless
	- Changed. Blood Chips value decreased to 3 (was 5)
	- Changed. Removed spell cost from Pet Target Spell
	- Changed. Updated Help in the MCM to include updated mechanics
	- Changed. Menu Pop-ups now describe their options
	- Removed. All old Soul Pets
	- Added. New Soul Pets System
	 - - Souls are 'replicated' by using the Pet Target spell on any non-unique character
	 - - Replicating a soul will cost 50 Blood Chips
	 - - Replicated Souls are registered as pets and can be summoned at any time as a follower
	 - - Only one of each type (ActorBase) can be registered at once
	 - - Up-to 25 Pets can be registered at a time
	 - - If a Soul Pet dies they are removed from your registery
	 - - Desummoning a Pet grants the player their invintory
	 - - In Combat and Training pets will gain XP and increase their summon level
	 = = At certain level intervals pet summons will grow in strength
	 - - When pets are removed Blood Chips will be rewarded based on level (5 per-level)
	 - - Leveling pets will level the Pet Skill which increases XP gained by pets overall
	- Added. Blood Chips added to Death Drops (Randomly drops at different values, including zero)
	- Fixed. Soul Pets are now 'mostly' compatible with follower framework mods (compatibility will vary on a per-mod basis)
	- Fixed. Spells should now properly add upon update/new game
	- Fixed. MCM should now properly appear on new games and appear quicker
[/Spoiler] 