StraySkins

Overview

StraySkins is a skin management mod designed for offline account environments. It lets offline account players have and switch their own skins and capes just like premium account players, and display them correctly to themselves and other players on multiplayer servers.

How to use

1. Put your skin/cape images into the mod folders:

   • Client: Client instance/strayskins/skin/ (skin), Client instance/strayskins/cape/ (cape), auto-uploaded on join

   • Server: server directory/strayskins/skin/ (skin), server directory/strayskins/cape/ (cape), visible to all players

   • The file name must match your in-game name, e.g. Steve.png (Chinese and other characters supported)

2. Run /strayskins in game to automatically load your own skin and cape.

3. If your launcher already has a skin set, it will take effect automatically on join. It is recommended to use the HMCL launcher to set your appearance and launch.

Command Preview

• /strayskins: Load your own skin and cape (skin/<player name>.png + cape/<player name>.png)

• /strayskins skin: Load your own skin (skin/<player name>.png)

• /strayskins skin <file>: Load a specified skin file

• /strayskins cape: Load your own cape (cape/<player name>.png)

• /strayskins cape <file>: Load a specified cape file

• /strayskins any: Randomly load skin and cape

• /strayskins any skin: Randomly load a skin

• /strayskins any cape: Randomly load a cape

• /strayskins clear [skin|cape]: Clear skin, cape, or all

• /strayskins list: List all available files

• /strayskins player: List historical players and their respective skin/cape file status

• /strayskins player <player>: Load the appearance of a certain historical player

• /strayskins mojang [Player Name]: Get skins of premium players from Mojang

• /strayskins body: Switch between wide / slender model

• /strayskins fake <fake> ...: Manage the appearance of an individual fake player

• /strayskins fake @a ...: Batch manage the appearance of all fake players (requires admin privileges)

• /strayskins help: Display information on using all commands

Auto-load on join

When a new player joins for the first time, the mod automatically loads the skin/cape file matching the player name; if there is no matching file, a random appearance is loaded instead. Players who have set an appearance will have it automatically restored from their player folder when they rejoin the server; if the appearance files are missing, a hint will be shown in chat.

Supports single-player, LAN, and dedicated servers.

Folder Structure

The strayskins/ folder:

• skin/: Skin library. All available skin files go here; skin commands (skin <file>, random skin) pick files from it. skin/<player name>.png is your own skin.

• cape/: Cape library. cape/<player name>.png is your own cape.

• player/: Player appearance saves. One sub-folder per player (player/<player name>/), holding skin.png, cape.png and the save file <player name>.json; appearances are restored from this folder on rejoin.

• player.txt: player name to UUID mapping, records historical players.

• fake/: Fake player appearance folder (requires the FakePlayer mod to be installed).

  • fake/skin/: fake player skin library

  • fake/cape/: fake player cape library

  • fake/fake.txt: fake player name to UUID mapping

Notes

• Must be installed on both client and server (with matching versions) for full skin display.

• Skin files: multiple of 64 and 1:1 square (e.g. 64x64, 128x128, 256x256...), use PNG images with a transparent background.

• Cape files: multiple of 64x32, 2:1 landscape (e.g. 64x32, 128x64...).

• Server skin/cape files should not exceed 4MB; it is recommended that client files do not exceed 1.4MB.

• Skins in the server folder are visible to all players; the client folder is for your own use only (uploaded on join).

• Fake player features work fully when used with the FakePlayer mod; without it, normal skin features are unaffected.