Sex Grants Experience 1.8

Description

I use the Experience mod and decided I would like to gain some experience when engaging in sexual acts. I originally had created a simple version of this using SL Triggers, but  the file I made for it was getting difficult to maintain as I added support for more tags, and I wanted to gain exp from OStim scenes as well (I've mostly switched to using OStim for all human-only scenes and SexLab for creature ones). So this is a simple mod that grants experience whenever the player character engages in a sex scene.

The amount of experience granted is based on the tags (SexLab) or action types (OStim) associated with animations that are played. This is configurable in a json file. A default configuration is included for reference.

For SexLab I only grant exp based on the animation that was playing when the scene ended, as generally only one animation is played.

For OStim I detect every change and evaluate them separately, then take the maximum value over all actions and grant exp from that.

There is also an MCM to control a few settings.

MCM Settings

MCM is called "Sex Grants Experience". It contains:

• Two flags indicating which of SexLab and Ostim were detected - not configurable, just informative
• No Match EXP - A base amount of experience granted if the animation doesn't match any entries in the config file
• Creature Multiplier - A multiplier applied to any scene involving at least one creature. Setting e.g. 0.25 results in a 25% increase in EXP from the base amount determined from the config file. Setting this to 0 results in no additional EXP
• Per Actor Multiplier - A multiplier applied to any scene involving more than actors than the configured threshold. Setting e.g. 0.1 results in a 10% increase in EXP per actor (other than the player character) involved. So with that configuration and the default threshold of 3 a threesome would result in a 20% increase in EXP. Solo scenes or scene with just one other actor do not apply this multiplier.
  • Per Actor Threshold - How many actors are required in a scene for the per actor bonus to be applied. Setting this to 3 (the default) means only threesomes or higher apply the bonus.
  • Per Actor Behaviour - how the per actor bonus should be calculated. Three options:
    • Count all actors - in this case, assuming a threshold of 3 and multiplier of 0.1, a threesome would result in 30% more exp than a two-person scene
    • Count all actors except player - in this case, assuming a threshold of 3 and multiplier of 0.1, a threesome would result in 20% more exp than a two-person scene. This was the behaviour prior to v1.7, and is the default
    • Count actors at/above threshold - in this case, assuming a threshold of 3 and multiplier of 0.1, a threesome would result in 10% more exp than a two-person scene
• The two multipliers are added together - so a threesome with a creature in it results in a 45% increase (0.25 + 0.1 + 0.1) with the example settings
  • As a complete example: let's say we set Blowjob to 20 exp, and perform a scene where the PC and another actor give a blowjob to a horse. Then the total exp granted will be 20 * (1 + 0.25 + 0.1 + 0.1) = 29
  • EXP is always rounded down, as the final value cannot contain a decimal
• EXP Loss - Toggle for EXP loss system. EXP is lost if the framework decides that you were a victim in the scene, based on the usual exp calculation with an additional multiplier described below.
  • Allow Negative EXP - whether lost exp should allow going below 0 progress in the current level. Note that levels will not be lost, but if your exp is negative it may appear that you aren't gaining any until you go back above 0
  • EXP Loss Multiplier - a multiplier applied to exp when it is being lost. At 0 this eliminates exp gain instead of losing, at 1 it would cause you to lose the same amount of exp that you would have otherwise gained if you were not a victim in the scene
• Cooldown - Toggle for whether there should be a cooldown between granting of EXP
  • Cooldown Hours - Number of hours after being granted EXP during which no more EXP will be granted
  • There is currently no UI for indicating your cooldown status. If you have the debug messages enabled and no EXP is granted as a result of being in cooldown, it will display a message of the form "No EXP granted, still under cooldown until MM/DD/YYYY HH:MM", with appropriate values filled in.
• Require Orgasm - Toggle for whether an orgasm is required for EXP to be granted. If true, only scenes where at least one actor orgasms will grant EXP to the player. If false, all scenes will grant EXP.
• Solo scenes grant EXP - Toggle for whether solo scenes should grant EXP. If false, only scenes involving at least two actors will result in EXP being granted.
• And two options controlling where debug messages are displayed, if at all

Configuration File

The configuration file is located at SKSE/Plugins/SexExp/config.json. It is a simple key/value association, assigning a tag or action type a specific experience value. Note that it is case sensitive. There is a file included, but as an example you can write something like this:

{
    "Masturbation": 10,
    "Blowjob": 20,
    "Vaginal": 30,
    "vaginalsex": 30
}

If multiple tags / action types match, it chooses the highest value. So with this config if a scene that is tagged with both "Blowjob" and "Vaginal" is performed it will grant 30 exp. The order in the config file is irrelevant.

Requirements

SkyUI - for the MCM

Experience

JContainers

PapyrusUtil

SexLabFramework - if you want it to grant exp for SexLab scenes - soft requirement

OStim Standalone - if you want it to grant exp for OStim scenes - soft requirement

And all requirements of these mods

This has only been tested on Skyrim SE v1.5.97, because that's all I have installed. My code is all Papyrus, so it may work if all the requirements work on newer versions.