shared-folder-skins

Description

# Shared Folder Skins

Shared Folder Skins lets players use a local PNG skin from `config/sharedskins` and share it with other players on the same Fabric server.

It is meant for small servers, friends, private modpacks, LAN worlds, and anyone who wants quick shared skins without external accounts, web services, launchers, or resource pack setup.

## Features

- Loads PNG skins from `config/sharedskins`
- Shares your selected skin with other players who also have the mod installed
- Works on Fabric servers and integrated singleplayer worlds
- Supports classic and slim arm models
- Supports HD skins from `64x64` up to `2048x2048`
- Updates while connected when you replace or remove the PNG
- Includes an in-game skin picker in the pause menu
- Saves the selected skin in `config/sharedskins/selected.txt`
- Preserves capes and elytra textures

## Setup

Install the matching jar on the server and on every client that should send or see shared skins.

Start the client once. The mod creates:

config/sharedskins

Put a PNG skin in that folder.

Recommended file names:

skin.png
skin_slim.png

`skin_slim.png` uses the slim arm model. If no skin is manually selected, the mod checks these names first:

skin_slim.png
slim.png
skin.png

If none of those exist, it uses the first PNG in the folder.

## In-game skin picker

Open the pause menu and press:

Change Skin

Pick any PNG from `config/sharedskins` to apply it immediately.

Use auto-select to return to the default file priority.

## Requirements

- Fabric Loader
- Fabric API
- Java 17 for Minecraft 1.20 to 1.20.4
- Java 21 for Minecraft 1.20.5 and newer

## Supported versions

This release line supports:

1.20 – 1.21.11

Use the jar that matches your exact Minecraft version.

## Notes

- A vanilla server cannot relay shared skins. The server must have the mod installed.
- Other players must also have the mod installed to see shared skins.
- PNG files larger than `8 MiB` are ignored.
- The mod only replaces the player body skin. Capes and elytra textures stay unchanged.