# Installation
1. Mods are installed by dropping **unzipped** .zip files in the Battle Brothers data directory (e.g. C:\GOG Games\Battle Brothers\data). Leave them unzipped! You don't have to worry about mod load order.
2. Required mods: [Legends mod](https://www.nexusmods.com/battlebrothers/mods/60) (gameplay overhaul; you may need the latest from their GitHub. Install both the asset and gameplay mods), [Modern Hooks](https://www.nexusmods.com/battlebrothers/mods/685), and [MSU](https://www.nexusmods.com/battlebrothers/mods/479)
3. Drop the .zip downloaded from here into the data directory
4. In Legends mod settings, enable **Battle Sisters** (required for female characters to appear in the recruit pool)
The [GitHub repository](https://github.com/PerplexedPeach/battle_brothers_lewd) has the latest version and updated roadmap.
# Getting Started
This mod centers on a **female avatar** character. You need to play an **avatar origin** (Lone Wolf, Berserker, Courtesan, or any origin that gives you a player-controlled main character).
**Female avatar**: If your avatar is female from the start, you are ready. Progress through the heel event chain (see Transformation Event Chains below) to unlock traits, abilities, and perk trees.
**Male avatar**: If your avatar is male, you need to fight **Hexen** in battle. After the fight, a curse event chain will trigger that gradually transforms your character into a woman. Once the transformation is complete, the normal progression (heels, Dainty, Delicate, Ethereal) takes over.
**Progression summary**:
1. Gain company renown to trigger the first heel event. Wear heels taller than your current skill to level up.
2. Progress through heel stages to earn the **Dainty** trait, then **Delicate**. Each unlocks new perk trees and sex abilities.
3. Take damage in combat to unlock **Masochism** tiers (requires Delicate). Stay in the south to trigger events.
4. Cause enough partner climaxes and fight ghosts to trigger the **Ethereal quest chain**: three boss fights guided by a fox spirit, culminating in a supernatural transformation. This is the pinnacle: supernatural allure, succubus perk tree, tail weapon, and Blink teleport.
Your party members will react to your progression. Male brothers may be affected by your allure, leading to events that shift based on your Domination/Submission score.
# Overview
This mod brings lewdness into the world of Battle Brothers in an immersive, balanced, and gratifying way. Its contents are NSFW and only for adults 18+!
New mechanics, event images, character sprites, item sprites, custom sounds, and writing are tightly integrated to provide a quality experience. All event writing is documented [on the wiki](https://lewdhammer.miraheze.org/wiki/Battle_Brothers) if you just want to read them.
Sexual themes include: female protagonist, high heels, transformation, bondage, domination loss, submission, seduction, domination, harassment, battlefuck
# Features
## Allure and Beauty System
- **Allure** is a new character stat derived from your traits, equipment, melee defense, and heels. It is the core currency for seduction and beauty mechanics.
- **Entrancing Beauty**: A passive aura that can inflict Horny (or on crit, Horny + Stunned) on nearby enemies each turn and after movement. Chance scales with Allure vs target Resolve and distance. Allied male brothers can also be affected, though they get a significant Resolve bonus against it.
- **Pheromones**: Self-cast buff that boosts Entrancing Beauty's chance and adds a pink glow effect.
Dynamic sounds and animated quotes on skill use (Entrancing Beauty shown):
- **Seduce**: Ranged active ability (up to 4 tiles) that charms male enemies to fight for you. Chance: 50 + (Allure - Resolve) - 10 per tile distance. Full hit chance breakdown shown per target on hover.
## Pleasure and Climax System
- All characters with lewd traits gain a **Pleasure** resource in combat. When Pleasure reaches PleasureMax, the character has a **Climax**, applying a temporary debuff.
- **Orgasm Defeat**: Characters can be defeated by accumulating enough orgasms. Most enemies fall after 1; tougher enemies survive more based on their Resolve and miniboss status. Player characters have much higher thresholds from traits and perks, and go unconscious (recoverable) rather than dying.
- Pleasure sources: masochism (damage taken), and five sex ability types (see below).
- Enemies with humanoid bodies automatically gain PleasureMax based on their Resolve.
## Sex Abilities (5 types, 3 tiers each)
- **Hands**: Clumsy Groping / Handjob / Skilled Handjob. Scales with Domination score.
- **Oral**: Clumsy Oral / Oral Service / Deepthroat
- **Feet**: Foot Tease / Footjob / Heel Domination
- **Vaginal**: Straddle / Riding / Cowgirl. Establishes mount (visual sprite overlay).
- **Anal**: Submit / Take It / Pain is Pleasure. Scales with Submission score.
Each ability type has its own **Mastery** track that levels up through use, unlocking stronger tiers with unique icons, sounds, and flavor text. Hit chance displays Allure vs Resolve breakdown on hover. Pleasure formula factors in allure, relevant stat scaling, mastery, fatigue vulnerability, and mount bonuses.
**Mount System**: Vaginal and anal abilities can establish a mount (one character on another). Mounted targets get visual silhouette sprites showing mounters. Multiple mounters supported with front and back silhouettes.
## Domination / Submission System
- A dynamic **Dom/Sub tracker** shifts during combat based on who causes climaxes.
- **Dom tiers**: Assertive, Commanding, Dominant, Mistress. Boosts Hands ability scaling.
- **Sub tiers**: Yielding, Submissive, Obedient, Tamed. Boosts Anal ability scaling and unlocks Surrender to Pleasure.
- **Surrender to Pleasure** (sub-gated active): Costs all remaining AP. Massively boosts mounter's pleasure output and your own pleasure vulnerability, scaling with AP spent and sub score.
- Each tier has unique icons and tooltip descriptions.
## Enemy Sex AI
- Horny enemies gain access to sex abilities: **Grope**, **Force Oral** (requires mount), and **Penetrate** (establishes mount).
- Custom AI behavior prioritizes sex attacks on vulnerable targets over normal combat actions.
- Hit formula uses Melee Skill vs target Melee Defense; Horny targets are auto-hit.
- **Allied Harassment**: Male brothers affected by Horny may grope nearby female allies. Chance scales with target Allure, groper Resolve, and Dom/Sub score. Gated behind the Horny status.
## Horny Status Effect
- 2-turn debuff: -15 Resolve, -15% Initiative, -5 Melee Defense, sex abilities auto-hit.
- Applied by Entrancing Beauty aura, Shameless perk climax, and sex ability hits (50% chance).
- Enemies with Horny gain sex abilities and a custom AI behavior.
- Visual head overlay effect on affected characters.
## Four Perk Trees (26 perks total)
**Seduction Arts** (unlocked by Dainty/Delicate traits):
- 5 ability unlock perks: Nimble Fingers, Oral Arts, Foot Tease, Mounting, Offering
- Sensual Focus: +10% passive pleasure dealt + Open Invitation toggle (enemies auto-hit you, but you deal +15% pleasure)
- Alluring Presence: First sex ability use per target gets a hit bonus
- Practiced Control: -50% self-pleasure from sex abilities
- Insatiable: +3 AP when you cause a climax
- Transcendence: Climax removes penalties, +10 Allure, overflow pleasure preserved
**Endurance** (unlocked by Masochism + Delicate traits):
- Willing Victim: +10 Allure while mounted/grappled
- Embrace Pain: Moan + horny-on-hit scaling with sub score
- Pliant Body: +50% pleasure reflection dealt to partner
- Pain Feeds Pleasure: +50% masochism damage to pleasure conversion, +33% injury threshold
- Shameless: Climax makes adjacent enemies Horny + deals pleasure to mount partner
**Succubus** (unlocked by Ethereal trait):
- Predatory Instinct: +10% hit and +15% damage with regular attacks against Horny targets
- Essence Feed: +3 Allure, +5 Initiative, +3 Resolve per Horny enemy within 2 tiles
- Soul Harvest: Heal when you cause a climax or kill a Horny enemy
- Unquenchable: +3 Allure per climax you cause this battle (stacks, resets between fights)
**Debauchery** (unlocked for male Outlaw backgrounds):
- Wandering Hands: Unlocks Grope ability
- Exploit Weakness: +25% armor damage against females
- Carnal Knowledge: Unlocks Force Oral and Penetrate Vaginal
- Brutal Force: +25% pleasure dealt, +1 orgasm threshold on targets
- Forced Entry: Unlocks Penetrate Anal
- Iron Grip: Restrain skill (roots mounted target, +25% pleasure vulnerability)
- Conqueror: Morale boost, fatigue recovery, and domination gain when you cause a climax
## Transformation Event Chains
**Heel Progression (Dainty / Delicate)**:
- Stage 0 to 1 event triggers based on company renown; further stages require heel skill thresholds.
- Increase heel skill by wearing heels taller than your current height. The bigger the difference, the faster you progress.
- Custom heel walking sounds on different terrain types!
- Progression: Normal to Dainty to Delicate, each granting new traits, allure bonuses, and perk tree access.
Transformation into the perfect candidate for the harem of the Eastern Emperor:
**Masochism Progression**:
- After achieving the Delicate trait, take damage in combat and stay in the south to trigger masochism events.
- Three tiers of masochism, each increasing pleasure from damage taken and allure.
**Ethereal Quest Chain**:
- After reaching Delicate with enough climaxes, fighting ghosts triggers an encounter with the spirit of an ancient fox spirit who offers a pact.
- Three sequential combat stages, each with a unique boss:
- **The Faithless**: A bandit camp led by a named boss who spurned the spirit in life.
- **The Beast**: An unhold lair with "The Ancient One", a boss with a unique piledriver ability that grabs and pleasures targets.
- **The Killer**: A broodthing lair in a corrupted swamp. A kraken-style tentacle boss with 8 tentacles, an AoE pleasure attack (Ravage), and a custom ensnare that applies pleasure and Horny per turn.
- The final stage culminates in the spirit merging with you and the Ethereal transformation. Rich multi-screen narrative throughout.
- Culminates in the Ethereal trait: the pinnacle transformation with enhanced allure, additional perk points, unique cosmetic changes, and the Succubus perk tree.
  
**Ethereal Abilities**:
- **Succubus Tail**: A natural weapon with three abilities: Tail Lash (ranged attack scaling with allure), Whip Into Shape (ally morale boost with horny chance), and Playful Slap (high horny chance, works on female enemies). Unlocked via event chain after reaching Ethereal.
- **Blink**: Short-range teleport (1-4 tiles). Breaks free of roots, nets, and mounts. Ignores Zone of Control. Instant disappear/reappear with pink glow. Unlocked via event chain at high climax count.
**Hexen Curse (Male-to-Female)**:
- Male avatars who fight Hexen can be cursed, triggering a two-stage transformation into a female character.
- After transformation completes, the normal heel/Dainty/Delicate/Ethereal progression takes over.
## Items
- Multiple heel types as accessory items with varying height and allure bonuses.
- Cursed items that cannot be unequipped.
- Custom item sprites.
## Visual and Audio
- Custom character sprites (body, head, accessories, piercings, cum facial layer).
- Dynamic heel walking sounds on different terrain.
- Unique sounds per sex ability type.
- Animated quote overlays on skill use (charm quotes, masochism quotes).
- Mount silhouette sprites (front and back) showing characters in mounted positions.
- Custom event images for all transformation chains.
- Per-tier icons for all sex abilities, masteries, perks, and dom/sub states.
# Compatibility
- **Required**: Legends mod, Modern Hooks, MSU
- **Optional**: Rise of the Usurper (ROTU) core. Cosmetic adaptations (skin tone, eye glow, tattoo clearing) are applied automatically when detected.
# Roadmap
**Random Events and Immersion**
- Allure-based party events: male brothers react to your growing beauty (requires male party members)
- Dom/Sub-flavored events: scenes shift based on whether you dominate or submit in battle
- Ethereal perspective events: written from the viewpoint of a being who has transcended mortality
- Ethereal sub events: the particular humiliation of a supernatural being choosing to kneel before lesser creatures
**Species-Specific Content**
- Goblin sex AI: swarm mechanics, multiple goblins on one target
- Orc sex AI: brutal, high-damage pleasure, stronger mounting
- Unhold sex AI: size difference mechanics, unique grapple/pin
- Wolf/beast sex AI: pack mechanics, knock-prone-then-mount
- Spider content: web/cocoon mechanics, parasite/egg system
**Post-Defeat Content**
- Post-defeat sex events and enemy recruitment via orgasm defeat
- Fetish acquisition from being defeated by specific creature types
**Other**
- Body modification corruption series
- Sexy armor
- Back hair sprite layer for long hairstyles
- Balance tuning pass
# For More
Check out the (18+) Discord [https://discord.gg/W4qkrNwUMk](https://discord.gg/W4qkrNwUMk) for lewd mods for this and other games.
See nexus link
