<>-- Dragon from Succubus Valley --<>
(DfSV / Succubus Heart) By : Spirit Shard

<> What is the 'Dragon from Succubus Valley' mod? <>
Dragon from Succubus Valley (DfSV for short) is a mod focused on integrating sex with progression. With DfSV installed the player will have the abilities of a life force stealing Succubus! Players will increase stats through sexual activity and be able to sacrifice those stats in order to level up and unlock new skills/spells.

<> Story <>
[spoiler]
<> Dragon from Succubus Valley - Character Story <>
Two rival nations battling for the last of their precious pets. The Succubus army of Blood Heart takes on full assault into Casting Glaze, or as it's known to the humans, Succubus Valley. A lone Succubus resident rises from their victim's body as they hear the gates shatter - they are here for humans. The lone Succubus rushes on her way to warn the commander but is stopped by a large Blood Heart force. "It's over Moon Heart, we're taking them all!" Her once victim dragged alongside her as they headed for the shattered metal gates gives out a whisper, "You... You can help.." The Succubus looks down on the ragged man but is quickly surprised by a glow in his hand, "Help my... my homeland..." In a quick dash of light the man stands as destruction circles the two dragged prisoners, "THIS IS OUR FREEDOM."

The succubus wakes up in the middle of a castle surrounded by what appears to be.. humans? Delighted as she is, it's not long before she's tied up and put into a cell. "Oh well, at least they mistake me for some dragonborn hero."


<> Story - Succubus <>
The Succubus is a creature who gains power through the consumption of souls and Life Force, and the easiest way to get them is through.. oh, you know.. ^.-
[/spoiler]


<> Mechanics <>
[Spoiler]
<> General Mechanic Additions <>
- Males will give sperm to their partner when they orgasm
--- There is a bonus chance to receive double sperm and a chance of no sperm (load/dry)
--- Only females will receive sperm (homosexual sex will result in no sperm do to a code limitation)

<> Succubus Blessing <>
The player will be granted the powers of a life force stealing succubus giving her a range of abilities unique to her blessing.

()> Absorption Blessing
- Absorb base Health/Magicka/Stamina from others during Sex, stealing away their life force
--- Player = Aggressor multiplier is 100%
--- Player = Victim multiplier is 10%
--- Consensual multiplier is 50% but no harm is done to either participant

()> Succubus Delight
- Consume sperm for bonuses
--- Grants Health/Magicka/Stamina/HeartXP similar to sex
--- Gain bonuses for consuming sperm

()>  Succubus [Heart] Spells
- The player can learn Succubus Spells with varied abilities for seduction, combat, and support
- Learn passives to improve your overall performance

()> Succubus Heart system
- Gain HeartXP through sexual acts or succubus spells
--- HeartXP can be spent to increase the players stats/levels and learn new succubus spells
- A new stat called "Heart Focus" is given to the player
--- HeartForce determines the effectiveness of Succubus Spells
--- HeartForce regenerates 10% every second (3%/per 3sec)

()> MCM ( DfSV-Succubus Heart )
- Check stats and level through the MCM

()> Built on SexLab Framework
--- Any sexlab animations will work with this mod
[/Spoiler]

<> Requirements <>
- SKSE 1.07.01 [ http://skse.silverlock.org/ ]
--- It may run on an older version but this is what I worked with.
- Sexlab v159c [ http://www.loverslab...dated-oct-3rd/ ]
--- Or higher I assume
- SkyUI 4.1 [ http://www.nexusmods.com/skyrim/mods/3863/? ]
--- Or higher I assume. Needed for MCM.

<> Recommended Mods <>
[Spoiler]
<> Strongly Recommended Mods <>
- Skyrim -Community- Uncapper [ http://www.nexusmods...im/mods/1175/? ]
--- For uncapping the level caps and adjusting leveling to accommodate for the new progression options. (I provide optional settings for uncapper as well)

<> 'just' Recommended Mods <>
- Defeat V5b3.3+ [ http://www.loverslab...5b33fixed-805/ ]
--- Allows for a whole array of rape and such, plus the tie-up feature really helps out in big fights, or just to let your pet wait a little longer for pleasure. ^.-
- More Nasty Critters [ http://www.loverslab...asty-critters/ ]
--- Large collection and additions to bestiality mods - a must have in my opinion.
[/Spoiler]

<> Recommended Settings <>
[Spoiler]
()> Skyrim -Community- Uncapper <()
I've provided an ini settings file as optional in order to set a little balance. This file contains a few changes...
-- Increased Caps to 999
-- Sets +5 carry weight to Health, Energy, and Magicka increase
-- Skill Multipliers are set at 0.5
Please adjust these amounts to fit the way you play. If you wish to use the succubus skills as your primary combat function I recommend low skill multipliers, if you only use succubus skills casually I recommend normal skill multipliers. (I'll have different presets at a later date)
[/Spoiler]

<> Compatibility <>
[Spoiler]
- Conflicts with mods that "lock" stats or increase/decrease them to maintain a specific value, luckly these mods are very rare since there's really no reason to do this..
- Compatibility with PSQ is beginning to be questionable (some features are in both mods but done in different ways, causing play style issues)
- If you find anything else please let me know!
[/Spoiler]

<> Known Issues <>
[Spoiler]
- In V1.1.0 the MCM is performing slower than usual when leveling, this will be fixed in a future release.
[/Spoiler]

<> Installation / Updating <>
[Spoiler]
Merge the provided Data folder with your skyrim install, install 'Optional Uncap' if so desired. Enable in your mod manager of choice.

WARNING : if you have a version before V1.0.0 then a clean save is required for many elements to function properly, a new game is recommended for low level characters. If you had a version before V0.5.0 a new game is highly recommended do to script update changes.
[/Spoiler]

<> Uninstall / Removal <>
[Spoiler]
Disable the Mod in your mod manager of choice, load up your saved game you wish to uninstall it from, wait at least 10 seconds, save and exit. After this "clean save" you can delete all the files with "DfSV" at the start of the name from Data, Data/Script, and Data/Script/Source. Removing the files is not necessary for updating but is recommended if you had a version before V1.0.0 installed.
[/Spoiler]

<> FAQ <>
[spoiler]
<> Q and A <>
Q : Can I still level like in vanilla?
A : Yep, this mod doesn't alter any external scripts so other leveling mods should not be effected.

Q : What does Heart Force do? [V0.6.0]
A : Heart Force is used for Succubus Spells and determines their effectiveness.

Q : Why does my character always seem to have XXX health/magicka/stamina?
A : In this mod the succubus gains status when having sex but will lose those gains over time if they excede their level's maximum. Max is determined by 100 + 10/per level.

Q : Why have health/magicka/stamina decay?
A : This is a balancing act to prevent players from amassing large amounts of health at lower levels and to help prevent mass leveling of a single skill. (ex. level 150 Marksman while 15-20 in all other skills) Although it is still possible if you wish to do so it'll take more work than leveling multiple skills.

Q : What is the point when I can just have sex to heal?
A : This mod does not actually heal you! It only effects the max of your health (excluding spells). This means unless your absorption has been increased a good amount you will not actually heal all that much. Also, if you're worried about challenge don't use mods that exploit the systems. Ultimately you're in control of how difficult the game and mechanics are.

Q : Why not just implement the HeartXP system and leave out the Health/Magicka/Stamina stuff?
A : In my opinion it creates an interesting dynamic and allows you to play through the whole game without actually using combat (given you install the right mods). It also helps resolve the age long issue of "this character is too high of a level so I never die/it's boring" by creating intensives (which become more and more degraded as you scale up) to decrease your actual power. tl;dr it counters 'power creep' well.

Q : When are the dialogue options going to be included?
A : Including things like dialogue is very different than what I've been doing and requires a whole new set of scripts/objects to get working the way I want it. It's also very tedious for a lot of these things, it'll be in a future update but not likely soon, I'd rather get all the main mechanics working before entering the mud pool.
[/spoiler]

<> Spells / Passives<>
[spoiler]
<> Released Spells <>
[Heart] Focus Shot
--- Consumes 10% of your current Heart Force and damages the target by that amount. 50% of that goes into HeartXP.
[Heart] Dark Pierce
--- Consume 20% of your Health/Magicka/Stamina and damage the target's Health/Magicka/Stamina by that amount. 50% total of that goes into HeartXP

<> Currently Released Passives <>
Sticky Sperm Lover
--- Consuming Sticky Sperm increases Magicka regeneration for 5 seconds
Warm Sperm Lover
--- Consuming Warm Sperm increases Health regeneration for 5 seconds
Sweet Sperm Lover
--- Consuming Sweet Sperm increases Stamina regeneration for 5 seconds
Thick Sperm Lover
---Consuming Thick Sperm increases Health/Magicka/Stamina regeneration for 3 seconds


<> Currently in Development Spells <>
[Heart] Succubus Kiss
--- Attempts to charm the target into having consensual sex
[Heart] Sight of Desire
--- Attempts to paralyse the target with a seductive wink
[Heart] Succubus Blessing of Health/Magicka/Stamina (versions for each)
--- Grants the target 25 Health/Magicka/Stamina at the cost of 50 Health/Magicka/Stamina
[Heart] Force Focus
--- Consumes Heart Force and converts 25% into HeartXP

<> Currently in Development Passives <>
None atm...

[/spoiler]

<> Change Log <>
[spoiler]
- V1.1.0 [NOTE : MCM performance will be slower than usual when leveling, this will be fixed in a later release]
--- Fixed [Heart] Focus Shot's typo
--- Adjusted level cost scaling
--- Consensual multiplier was set to 50% (was 80%)
--- Heart Focus is now given by default (no cost)
--- Increased Heart Focus cast cost to 30 magicka (was 10)
--- Heart Force is now effected by "Destruction Novice" perk (or at least should be)
--- Adjusted Dark Pierce learning cost to 50,000 (was 6,000)
--- Dark Pierce : Increased cast cost to 80 (was 30.. I think)
--- Dark Pierce : now effected by "Destruction Adept" perk (or at least should be)
--- Added a new spell type : Passive Spells
--- Sperm Lover passives were added to Passive Spells (Heart Spells)
--- Added description text for spells in the MCM (Now you know what they do before learning them)

- V1.0.1 [simple usability update]
--- MCM now refreshes when learning skills/increasing values (Numbers update immediately instead of needing to re-enter the page)
--- MCM now shows "req./status" on the SkillBurn menu for easier leveling(this will carry over to other pages if they grow large enough)
--- Fixed all the float values (hopefully)
--- Removed more unnecessary code (commented stuff I forgot to remove before, theoretically lowers load time)

- V1.0.0 [WARNING : With this release a clean save is REQUIRED]
--- Re-write of most script
--- Removed outdated variables and scripts (main reason for clean save requirement)
--- Values now pass through "Math.Floor" (this 'should' mean no more float values)
--- Effects under 1 will now value as 0 (no more slight increases over long durations)
--- Adjusted Spells to have a mana cost (again)
--- Removed Carry weight increase option (being moved into spells later on)
--- Changed "Increase HeartXP" Stat into a percentage
--- *WARNING* because of HeartXP changes HeartXP gain will revert to 100% when updating
--- Completely changed leveling values and requirements
--- Requirements now increase as skills/values increase (base requirements are a lot lower because of this)
--- Changed HeartXP values for actions (they are significantly higher than before)
--- Removed 20 status minimum (you can now lower a status down to 0)
--- Level up messages should now show effect (ex. "Alchemy Increased to 41")
--- "HeartXP" status added to HeartXP MCM
--- Removed extra effects from Sperm (these slots will be filled in a future update
--- *Bug* Some messages will still show float values (no actual negative effect, just visually unappealing)

- V0.7.0
--- *Fixed* Sperm not effecting stats
--- *Adjusted* Sperm values to give more HeartXP
--- *Adjusted* Status Cap to 100 + 15 per level
--- *Fixed* Status values staying at ##1 or ##9
--- (technically a fix) Removed mana cost from [Heart]Focus Shot spell
--- *Fixed* [Heart]Focus Shot should now be a hostile spell
--- *Added* New Spell [Heart]Dark Pierce
--- *Adjusted* absorption rate to 3 seconds
--- *Adjusted* decay rate to 9 seconds
--- *Fixed* attacker and victim adsorption reversing for NPCs

- V0.6.0
--- Heart Force usage changed
--- Heart Force will now be used only for spells and seduction attempts
--- Heart Force is no longer lost during sexual activity
--- Heart Force no longer effects gains/losses during sexual activity
--- New Spell "Force Shot" Added (find it under the Heart Spells MCM)
--- The minimum Health/Magicka/Stamina a player can have before decay is now increased with each player level (100 + 10/per level)
--- Skill Levels are now shown in the Soul Burn MCM (The page must be re-selected for changes to show)
--- Absorb Values are now shown in the Status MCM
--- Sperm values are now shown in the Status MCM
--- *Adjusted* sex type effects (As aggressor - 100% / As Consensual - 60% / As Victim - 10%)
--- *Fixed* Sperm not increasing status by the proper values
--- *Fixed* HeartXP Gain not increasing properly and decaying on some events
--- *Fixed* Heart Gain MCM not increasing properly
--- *Fixed* More improper values (when there's so many lines of code it's easy to miss things X.x)

- V0.5.2
--- Fixed improper labels
--- Minor check adjustments

- V0.5.1
--- The "HeartXP" options should now show a confirmation window like with skills
--- *fixed* being unable to level anything in the HeartXP page
--- *fixed* obsessive damage after sex (should now currently check with only 1 health damage. Reminder, if your partner only has 1 health remaining he/she will die, a more complex death check may be released in the next version)

- V0.5.0 [New Game is recommended - clean save may be enough]
--- Pretty much re-wrote everything
--- Large balance update (changed all values)
--- Changed Lowest Health/Magicka/Stamina the player can have to 20 (So be careful!)
--- The player now decay Health/Magicka/Stamina when over 100
--- Added in Gender Checks (Females should no longer give sperm)
--- All females should now receive sperm when there is a male partner
--- Sperm count increases when multiple males are present in the animation (there's still a chance someone will go dry tho!)
--- Partner Harm now implemented (for victims/aggressors, consensual harm will be available in a later update, the amount is determined by the character's absorption rates)
--- "Status" is now viewable in the Soul Burn MCM (Health/Magic/Energy/HeartXP)
--- High and Low Heart Focus now effect absorption and HeartXP gain at fixed amounts ( 150% on high and 50% on low )
--- You can now increase Absorption rate of Health/Magicka/Stamina in the MCM with HeartXP
--- You can now increase HeartXP gain in the MCM with HeartXP (a little ironic, I know)
--- You can now increase sperm effects in the MCM
--- A lot of "under the hood" improvements
--- *Removed* "Uninstall" option until I learn how to add it properly
--- *Removed* "Random Knowledge" Soul Burn effect
--- *Removed* "Soul Burn" Spells from .esp (they were outdated and not available by normal means anyway)
--- *Altered* Optional uncapper options (contains skills uncapped to 999 and skill multi at 0.4 for balance concerns)
--- *fixed* an issue with script updates and broken saves
--- *fixed/removed* "I feel a little weak..." debug spam when Heart Force is low
--- *fixed* females giving sperm
--- *Fix* Sperm's "Succubus Delight" effect now only works on the player as intended

- V0.4.1
--- [hopefully] Fixed Heart Force getting 'stuck' under zero
--- Fixed "Feeling a little weak..." from spamming console even when Heart Force isn't low
--- "Status" Screen now shows appropriate values (still in float form tho)

- V0.4.0 [Clean Save Required]
--- MCM menu has been added! (DfSV - Succubus heart)
--- New Status Menu Page in MCM
--- Soul Burn now available through MCM
--- Can now level individual skills at increased cost
--- Can now Increase Carry Weight just like a Skill
--- Added New HeartXP Mechanic (gained through sexual activity)
--- You can now spend HeartXP for individual skill ups
--- Added New Heart Force Mechanic (this replaces the plan for stamina effects to avoid conflicts with other mods)
--- Heart Force passively regenerates but decreases through sexual activity
--- You can now increase Max Heart Force and the regen rate of Heart Force with HeartXP
--- Heart Force now effects the benefits of sexual activity (being raped will lower it quicker than raping another)
--- Added a "player submit" effect for when the player is victim
--- Added chances to get a large load of sperm, or a dry run...
--- *Fixed* compatibility issue with health/stamina/magicka buffs
--- Added an "Uninstall" option under settings to stop quest scripts after uninstallations (doesn't work fully)
--- *Adjusted* optional uncapper settings
--- *Removed* Soul Burn spells from quest start-up (You can still find them using the console since they may return but their effects have not been updated to align with the new MCM options)
--- NOTE : Spells will be added as an option in the MCM on a later update if requested enough

- V0.2.0 [Clean Save Required]
--- SexLab Integration
--- Removed the need for SexLabUtil1 (if you were using V0.1.3 please disable the DfSV settings in SexLabUtil1)
--- With SexLabUtil1 gone there are no longer any required settings before play, just install and go!
--- Player now Gain stats during sex
--- Player now Gains bonus stats for being an Aggressor
--- Added Visuals to the "Soul Burn" skills (still lacks casting effect and menu image)
--- Sperm is now efficiently added (no more double sperm gain!)
--- *Broke* harm to opponent durring sex (you can use SexLabUtil1 if this is a needed feature)
--- *Adjusted* Sperm stat values (now that you gain stats during sex)
--- *Adjusted* and fixed a few Soul Burn effects (May need further adjustments)
--- *Adjusted* Optional uncapper settings to be closer to vanilla (now only uncaps all skills to 999 and reduces level multipliers to 0.8)

- V0.1.3
--- Concept Release
[/spoiler]

If you guys/gals have any ideas or want to help go ahead and say so! Also, keep in mind, I'm not able to test every aspect of this mod so if something is broken let me know and I'll fix it as soon as I can!

Happy Hunting!