Skin Swapper Mod Wiki

Skin Swapper is a specialized cosmetic utility mod designed to streamline the process of changing player skins. Unlike the vanilla game, which requires players to close the client and use the Minecraft Launcher or official website to update their appearance, this mod introduces an in-game Graphical User Interface (GUI) that handles skin transitions in real-time. It is particularly useful for roleplayers, content creators, or players who frequently switch between different character outfits.

The mod functions as a client-side enhancement but offers features that can synchronize skin changes with the game server, ensuring that other players can see the updated appearance immediately depending on the selected mode.

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 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.

When applying a skin, the mod offers two distinct modes that determine how the change is processed and who can see it.

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.

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.

While the mod is primarily GUI-driven, it integrates with standard configuration managers to allow for minor adjustments.

• Default Arm Type: Sets whether the mod should default to Classic or Slim when a new skin is detected.
• GUI Positioning: Some versions allow for the adjustment of the 'Change Skin' button position to prevent overlap with other mods that modify the Multiplayer or Options menus.

As a utility mod, Skin Swapper does not add any new mobs, items, blocks, biomes, or dimensions to the game world. Its functionality is entirely focused on the player's cosmetic appearance and user interface.