Skin Swapper Mod — Guide
Interface and Navigation
The mod is primarily accessed through a dedicated button integrated into the existing Minecraft menus. There are two main ways to open the Skin Swapper GUI:
- Multiplayer Menu: A shortcut button is located in the top-left corner of the Multiplayer server list screen.
- Skin Customization: Within the in-game 'Options' menu, under 'Skin Customization', a 'Change Skin' button is added to provide access while already connected to a world.
The Main Menu
Upon opening the GUI, players are presented with a list of all currently saved skins. Each entry displays a preview of the skin and its name. The interface includes navigation buttons to scroll through the library, an 'Accounts' button for authentication management, and a 'Download Skin' button for acquiring new appearances.
Skin Management
Skin Swapper manages skins through a local library and an integrated downloader.
Adding Local Skins
To add skins to the mod's library, players must place valid .png skin files into a specific directory within their game instance:
* Directory Path: .minecraft/skins/ (or the equivalent folder in custom launcher instances).
* Requirements: Files must be standard Minecraft skin formats (64x64 or 64x32 pixels).
Downloading Skins
The mod features a built-in downloader that can fetch skins directly from the Mojang API. By clicking the Download Skin button, players can enter the username of any valid Minecraft account. The mod will then retrieve that player's current skin and save it to the local library for future use.
Modes of Operation
When applying a skin, the mod offers two distinct modes that determine how the change is processed and who can see it.
| Mode | Description | Visibility |
|---|---|---|
| Online Mode | Authenticates with Mojang's servers to update the account's official skin. | Visible to all players on any server. |
| Offline Mode | Changes the skin locally within the client's memory. | Only visible to the player (Client-side only). |
Online Mode Authentication
To use Online Mode, players must log in through the 'Accounts' section of the mod. This requires entering the credentials associated with the Minecraft account. This process allows the mod to securely send the skin update request to Mojang, mimicking the behavior of the official launcher.
Technical Mechanics
The mod includes several technical features to ensure skins are rendered correctly across different character models.
Skin Types
Players can manually toggle between the two standard Minecraft character models: * Classic: The traditional 4-pixel wide arm model (Steve-style). * Slim: The 3-pixel wide arm model (Alex-style).
The mod typically attempts to auto-detect the correct type based on the skin file's metadata, but the manual toggle ensures compatibility with older or custom-formatted skins.
Refreshing the Library
If new files are added to the /skins/ folder while the game is running, the GUI includes a refresh function that re-scans the directory and updates the in-game list without requiring a client restart.
