FS25 Avatar Switcher

Avatar Switcher is a Farming Simulator 25 script mod that lets you save the current player appearance as a reusable preset and switch between saved avatars from an in-game selector.

Features

• Save the current wardrobe appearance as an avatar preset.
• Give each preset a unique ID, display name and category.
• Filter saved appearances by category.
• Apply or delete presets through an in-game selector.
• Open Avatar Switcher while on foot or inside a vehicle.
• Save directly from the player wardrobe through the Save to AvatarSwitcher control.
• Store presets outside the mod ZIP so they survive mod updates.
• Refresh preset data without restarting the game.
• Provide a public API for integration with other mods, including Helper Profiles.
• English, German and French localisation.

Compatibility

• Farming Simulator 25
• Version: 1.0.0.0
• Script mod for PC and Mac
• Single-player only
• Multiplayer is not supported
• No additional mods are required

Installation

1. Download FS25_AvatarSwitcher.zip.

2. Copy the ZIP file into your Farming Simulator 25 mods folder:

   Documents/My Games/FarmingSimulator2025/mods
   

3. Enable Avatar Switcher when loading your save.

4. Open the in-game control settings and assign a key or button to Open Avatar Switcher if it is not already mapped.

Do not extract the mod ZIP into the mods folder.

Using Avatar Switcher

Saving an appearance

1. Open the Farming Simulator wardrobe and configure the player appearance.
2. Select Save to AvatarSwitcher.
3. Enter:
   • Preset ID — a unique identifier stored without spaces.
   • Description — the name shown in the selector.
   • Category — used to group related presets.
4. Select Save.

Applying an appearance

1. Use the mapped Open Avatar Switcher control.
2. Select a category.
3. Select a saved appearance.
4. Choose Apply.

The selected appearance is written to the player settings and Avatar Switcher attempts to refresh the active player immediately.

Deleting an appearance

Open the selector, choose the preset and select Delete. Deleting a preset does not change the appearance currently in use.

Preset Storage

Avatar presets are stored at:

Documents/My Games/FarmingSimulator2025/modSettings/FS25_AvatarSwitcher/avatarPresets.xml

On first use, Avatar Switcher creates this file from the included template. The file remains in the modSettings folder when the mod ZIP is updated.

Before Avatar Switcher first writes an appearance to gameSettings.xml, it creates this backup when one does not already exist:

Documents/My Games/FarmingSimulator2025/gameSettings.avatarSwitcherBackup.xml

Console Commands

The following commands are available when the developer console is enabled:

Command	Purpose
avatarList [category]	List saved presets, optionally filtered by category.
avatarUse <presetId>	Apply a preset.
avatarCurrent	Show the current player style stored in gameSettings.xml.
avatarSaveCurrent <presetId> <display name>	Save the current player style as a custom preset.
avatarDelete <presetId>	Delete a preset.
avatarReload	Reload presets from XML.
avatarRefresh	Attempt a live refresh of the active player.
avatarHud	Open or close Avatar Switcher.
avatarProbe	Print runtime avatar diagnostics.

Equivalent shortened aliases are available with the as prefix, such as asList, asUse, asDelete and asReload.

Integration API

Avatar Switcher exposes these global API tables for other mods:

AvatarSwitcherAPI
FS25_AvatarSwitcherAPI

The API supports availability checks, preset lookup, category filtering, reload requests and conversion of a saved preset into a runtime PlayerStyle object.

Useful entry points include:

AvatarSwitcherAPI.isAvailable()
AvatarSwitcherAPI.getPresets()
AvatarSwitcherAPI.getPresetsByCategory(category)
AvatarSwitcherAPI.getPreset(presetId)
AvatarSwitcherAPI.getPresetLabel(presetId)
AvatarSwitcherAPI.createPlayerStyleFromPresetId(presetId)
AvatarSwitcherAPI.reload()

Localisation

Included languages:

• English
• German
• French

Localisation files are stored in the l10n folder. Contributions for additional languages are welcome.

Known Limitations

• Multiplayer is intentionally disabled and unsupported.
• Live appearance refresh depends on the current player and wardrobe runtime state. When an immediate refresh is not possible, reopening the wardrobe or reloading the save applies the stored appearance.
• Preset IDs must be unique.

Licence and Credits

Created by SimGamerJen.

The Farming Simulator name and related assets are trademarks of GIANTS Software. This project is an independent mod and is not affiliated with or endorsed by GIANTS Software.