Randomized Disguise Self

Randomized Disguise Self gives Baldur's Gate 3's Disguise Self spell real visual variety.

Vanilla Disguise Self always produces the same fixed illusion for each race, body, and gender option. This mod rerolls the illusion's individual features — face, hair, hair color, eye color, skin tone, and (where the option supports them) beard, piercings, horns, Dragonborn features, makeup, and tattoos — every time you cast. Don't like the look you got? Cast the same disguise again to reroll it.

The mod uses vanilla game assets only and never touches your real character's appearance.

## Requirements

- Baldur's Gate 3 on PC
- Norbyte's BG3 Script Extender: https://github.com/Norbyte/bg3se

This mod relies on Script Extender Lua to roll and apply a disguise at cast time. It is not a static-only toolkit mod.

## Installation

1. Install BG3 Script Extender.
2. Download RandomizedDisguiseSelf.pak.
3. Place RandomizedDisguiseSelf.pak in your Baldur's Gate 3 Mods folder:

  text <br />  %LOCALAPPDATA%&#92;Larian Studios&#92;Baldur's Gate 3&#92;Mods <br /> 

4. Enable the mod in BG3 Mod Manager or another BG3 mod manager.
5. Save/export your load order.
6. Launch the game and cast Disguise Self.

Do not install the Script Extender DLL from this mod. Script Extender is a separate dependency and must be installed separately.

## What It Does

When you cast a Disguise Self option, the mod rolls a fresh set of appearance features and applies them to that disguise's illusion before it is built. The disguise keeps the race, gender, and body type you chose — only the look within that choice is randomized.

What gets randomized each cast:

- Head / face and hair style from a large, body-fitted pool for that race and body.
- Hair color, eye color, and skin tone.
- Beard on races that support it (female beards are extremely rare).
- Piercings — a whole coordinated set (matched lobes plus brow, helix, septum, etc., depending on the set), applied at once just like character creation. Dragonborn get their own facial-piercing variants.
- Horns, Dragonborn features, makeup, and tattoos for the options that support them.

Two touches keep results believable:

- Race-appropriate palettes. Skin and eye colors are locked to what character creation allows for a rolled subrace, so you won't get a blue-skinned human. The disguise also identifies as that subrace (for example, an examined Dwarf disguise may read as Duergar).
- Natural hair bias. Every race shares the same character-creation hair palette, which includes vivid dye colors. Hair rolls are weighted toward natural shades, so bright pink, blue, or green hair is possible but rare.

Each disguise option remembers the last look it rolled, so a disguise you like stays consistent across casts and save/loads. Want something different? Recast the same disguise while you are already wearing it to force a fresh reroll, and keep recasting until you get a look you like.

## Compatibility

- Platform: PC only.
- Script Extender: required.
- Assets: vanilla BG3 assets only. No custom meshes, textures, or colors are added.
- Load order: no special placement is expected for a normal setup. If another mod also changes Disguise Self spells or polymorph statuses, load this mod after it if you want Randomized Disguise Self's behavior to win.
- Multiplayer: rolls are made by the host and sent to every client, so all players see the same disguise. Every player must have the mod and Script Extender installed.
- Removal: for best results, dismiss any active Disguise Self and save before removing the mod from an existing playthrough.

## Upgrading from 1.x

Version 1 chose a whole replacement template per cast. Version 2 replaces that approach entirely with per-feature randomization and no longer adds its own spells. The upgrade is safe to install over 1.x; this release still recognizes 1.x's disguise statuses so saves made while disguised load cleanly. To be safe, dismiss any active disguise and save before updating.

## Troubleshooting

- If the mod does not appear, confirm RandomizedDisguiseSelf.pak is in the BG3 Mods folder and enabled in your mod manager.
- If Disguise Self behaves exactly like vanilla, confirm Script Extender is installed and loading.
- If you need to report a problem, include the Script Extender runtime log and the disguise option you cast. Script Extender writes its log to the directory configured in its own settings.

## Credits

- Larian Studios for Baldur's Gate 3 and the official modding tools.
- Norbyte for BG3 Script Extender.
- The BG3 modding community for documentation, tooling, and research.