Ingame Account Switcher Mod — Guide
Account Management
The core of the mod is the Account Selector screen, which lists all saved profiles. Each entry displays the account's username and a real-time skin preview using integrated skin widgets.
Adding Accounts
Players can add accounts through several methods:
* Microsoft Login: The standard method for modern accounts. It provides a link to be opened in a browser or an alternative device-code method (similar to MultiMC/Prism) where a code is entered on the Microsoft website.
* Offline Mode: Allows the creation of local-only profiles. These accounts do not require a password but are limited to servers that have online-mode set to false.
* Legacy Mojang: Support for older accounts that have not yet been migrated (though most are now Microsoft-based).
Editing and Deleting
Existing accounts can be edited to update credentials or change their display alias. Deleting an account removes its stored tokens and configuration from the local machine. For security, deleting an account within the UI is the recommended way to clear sensitive data before sharing a modpack or game folder.
Mechanics & Features
The mod introduces several mechanics to improve the user experience and security of account switching.
Skin Preview System
IAS utilizes modern skin widgets to render a 3D preview of the character skin associated with each saved account. This allows players to visually verify which account they are selecting before logging in.
UI Integration
- Main Menu Button: A dedicated button is added to the main title screen. Its position can be adjusted or moved automatically if other mods (like Custom Main Menu) are present.
- Server List Button: An optional button appears in the Multiplayer server list, allowing for quick switches while browsing servers.
- Title Bar Display: The mod can be configured to show the currently logged-in username in the Minecraft window title bar.
- Server List Nicknames: An option to display the current account's nickname directly in the server list UI for quick reference.
Security & Encryption
Security is a primary focus of the mod, especially regarding the storage of access tokens. Accounts are stored in a dedicated folder outside the standard config directory to prevent accidental sharing.
Encryption Methods
IAS offers three levels of encryption for stored account data:
| Method | Security Level | Description |
|---|---|---|
| Password Encryption | High | Encrypts data using a user-provided password. The password is never stored on disk, only in RAM. Uses AES/GCM with PBKDF2 hashing (500,000 iterations). |
| Hardware Encryption | Medium | Uses unique hardware and OS identifiers to encrypt data. More convenient as it requires no manual password, but less secure against targeted malware. |
| No Crypt | None (Unsafe) | Stores tokens in plaintext. This is disabled by default and requires a specific config change and keybind to enable. |
Token Protection
To prevent token stealing, the mod uses "loud" filenames and disclaimers within the account storage folder. It also provides documentation on how to revoke tokens via the Microsoft account dashboard if a breach is suspected.