UserData Manual

About User Data

User data is a feature that allows users to freely modify Succubus Heaven’s internal data. This function is practically “game modification” and is therefore located in the end content.
If you have not yet played the game enough, you may not want to use it.

How to use user data

1. Download the UserData.zip file that matches the version you are using from the “Default User Data” section below.
2. Unzip UserData.zip
3. Place the UserData folder in the same folder as SuccubusHeaven.exe
4. Then you can modify it as you like
* If the UserData folder is placed, the game will preferentially use the user data.

Default User Data

Release 2.0.20241117 (Latest version)
Release 2.0.20241108
Release 2.0.20241023

Cautions for using user data

User data can be modified in a wide range of ways, and save data can be rewritten if events are modified. Since it is possible to unintentionally corrupt save data, please take care to back up your data before use.

About User Data Support

We are basically unable to provide support for the use of user data due to its wide-ranging and complex nature. Please be aware of this beforehand.

Distribution of User Data

You may freely distribute your user data.
If you do not have a specific place to distribute your user data, please use the Succubus Heaven user data channel on the official Discord server.

However, please note that distribution of user data with the game itself attached is considered illegal secondary distribution.

User Data Reference

This section contains an explanation of each parameter of the user data.
Please use this page as a reference, for example, to search the page for parameters you do not understand.

Recommendations for using debug logs

You can check the debug log by pressing the F1 key when the game is running.
If an error occurs when using user data, the error log may help identify the cause.

File Structure

The file structure of the user data.
If the file itself does not exist, the default data in the game data will be used.

UserData/Data/
Arena.xml Arena data.
AttackData.xml Attack data.
Benefits.xml Benefits data.
CharacterData.xml Character data.
ConfigFieldData.xml Option data.
DungeonData.xml Dungeon data.
EffectData.xml Effect data.
EnchantData.xml Enchantment data.
FloorData.xml Floor datav
ItemData.xml Item data.
Jail.xml Jail data.
Loadout.xml Loadout data.
RoomData.xml Room data.
Training.xml Training data.
TreasureData.xml Treasure data.
UserData/Text/
English English Text Data.
Japanese Japanese Text Data.
SimplifiedChinese Simplified Chinese Text Datatd.
TraditionalChinese Traditional Chinese Text Data.
Memo
UserData/Event (event-related) is currently omitted due to the complexity of explaining event scripts.

Arena Data (Arena.xml)

This file defines the settings for the EXTRA ARENA.

Thumbnail Display Settings
NameId Name ID.
DescriptionId Description ID when unlocked.
LockedDescriptionId Description ID when locked.
UnlockFlag Unlock Flag ID.
Thumbnail Thumbnail ID.
Dungeon Settings
DungeonId Dungeon ID.
Level Number of Floors.
BranchIndex Branch Index.
FloorId Floor ID.
Block Number of Blocks.
Difficulty-Specific Settings
DifficultyLevel_Easy Settings for Difficulty “Easy”.
DifficultyLevel_Normal Settings for Difficulty “Normal”.
DifficultyLevel_Hard Settings for Difficulty “Hard”.
ScoreRate Score Rate.
MissingCount Number of Missing Persons at Start.
Benefits Benefits Set at Start.
Characters Character-Specific Initial Settings.
ImpurityRate Contamination Rate at Start.
Inventory Initial Inventory Settings.
Left Initial Settings for Left Inventory (1)
Top Initial Settings for Top Inventory (2)
Right Initial Settings for Right Inventory (3)
Bottom Initial Settings for Bottom Inventory (4)
Ids Item IDs.
Tags Item Tags.
Rarity Draw Probability by Rarity.
EnhancedValueMin Minimum Initial Enhancement Value.
EnhancedValueMax Maximum Initial Enhancement Value.

Attack Data (AttackData.xml)

This file defines the attack data and other information for each character.

ItemId Item index number to which attack information is applied.
-1 Equipped item
0 or more Character-specific item index number.
Time Effective time of hit detection.
PhysicsPowerRate Physical correction.
MagicPowerRate Magic correction.
FlamePowerRate Flame compensation.
ElectricPowerRate Lightning correction.
PoisonPowerRate Poison correction.
ShieldPowerRate Shield correction.
ExplosionPowerRate Explosion correction.
ImpactRate Impact Force Compensation.
Infinite at -1.
StaminaRate Stamina damage rate.
MaxStamina Maximum stamina damage.
Miasma Miasma damage.
Ecstasy Sexual damage.
EcstasyRate Sexual Damage rate
Percentage of current sexuality.
Bust Bust damage.
Clitoris Clitoris damage.
Vagina Vaginal damage.
Anal Anal damage.
Impurity Impurity damage.
ImpurityRate Impurity damage rate
as a percentage of current Impurity.
IntravaginalSemen Increased semen volume into vagina.
IntestinalSemen Semen increase to anus.
Trail Sword line display.
HitstopTime Hit-stop time.
HitstopRate Percentage of time elapsed during hit stop.
KnockbackPriority Knockback priority.
KnockbackForce Knockback power.
KnockbackTime Knockback time.
IsDown Whether the attack can down the target.
IsDownWhenDead Attacks that can bring down the target of death.
IsForcedDown Attacks that force the target to go down.
HitType Classification of Hit Judgment
EnemyAll: Only hits the enemy.
SelfAll: Only hits self.
Friend: Only hits an ally.
EnemyStand: Only hits a standing enemy.
SelfStand: Only hits standing self.
AllOtherThanSelf: Hit everything but self.
All: Strikes everything.
AllStand: hits everything standing.
AllStandOtherThanSelf: Strike all standing opponents except self.
HitEffectId hit effect ID.
SpawnRestrainter ID of character to be generated on hit.
SpawnRestrainterAttackId ID of the attack that the generated character will perform on the target.
Category Attack Classification
Normal Normal
Special Special
Throw Throw
IgnorePoison Disables poison damage.
IgnoreJustDodge Ignores just evasion judgments.
All Damage animation: All states.
Full Damage animation: full magical robe.
UpperBody Damage animation: Breasts exposed.
LowerBody Damage animation: lower half of the body exposed.
Nude Damage animation: full nudity.
Rate Damage animation: Probability.
Bind Damage animation: Restraint animation.
BindTime Damage animation: duration of restraint animation.
Finish Damage animation: Finish move.
LowBind Damage Animation: Weak Restraints
Restraints that are released by other restraint attacks or damage.
RandomStartTime Damage Animation: Maximum time of start time random
No random if less than 0
State Damage Animation: Transition condition depending on the target character’s “Body Condition.
Normal Normal (same as none specified)
StandEcstasy Standing and about to climax.
StandEcstasyImpurityHeavy Severely contaminated and likely to climax while standing.
Stun During stun (stun = inability to act while standing = masturbation, etc.)
StunImpurityHeavy Stunned by heavy Impurity.
StunEcstasy I’m going to climax during the stun.
StunEcstasyImpurityHeavy Severely contaminated and likely to climax during stun.
ConstrainedEcstasy I’m going to climax while restrained.
ConstrainedEcstasyImpurityHeavy Severely contaminated and likely to climax while restrained.
DownEcstasy I’m going to climax while I’m down.
DownEcstasyImpurityHeavy Severely contaminated and likely to climax with a collapse.
FeelGood Pleasant (more than 50% sexual)
FeelGoodImpurityHeavy Feels good with heavy Impurity (more than 50% sexual)

Benefits data (Benefits.xml)

This file defines the parameters of each benefit (blessing/curse)

Priority Priority (Unlock Order)
ScoreRate Score Rate to Add.
LotteryWeight Draw Probability.
AttackPowerRate Attack power modification.
MagicPowerRate Magic attack power modifier.
NormalAttackPowerRate Normal attack power modifier.
SpecialAttackPowerRate Special attack power modifier.
ThrowingAttackPowerRate Throwing attack power modifier.
PowerUpRateWhenLonely Lonely enhancement modifier.
BareHandsAttackPowerRateInProportionToFreeInventory Bare hand attack power modifier proportional to inventory free.
DamageRate Damage modifier.
ImpactDamageRate Impact damage modifier.
PoisonDamageRate Poison damage modifier.
ImpurityRecoveryRate Poison Recovery modifier.
ImpurityDamageRate Impurity Damage modifier.
ImpurityDamageRateWhenVirgin Impurity damage modifier when virgin.
EcstasyDamageRateWhenVirgin Virginity damage modifier.
MiasmaDamageRate Miasma damage modifier.
ItemConsumptionRate Rate value of item consumption.
ExplosionRateWhenBreakItems Explosion modifier when items are destroyed.
AutoThrowItemRateWhenAttack Auto item throw modifier when attacking.
TreasureLuckRateWeapon Weapons luck.
TreasureLuckRatePotion Potion luck.
TreasureLuckRateOddStone Odd stones luck.
TreasureLuckRateDust Dust luck.
TreasureLuckRate Chest luck.
RoomRiskRate Room Risk modification value.
ItemDropRate Corrected value of probability of possession of enemy items.
AddUsageCountNewPotionRate Modified value of the probability of increasing the number of times newly obtained water pills are used.
FriendMaxHpRate Allied maximum HP modifier.
RecoveryHpWhenRoomChange HP recovery when moving to a room.
RecoveryStaminaRateInBattle Modified value of stamina recovery during battle.
RepairItemWhenRoomChange Item repair value when moving to a room.
EnemyTrackingRate Enemy tracking modifier.
CanNotAvoid Unavoidable.
ClitorisMaxSensitivity Maximum pubic sensitivity.
VaginalMaxSensitivity Maximum vaginal sensitivity.
AutoBattle Auto Combat.
FireEnchant automatic flame enchantment.
BonusBenefits Benefit Bonus.
LostVirginGuard Prevents loss of virginity once and explodes
String is the name of the benefit to be removed upon activation.
AllowFriendlyFire Friendly fire allowed.
AlwaysNaked Always naked.
CanNotPutItems Cannot place items.
MagicForbidden Prohibits the use of magic.
UnknowItemsNameAndDescription Item name and effect will be unknown.
IgnoreBenefits Benefit nullification.
CanNotPrayAltar Cannot pray at the altar.
CanNotThrowItems Cannot discard items.
EcstasyDamageShared Sexual damage shared among allies.
PhysicalDamageConvertedEcstasyDamage Physical damage is accompanied by sexual damage.
ExcludedCharacters Excluded characters.
AddCurseWhenDownStairs Curse added every time you go down the stairs.
RandomSelectBenefits Random draw for benefits at the start of the game.
AutoCounterOnJustDodge Automatically counters on successful Just Dodge.
ImmuneToSpiderSilk Nullifies spider silk floors and sticky webs.
FriendMaxStaminaRate Ally initial stamina change rate.
CharmRateForSummonedEnemies Chance for summoned enemies to be charmed.
MagicClothExplosionDamageRate Explosion damage rate of magic cloth.
SensitivityChangeRate Sensitivity change rate.
ItemAddEnhancedValue Additional enhancement value for items.
MaxImpurityPrevented Prevents reaching maximum contamination.
DisableAutoRestraintResistance Disables player’s automatic restraint resistance.
ChestTrapChangeRate Change rate of chest trap probability.
DisableCharacterChangeInBattle Prevents changing controlled character during battle.
CharmRateWhenEcstasy Chance to be charmed during ecstasy.
AlwaysFutanari Always in futanari state.
AddDefenceRate Adds defense rate. (allies only)
NoPants Insertion occurs if the magic cloth is even slightly damaged.
DustItemAddEnhancedValue Enhancement value added to dust items.
Hide Does not display in the list of benefits during gameplay.
NoLottery Not included in lottery draws during gameplay.
CannotSettingTogether Benefits that cannot be set together.

Character Data (CharacterData.xml)

This file defines the parameters of each character.

Initial Inventory
InitialInventory Initial Inventory Settings.
Left Initial Settings for Left Inventory (1)
Top Initial Settings for Top Inventory (2)
Right Initial Settings for Right Inventory (3)
Bottom Initial Settings for Bottom Inventory (4)
Ids Item IDs.
Tags Item Tags.
Rarity Draw Probability by Rarity.
EnhancedValueMin Minimum Initial Enhancement Value.
EnhancedValueMax Maximum Initial Enhancement Value.
Parameter Definition
RefilledPotionIDFromEjaculation Potion ID refilled into the opponent’s empty bottle through internal ejaculation.
MaxHp Maximum HP, magic clothing for allies.
Hp Current HP.
RecoveryHpRate Percentage of HP recovered after returning from down.
MaxStamina Maximum Stamina.
Stamina Current Stamina.
PhysicsDamageRate Physical Damage Rate.
MagicDamageRate Magic Damage Rate.
FlameDamageRate Flame Damage Rate.
ElectricDamageRate Electric Damage Rate.
ExplotionDamageRate Explosion Damage Rate.
MaxPoison Maximum Poison Tolerance, if max.
MaxCharm Maximum charm capacity; exceeding this value causes charm.
MaxTough Maximum toughness, resistance to fright.
UnlockingPower ability to open locks.
MaxEcstasy maximum sexual tolerance.
Impurity current pollution (maximum pollution is fixed at 1000)
Throwing throwing power.
DownTime Recovery time when down.
Bust Breast.
Clitoris Clitoris.
Vagina Vagina.
Anal Anal.
Sensitivity Current Sensitivity.
MaxSensitivity Maximum Sensitivity.
Pregnancy Not used.
Hymen Has virgin membrane.
IsPartyOn Being in a party.
AIParamater Parameters related to AI behavior.
BestAttackTypes AI: Good at attacking (actively tries to use)
BadAttackTypes AI: Unskilled attack type (does not try to use)
EnemySearchDistance AI: Enemy detection distance.
EnemyPriorityTargetRange AI: Range of priority enemy targets.
DistanceMin AI: Minimum distance.
DistanceMax AI: Maximum distance.
Angle AI: Angle.
EnemyTrend Enemy Type.

Dungeon Data (DungeonData.xml)

Dungeon configuration data definition file.

Definition of Dungeon Data
Opening Dungeon data for opening.
Story Dungeon data for story.
Arena_TripleSpawner Arena: Dungeon data for Triple Spawner.
Arena_Division Arena: Dungeon data for Division.
Arena_ArachnesRage Arena: Dungeon data for Arachne’s Rage.
Arena_SinkInDirtyWater Arena: Dungeon data for Sink in Dirty Water.
Arena_MirrorMatch Arena: Dungeon data for Mirror Match.
Arena_CounterattackSuccubusSisters Arena: Dungeon data for Counterattack of the Succubus Sisters.
Arena_GuardianHordes Arena: Dungeon data for Guardian Hordes.
Arena_CursedTreasureVault Arena: Dungeon data for Cursed Treasure Vault.
Arena_TrialOfTheFist Arena: Dungeon data for Trial of the Fist.
GameOver Dungeon data for game over.
EventDemo Dungeon data for event demo.
Floors Definition of hierarchy.
FloorSize Floor size.
DisplayLevel Displayed floor count
Used when you want to specify the displayed floor count regardless of the actual floor count
If -1 is specified, the floor count will be hidden
Id Specify Floor ID defined in FloorData.
FixedRooms Definition of fixed rooms, rooms not set here are lottery from normal rooms.
Block Fixed Rooms: Number of blocks in which rooms appear.
RoomId Fixed Rooms: Specify the ID of the room, ID defined in RoomData.
Tags Fixed Rooms: Specify by room tag, rooms corresponding to the tag defined in RoomData are lottery from the rooms.
Rate Fixed Rooms: Lottery probability, if multiple rooms are specified in the same block, they will be drawn with this probability.
EnemyTrends Types of enemies that appear in the hierarchy.
TreasureGroup Specification of item lottery table
Definition of Item Lottery Table
Treasures Definition of the item lottery table.
Tags Specification of item tags.
EnhancedValue Enhanced value.
EnhancedValueMin Minimum enhanced value.
EnhancedValueMax Maximum enhanced value.
Rate Lottery probability.

Enchant Data (EnchantData.xml)

Definition file for enchant data.

None No enchantment.
Fire Flame Enchantment.
ChargeMagic For displaying magic pooling state & effects.
ConvertFlamePowerRate Percentage of attack power converted to flame damage.
Damage Amount of damage regularly dealt to items during enchantment.

Floor Data (FloorData.xml)

Definition file for hierarchical data.

NameId Floor Name ID.
RoomTrend Room type.
RiskRate Risk multiplier.
TrapDoorRate Door generation probability?　Might not be used.
Trainers Sexual trainers. Reflecte in development progress of missing friend.
Music Default song ID for floor.
GameOverRoomId Game over ID.

Item Data (ItemData.xml)

Item data definition file.

IconName Icon Name ID.
InteractIcon Interact Suggested Icon.
UnknowItemId ID for item name and item description when unknown.
MinUsageCount Minimum number of uses.
MaxUsageCount Maximum number of uses.
MinDurability Min>Physicaltd>
MaxDurability Maximum durability.
PhysicsPower Physical Attack Power.
MagicPower Magic Attack Power.
FlamePower Flame Attack Power.
ElectricPower Electric Attack Power.
ExplosionPower Explosion Attack Power.
PoisonPower Poison Attack Power.
CharmPower Charm Attack Power.
ShieldPower Shield Attack Power.
FutanariPower Futanari Attack Power.
SlimeParasitismRate Slime Parasitism Rate.
Impact Impact Damage.
GrowUpAttackRate Growth: Attack Ratio.
GrowUpDefenceRate Growth: Defense Ratio.
StaminaDamageRate Stamina Damage Ratio.
MaxStaminaDamage Maximum Stamina Damage Correction Value.
Ecstasy Ecstasy Damage.
EcstasyRate Ecstasy Damage Ratio.
Bust Breast Damage.
Clitoris Clitoris Damage.
Vagina Vagina Damage.
Anal Anal Damage.
Impurity Weapon Performance: Pollution Damage Correction Value.
ImpurityRate Weapon Performance: Percentage Pollution Damage Correction.
AttackRange Attack Range
Used for AI decision-making.
AutoAttackRange Auto-Attack Range
Range within which automatic attack adjustment is applied.
AttackType Attack Type
Unarmed Bare Handed
Sword One-Handed Sword
Drink Drink
None None
OddStone Odd Stone
CrystallineStone Crystalline Stone
Dagger Dagger
Katana Katana
GreatSword Great Sword
GreatMace Great Mace
ShockWave Magic: Shockwave
Explosion Magic: Explosion
LightningShock Magic: Lightning Strike
PiercingLight Magic: Piercing Light
StoneBullet Magic: Stone Bullet
GuardianLight Magic: Guardian Light
Charm Magic: Charm
LightningDischarge Magic: Lightning Discharge
BloodSpike Magic: Blood Thorns
PoisonousClouds Magic: Poisonous Clouds
Purification Magic: Purification
DarkRobe Magic: Dark Robe
Tub Magic: Tub
Decoys Magic: Decoys
ThunderCraw Magic: Thunder Claw
DarkStroke Magic: Dark Stroke
GoldenTub Magic: Golden Tub
WhirlingStoneBullet Magic: Whirling Stone Bullet
StaminaRecoveryCircle Magic: Stamina Recovery Circle
StoneFall Magic: Falling Stone
WindCutter Magic: Wind Cutter
MagicSword Magic: Magic Sword
Hide Magic: Hide
MagicBattery Magic: Magic Battery
HitEffectId Hit Effect ID.
BrokenItemId Item ID when broken.
DepletedItemId Item ID when depleted.
ConvertItemId Item ID after conversion.
ConvertEfficiency Durability Conversion Efficiency at Conversion.
Rarity Rarity (Dust, Common, Rare, Legend, Unique without specification)
Tags Item Tags
Tags are used in item lottery processes and others.
OwnerType Owner Type
Anyone or Magician.
UnlockLoadout Loadout ID unlocked upon acquisition.

Jail Data (Jail.xml)

This is the definition file of jail data.
When a missing ally is placed in a jail, this data is used to determine which additional enemies will appear there and which raper.

EnemyTrends Type of enemy to be placed.
RiskMin Minimum Risk.
RiskMax Maximum Risk.
Raper Designation of the rapist and restraining attack.

Loadout Data (Loadout.xml)

This is the definition file for loadout data.

NameId Loadout Name ID.
DescriptionId Loadout Description ID.
LockedDescriptionId Locked Loadout Description ID.
Thumbnail Thumbnail ID.
ScoreRate Score Rate Addition Value.
Characters Character-Specific Initial Settings.
HpRate HP Rate.
ImpurityRate Contamination Rate at Start.
Inventory Initial Inventory Settings.
Left Initial Settings for Left Inventory (1)
Top Initial Settings for Top Inventory (2)
Right Initial Settings for Right Inventory (3)
Bottom Initial Settings for Bottom Inventory (4)
Ids Item IDs.
Tags Item Tags.
Rarity Draw Probability by Rarity.
EnhancedValueMin Minimum Initial Enhancement Value.
EnhancedValueMax Maximum Initial Enhancement Value.
Bust Breast Settings Data.
Clitoris Clitoris Settings Data.
Vagina Vagina Settings Data.
Anal Anal Settings Data.
Sensitivity Sensitivity.
MaxSensitivity Max Sensitivity.
Milk Stored Breast Milk Amount.
Futanari Futanari Transformation Duration in Rooms.
LoveJuice Stored Love Juice Amount.
Semen Stored Semen Amount.
BirthProbability Birth Probability.
A value greater than 0 is considered “Slime Parasitism”.
During Slime Parasitism, this value slightly increases with each fetal movement.

Room Data (RoomData.xml)

Definition file of room data.

NameId Room Name ID.
RoomTrend Room Type.
Tags Room Tag.
RiskMin Minimum Risk.
RiskMax Maximum Risk.
Music Room-specific music, preferred over floor.
ClearPursuers Clear tracker on room entry.
DontSave Do not auto-save when transitioning to this room.
GameOverRoomId Room-specific game over ID, priority over tier.
LostItemDiscoveryRate Correction value for lost item placement probability.
LostItemDiscoveryNumber Maximum number of lost item placement.
EnemyTrends The type of enemies that appear in that room, which takes precedence over the dungeon data.

Training Data (Training.xml)

This file defines the content of training for the missing ally. Training is executed at each room transition.

Bust Increased breast sensitivity.
Clitoris Increased clitoris sensitivity.
Vagina Increased vaginal sensitivity.
Anal Increased anal sensitivity.
IntravaginalSemen Increased vaginal ejaculation.
IntestinalSemen Increased anal ejaculation.

Treasure Data (TreasureData.xml)

Definition file for the contents of treasure chests, tars, coffins, eggs, etc.

TreasureTrend Types of Treasures.
TreasureRank Ranks of Treasures.
Rarity Rarity of items in treasure.
Capacity Number of items in treasure.
AdhesionSettings Adhesive Thread Settings
Rate Probability
Min Minimum number of sustained rooms
Max Maximum number of sustained rooms
EnhancedValueAddMin Minimum enhancement value added to dropped items
EnhancedValueAddMax Maximum enhancement value added to dropped items
EnhancedValueLimitMin Minimum enhancement value limit for dropped items
After all enhancement value rolls, this value will not be exceeded