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
   • Same-name auto-load requires the file to be named YourName.png (e.g. Steve.png, Chinese and other characters supported); other files can be named anything and loaded with /strayskins skin <file>
2. Run /strayskins in game to load your own skin (and cape, if present). You can also specify a file with /strayskins skin <file>.
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/.png + cape/.png)
• /strayskins skin: Load your own skin (skin/.png)
• /strayskins skin : Load a specified skin file
• /strayskins cape: Load your own cape (cape/.png)
• /strayskins cape : 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 : Load the appearance of a certain historical player
• /strayskins mojang [Player Name]: Get a premium player's appearance (skin + cape) from Mojang
• /strayskins body: Switch between wide / slender model
• /strayskins fake ...: Manage an individual fake player's appearance; supports skin / cape / player / any / clear / body / mojang
• /strayskins fake @a ...: Batch manage all fake players' appearance; supports skin / cape / player / any / clear / body / mojang
• /strayskins help: Display information on using all commands

Auto-load on join

On a new player's first join, the mod tries in order and reports each step in chat: ① load the same-name skin/cape file → ② load a random local appearance → ③ fetch the premium appearance from Mojang; only if all three fail is a failure shown. 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: modern 64x64 (and integer-multiple HD, e.g. 128x128, 256x256...) or legacy 64x32 (no upscaled legacy); use PNG images with a transparent background.
• Cape files: 64x32 (and integer-multiple HD, e.g. 128x64...), 2:1 landscape.
• Only the skin governs the result: the skin must be valid; an invalid cape is simply skipped and does not affect the skin.
• 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.