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

created by : Michael Stanich aka Spirit Shard
Site - michaelpstanich.com

[ <<>> ] Latest News [ <<>> ]
Succubus Heart 3.1 released!

The complete re-write (3.0) is finally done with all new spells and mechanics compared to the older write (2.7x and below). This re-write is also more stable and should be lighter in script weight in all cases. That's not to say a mod like this is ever 'done', if you have ideas/suggestions/balance concerns make sure to let me know! [If you used Succubus Heart 2.73 or older I recommend doing a clean save to ensure everything works properly]

Special note, I had mentioned in the past a few features I always wanted to add in but didn't have enough skill to do so, but now I have the skill, just not the time. That said, if anyone wants to create mods which compliment/use Succubus Heart feel free, I'll even help if needed!

_____

[ <<>> ] 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 [ <<>> ]
Heart System : Your succubus will earn XP through sexual acts and certain items which can be spent to learn new spells and improve their abilities! You'll also absorb life force from your partners, permanently decreasing their status while improving your own!

Skill Leveling : Take your overflowing life force and level Skyrim's usual Skills using SP earned. You can also convert any unwanted XP into SP if so desired.

Sex Drops : Orgasms will give partners their special juices (Sperm and Milk) which can be consumed or used in alchemy! There's also a chance at getting rare drops which have special effects when consumed (or you can be boring and use them in alchemy...).

Succubus Spells and Passives : Use a wide variety of powerful spells with unique effects scaling with your succubus powers. Passives can also be ranked up to passively increase your overall effectiveness!

Combat Seduction : A simple combat submit mod, built right in! Initially built for testing, the feature can be handy if you're looking for a light-weight alternative to other submit mods. However I recommend disabling this feature if you do you other submit mods to avoid issues.

[ <<>> ] WARNING : Script Mod [ <<>> ]
While Succubus Heart is fairly light weight in the majority of cases it is a heavily script based mod. If you're 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 - Source Notes)
- Data (Everything for the core mod)
- Optional Uncapper Settings (Customized Skyrim Com. Unc. Settings)

[ <<>> ] Requirements [ <<>> ]
- SKSE 1.07.03 or newer [ http://skse.silverlock.org/ ]
- SexLab v1.61 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 before you'll need to do a 'clean' save before moving to 3.0. Otherwise just overwrite and start your game!

[ <<>> ] 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_" from your Skyrim's "Data" folder.

[ <<>> ] 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.

[ <<>> ] Known Issues [ <<>> ]
- Combat Seduction will sometimes trigger 'overlapping' animations under heavy script lag
- Constant effect damage spells can cause a bit of script latency do to onHit calculations (shouldn't really have much of an effect on gameplay however.)
- Script Heavy games may have decreased effectiveness from Succubus Heart's over-time effects do-to script latency
- Succubus Heart will occasionally try to give dead NPCs items/spells when it shouldn't when under heavy sript lag, just throws up a papyrus error. (has no noticeable gameplay effect)

[ <<>> ] FAQ [ <<>> ]
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.

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 work my best to work on it.

Changelog (Only contains the re-write notes)
[Spoiler]
Succubus Heart 3.1
- Changed the MCM menu name to "_Succubus Heart" so it appears at the top
- - - (MUST USE "setstage SKI_ConfigManagerInstance 1" in console to reset MCM names/registers)
- Changed XP level scaling on all default drain and consumption effects to 5 (was 2 and 1)
- Changed default Desire Generation to 1 per second (was 0.4 per second)
- Changed Desire Drain limit to 1200 (drain begins at and above 1200)
- Changed Sexual Entice Desire requirement to 300
- Changed Sexual Enrage Desire requirement to 120
- Added Desire Generation setting (changes Desire gained for every second, can be 0)
- Added Drain Always Kills option (ignores health and tries to drain kill every act with drain)
- Added level scaling to status caps (Adds 2 status per level)
- Added another overlap check to combat seduction (Player should not overlap in any scenario)
- Fixed/Changed some MCM typos and Help entry wording
_____
Succubus Heart 3.0
- Changed - Optional - Uncapper no longer gives status on level-up
- Changed Seduction Spell visual effects
- Changed Seduction Spell cast time to be lower (0.5 -> 0.2sec)
- Changed Death Drops to always give a drop when enabled
- Changed Status Cap Level costs to scale linearly (instead of exponentially)
- Changed Base XP earn value (20->25)
- Added overlap check to combat seduction to help prevent overlapping animations
- Added Death Drops option [Enables/Disables Death Drops Mechanic]
- Added level scaling to Soul of Experience [Gives 2 bonus XP per-level]
- Fixed Seduction Spells having Hit Events (would trigger Submit Mods)
- Fixed some missing references
_____
Succubus Heart BETA 3.x (0.7)
- Changed XP values for Heart Levels (For more senseable scaling)
- Changed Level Scaled XP (More XP for Higher Levels)
- Changed Drop Rates so rares/uncommons appear more often
- Changed/Added visual effects for all spells
- Added 'Blank Page' cover image to the MCM
- Added Desire Drain option (Enables/Disables Desire Drain Mechanic)
- Added cast time and skill leveling to all spells
- Added Status Cap and Absorption Override options
- Added Hover/Display text to Help's Reference Category
- Fixed incorrect MCM sorting
- Fixed empty MCM entries when starting a new game
_____
Succubus Heart ALPHA 3.x (0.6)
- Changed Status Cap cost to be a bit cheaper (again)
- Changed Drain Kill to calculate based on Current Health (was Base Health)
- Changed Increase Rank to Rank Up on Passives
- Changed Saving Essence Passive to apply before combat seduction
- Added Rank Down to Passives
- Added Hover/Display Text entries for all MCM items
- Added Vocabulary section to Help menu (for clarity)
- Added Night's Embrace Spell (Auto-Learned - Forces sleeping actors to submit)
- Added calculations to Passives Display Text (shows actual values)
- Added Gifted Consent Passive (Grants consensual partners stat)
- Added Force Master Passive (Decreases required Force for SP)
- Added Consensual Drain Setting (Enables/Disables drain on consensual partners)
- Fixed Vital Drain [Base-Love] from not working when 2 stack values were the same
- Fixed Vital Drain [Base-Love] Notification Display
- Fixed Vital Drain [Hate] should now be properly named
- Fixed Magicka/Stamina drain being effected by Health Absorption
- Fixed Passives below Masochist leveling Masochist instead of themselves
- Fixed Masochist Passive not working
- Fixed Saving Essence Passive consuming stacks at rank 0
- Fixed Saving Essence Passive working above 30% (instead of below)
- Fixed some Items being improperly tagged
- Fixed Stacks Mechanic (Should be working properly now)
- Fixed player hit effects not updating with the mod
- Fixed a few typos in the MCM
- Fixed -Compatibility- Sperm/Milk not working in iNeed (Hopefully)
_____
Succubus Heart ALPHA 3.x (0.5)
- Removed 100 XP bonus on NPC deaths (replacing with drops system)
- Changed Status Cap costs to be more reasonable
- Changed some MCM sorting
- Changed base XP earn value (10 -> 20)
- Changed Sperm and Milk to be tagged as Food Items (Still acts as ingredients)
- Added Desire Drain Mechanic (After 800 Status converts to Force over-time)
- Added Help Menu Entries (filled it out)
- Added two new rare drops
- Added Sexual Entice Spell (Starts a consensual act - Get through Desire)
- Added Self Pleasure Spell (Starts a solo act - Auto Learned on update)
- Added Focus Shot [Love] Spell (Stronger version of Base)
- Added Cursed Blood [Base] Spell (Targets take extra damage on hit)
- Added Cursed Blood [Love] Spell (Stronger version of Base)
- Added Cursed Blood [Hate] Spell (Kills target after an act)
- Added Vital Drain [Base] Spell (Absorbs status from targets)
- Added Vital Drain [Love] Spell (Stronger version of Base)
- Added Vital Drain [Hate] Spell (Takes status and damage the target)
- Added Spirit Mend [Base] Spell (Converts Magicka to Health)
- Added Spirit Mend [Love] Spell (Stronger version of Base)
- Added Spirit Mend [Hate] Spell (Converts Desire to status)
- Added Soul Bend [Base] Spell (Takes status for high damage)
- Added Soul Bend [Love] Spell (Stronger version of Base)
- Added Soul Bend [Hate] Spell (Uses their own status as damage)
- Added Intimate Touch [Base] (Damage target without aggression)
- Added Intimate Touch [Love] (Stronger version of base)
- Added Intimate Touch [Hate] (Removes enemy Stamina and Magicka)
- Added Magicka Cast costs to all Focus Shot versions
- Added passives system which uses a new ranks system
- Added Perfect Orgasm Passive (Increases rare drop chance)
- Added Luscious Liquids Passive (Recover on sperm/milk consumption)
- Added Masochist Passive (Grants Desire when hit)
- Added Self Stacker Passive (Grants stacks based on gender)
- Added Value Stacker Passive (Increases stacks gained)
- Added Death Drops system (Souls will be placed in dying NPC inventories)
- Added six new Soul Items (Death Drops)
- Fixed Essential in Act setting causing drain kill to not work
- Fixed Spells not swapping out properly when learning new versions
- Fixed Succubus Absorption working in solo acts
- Fixed Solo animation triggering
_____
Succubus Heart vR 0.4
- Removed Pets and Crafting from MCM
- Changed "Focus Shot [Drain]" to "Focus Shot [Hate]"
- Changed effect of Focus Shot [Hate] (was Drain)
- Added more validity checks to Combat Seduction
- Added MCM update function (will show a notification upon updates)
- Added XP to SP converter to Skill Levels
- Added Rare Drops system (Small chance in every act with more than 1)
- Added a new rare drop
- Fixed more cases of overlapping animations
- Fixed Invalid Skill Leveling Values
- Fixed several typos in the MCM
- Fixed some MCM values not updating when changed
- Fixed "sp to next" value not updating correctly in Skill Levels
- Fixed XP Gain not showing properly in Status
_____
Succubus Heart vR 0.3
- Added spell "Focus Shot" [Base] version
- Added spell "Focus Shot" [Drain] version
- Fixed improper release pack format ("Script" should have been "Scripts")
- Fixed Sex Drops not being given to the player
- Fixed Combat Seduction not allowing the player to submit
_____
Succubus Heart vR 0.2
- Changed and vastly improved ANIMcalc function (Improved animation sorting)
- Changed Desire generation to 2/5sec
- Enabled Orgasm effect on Desire (converts 80% into XP)
- Added Combat Seduction Health threshold settings
- Enabled homosexual settings
- Enabled "NPCs Essential in Act" setting
- Fixed animations triggering even when invalid
- Fixed females taking dominate position inappropriately
- Fixed Aggressive / Passive animations tagging incorrectly
_____
Succubus Heart vR 0.1
Initial Re-write release
- Added MCM with all 7 menus
- Status, Skill, and Heart menus are now functional
- Added Sperm and Milk sex drops
- Sperm and Milk consumption effects now enabled
- Sex Effects are now enabled (Absorption)
- "kill effects" implemented (Test effect - 100XP earned when killing an NPC)
- Stacks system enabled (Nothing uses them yet)
- Combat Seduction - Basic Test Version release
- Other basic stuffs
[/Spoiler] 