Appearance Keeper 0.3.0
![Swap Main Ride [Enhanced]](https://img.gta5-mods.com/q75-w500-h333-cfill/images/swap-main-ride/b212b5-SMRTitle_Small.png "Swap Main Ride [Enhanced]")
309
22
309
22
Appearance Keeper
This mod preserves your freemode (multiplayer) character's appearance in story mode and re-applies it automatically on load, so your character comes up exactly as you left them - no menus, no clicks. Save as many looks as you like into named slots, mark one active, and turn on Auto-apply on Load.
It does not customize anything - authoring the look is left to a full customizer (e.g. Menyoo). Appearance Keeper just snapshots what the game reports back and replays it.
What gets preserved
A few fields the game exposes no getter for (face morphs, overlay opacity, hair tint, moving style, mood, tattoos) are read directly from the live character's memory. Every read is bounds-checked and locates its data by content, never a hard-coded address, so a read that doesn't line up simply falls back to native capture - it never applies a wrong value.
Mod data location
The mod stores its data (log, AppearanceKeeper.ini and saved appearances) in %APPDATA%\GTA V Mods\KernelPryanic\AppearanceKeeper instead of the game folder. This is required on GTA V Enhanced, where the game locks every file inside the game directory for the whole session.
Default keys
Dependencies
Recommendations
Installation
Just extract the content of AppearanceKeeper.zip to the root of your GTA 5 directory.
Or use my Vortex extension for GTA 5.
Known limitations
Changelog
0.3.0
0.2.0
0.1.0
This mod preserves your freemode (multiplayer) character's appearance in story mode and re-applies it automatically on load, so your character comes up exactly as you left them - no menus, no clicks. Save as many looks as you like into named slots, mark one active, and turn on Auto-apply on Load.
It does not customize anything - authoring the look is left to a full customizer (e.g. Menyoo). Appearance Keeper just snapshots what the game reports back and replays it.
What gets preserved
- Model (Freemode Male / Female)
- Heritage (face shape + skin tone) and the 20 face micro-morphs
- Head overlays - brows, makeup, beard, wrinkles - with opacity
- Hair drawable + texture and hair tint colour
- Eye colour and voice
- Clothing components and props (hats, glasses, earrings, watches, bracelets)
- Moving style (movement clipset)
- Mood (facial idle-anim override)
- Tattoos / decals
A few fields the game exposes no getter for (face morphs, overlay opacity, hair tint, moving style, mood, tattoos) are read directly from the live character's memory. Every read is bounds-checked and locates its data by content, never a hard-coded address, so a read that doesn't line up simply falls back to native capture - it never applies a wrong value.
Mod data location
The mod stores its data (log, AppearanceKeeper.ini and saved appearances) in %APPDATA%\GTA V Mods\KernelPryanic\AppearanceKeeper instead of the game folder. This is required on GTA V Enhanced, where the game locks every file inside the game directory for the whole session.
Default keys
- Shift+X - Open menu (configurable in AppearanceKeeper.ini)
Dependencies
Recommendations
- Give your freemode character a real, spendable wallet in story mode - Freemode Wallet
Installation
Just extract the content of AppearanceKeeper.zip to the root of your GTA 5 directory.
Or use my Vortex extension for GTA 5.
Known limitations
- Works on freemode (MP Male/Female) peds only - story protagonists and addon/custom models have their face baked into the model and can't be captured.
- Some externally-authored faces can't be captured - a few peds (e.g. certain trainer-created characters) store their face outside the head-blend system the game lets us read, so it reports no head data (clothes, hair and props still save). The mod warns you at save time when this happens. Faces made in the in-game creator work fine.
- Tattoos don't capture on some Menyoo-loaded peds (the game refuses to add the locator decoration) - the rest of the look still saves. The first tattoo-enabled save on such a ped stutters for a few seconds before giving up.
- Overlay tint colours aren't preserved yet on Enhanced (brow/makeup/lipstick shape and opacity are).
- Custom moving styles / moods outside the known tables are left unset rather than guessed.
Changelog
0.3.0
- New Enabled master switch at the top of the menu. Turn it on and your active freemode look is applied; turn it off and you're swapped back to your story protagonist (Michael, Franklin or Trevor) - the one you were before the mod dressed you up. The mod goes fully passive while disabled (no auto-apply, no autosave).
- Remembers your original story character from the moment the game loads - even with the mod disabled - so disabling always returns you to the right protagonist.
- Plays nicely with Freemode Wallet: while its identity spoof is active, Appearance Keeper holds off so the two mods don't fight over your character. Release the spoof first, then disable.
0.2.0
- New Apply Active Slot menu item - one click re-applies your active slot to roll back any edits to the saved look.
- Default menu key changed to Shift + X (still configurable in AppearanceKeeper.ini).
- Removed the protagonist identity swap - the mod now focuses purely on appearance snapshot and restore.
0.1.0
- Initial release - snapshot and auto-apply your freemode look, multiple named slots, autosave, manual per-feature capture toggles, and protagonist identity swap.
Првпат Додадено: пред 1 ден
Последно Ажурирање: пред 13 саати
Последно Симнување: пред 1 минута
16 Коментари
Appearance Keeper
This mod preserves your freemode (multiplayer) character's appearance in story mode and re-applies it automatically on load, so your character comes up exactly as you left them - no menus, no clicks. Save as many looks as you like into named slots, mark one active, and turn on Auto-apply on Load.
It does not customize anything - authoring the look is left to a full customizer (e.g. Menyoo). Appearance Keeper just snapshots what the game reports back and replays it.
What gets preserved
A few fields the game exposes no getter for (face morphs, overlay opacity, hair tint, moving style, mood, tattoos) are read directly from the live character's memory. Every read is bounds-checked and locates its data by content, never a hard-coded address, so a read that doesn't line up simply falls back to native capture - it never applies a wrong value.
Mod data location
The mod stores its data (log, AppearanceKeeper.ini and saved appearances) in %APPDATA%\GTA V Mods\KernelPryanic\AppearanceKeeper instead of the game folder. This is required on GTA V Enhanced, where the game locks every file inside the game directory for the whole session.
Default keys
Dependencies
Recommendations
Installation
Just extract the content of AppearanceKeeper.zip to the root of your GTA 5 directory.
Or use my Vortex extension for GTA 5.
Known limitations
Changelog
0.3.0
0.2.0
0.1.0
This mod preserves your freemode (multiplayer) character's appearance in story mode and re-applies it automatically on load, so your character comes up exactly as you left them - no menus, no clicks. Save as many looks as you like into named slots, mark one active, and turn on Auto-apply on Load.
It does not customize anything - authoring the look is left to a full customizer (e.g. Menyoo). Appearance Keeper just snapshots what the game reports back and replays it.
What gets preserved
- Model (Freemode Male / Female)
- Heritage (face shape + skin tone) and the 20 face micro-morphs
- Head overlays - brows, makeup, beard, wrinkles - with opacity
- Hair drawable + texture and hair tint colour
- Eye colour and voice
- Clothing components and props (hats, glasses, earrings, watches, bracelets)
- Moving style (movement clipset)
- Mood (facial idle-anim override)
- Tattoos / decals
A few fields the game exposes no getter for (face morphs, overlay opacity, hair tint, moving style, mood, tattoos) are read directly from the live character's memory. Every read is bounds-checked and locates its data by content, never a hard-coded address, so a read that doesn't line up simply falls back to native capture - it never applies a wrong value.
Mod data location
The mod stores its data (log, AppearanceKeeper.ini and saved appearances) in %APPDATA%\GTA V Mods\KernelPryanic\AppearanceKeeper instead of the game folder. This is required on GTA V Enhanced, where the game locks every file inside the game directory for the whole session.
Default keys
- Shift+X - Open menu (configurable in AppearanceKeeper.ini)
Dependencies
Recommendations
- Give your freemode character a real, spendable wallet in story mode - Freemode Wallet
Installation
Just extract the content of AppearanceKeeper.zip to the root of your GTA 5 directory.
Or use my Vortex extension for GTA 5.
Known limitations
- Works on freemode (MP Male/Female) peds only - story protagonists and addon/custom models have their face baked into the model and can't be captured.
- Some externally-authored faces can't be captured - a few peds (e.g. certain trainer-created characters) store their face outside the head-blend system the game lets us read, so it reports no head data (clothes, hair and props still save). The mod warns you at save time when this happens. Faces made in the in-game creator work fine.
- Tattoos don't capture on some Menyoo-loaded peds (the game refuses to add the locator decoration) - the rest of the look still saves. The first tattoo-enabled save on such a ped stutters for a few seconds before giving up.
- Overlay tint colours aren't preserved yet on Enhanced (brow/makeup/lipstick shape and opacity are).
- Custom moving styles / moods outside the known tables are left unset rather than guessed.
Changelog
0.3.0
- New Enabled master switch at the top of the menu. Turn it on and your active freemode look is applied; turn it off and you're swapped back to your story protagonist (Michael, Franklin or Trevor) - the one you were before the mod dressed you up. The mod goes fully passive while disabled (no auto-apply, no autosave).
- Remembers your original story character from the moment the game loads - even with the mod disabled - so disabling always returns you to the right protagonist.
- Plays nicely with Freemode Wallet: while its identity spoof is active, Appearance Keeper holds off so the two mods don't fight over your character. Release the spoof first, then disable.
0.2.0
- New Apply Active Slot menu item - one click re-applies your active slot to roll back any edits to the saved look.
- Default menu key changed to Shift + X (still configurable in AppearanceKeeper.ini).
- Removed the protagonist identity swap - the mod now focuses purely on appearance snapshot and restore.
0.1.0
- Initial release - snapshot and auto-apply your freemode look, multiple named slots, autosave, manual per-feature capture toggles, and protagonist identity swap.
Првпат Додадено: пред 1 ден
Последно Ажурирање: пред 13 саати
Последно Симнување: пред 1 минута
5mods on Discord
I'm expecting lots of bugs as logic is quite fragile here, so if you encounter one and decide to report, please attach the log from %APPDATA%\GTA V Mods\KernelPryanic\AppearanceKeeper\AppearanceKeeper.log
This file has been approved automatically. If you think this file should not be here for any reason please report it.
@Kernel Pryanic Man, your mod is interesting. Do you think it's possible to implement a monetary system for multiplayer characters—so they can buy things in stores, earn money through robberies and the like—without needing some sort of character-swapping mechanic?
@Zona Comics, yeah, I tried to spoof identity of a freemode into protagonists, but in enhanced version identity is a single object now, so it applies character look automatically. Maybe it's possible somehow, but it's definitely not trivial.
Regarding separate monetary system - also very complicated, I'd rather bet on some clever spoofing mechanics to just reuse existing GTA system.
Actually, I have an idea - we can try to hook into protagonists wallets while on freemode, without full identity spoof. I'll try this out on the weekends maybe.
Can you tell me if you use character mods?
@MaGeTo I've been testing it only with Menyoo character presets that you can find here on gta5-mods.com, no external models/substitutions
@null_pointer Is there any way to access the money without having to change the hash to one of the main characters? The methods or internal mods I tested—like character swapping—cause glitches if you use a multiplayer character and try to change outfits; the game gets confused because the hash makes it think the character is one of the three main protagonists.
@null_pointer Got it, thanks
@null_pointer any chance your on discord, ive been trying for ages to get detection of Tattoos in my own Playable Online Character mod to work, any chance you could help me out with getting it to work/explaining how you have got it to work?
@HKH191 sure, I have to read them out of memory directly, scanning for a pattern that marks the decoration array (a pair of 0x14 sentinels, 16KB-aligned), then pull the collection + decoration hashes and re-apply them with ADD_PED_DECORATION_FROM_HASHES. So it takes a while for the scan. It's open source, you can find the code here https://github.com/KernelPryanic/AppearanceKeeper :)
@Zona Comics I'm currently trying to hook up freemode wallet to be usable, looks promising, if project succeeds I'll upload FreemodeWallet mod
Happy to announce Freemode Wallet - an actual freemode ped wallet that works by hooking up the real wallet under the hood, using the game monetary system https://www.gta5-mods.com/scripts/freemode-wallet
@null_pointer Yeah, you're quick on the trigger, my friend.
Amazing mod! I'm genuinely surprised at how well this mod works compared to similar ones like Dealien's Adjustments or OutfitPersistence.
Some issues I'm encountering:
-Clothing and hair get reset upon respawning at a hospital after being wasted
-Player model gets reset to Franklin, Michael, or Trevor with a messed-up outfit upon failing or dying in a mission
-Facial features fail to save, but can be applied if they are manually recreated by editing the XML
-Facial overlays (e.g. eyebrows) also fail to save, but can't be applied even if they are manually recreated by editing the XML
The first two issues are relatively minor IMO since they can be fixed by manually reapplying the active slot, but the last two are probably only on my end. The outfit I tried to save was created using Menyoo, so that's probably why.
@null_pointer do you have discord? could i get some help with what i would need to transfer over to my mod, still not 100% about what everything does in your source code