arthou’s skin manager

arthou’s skin manager

Give every player a personal wardrobe of skins, capes and outfits that sticks with them. This project has the NeoForge server mod and the optional client mod, which adds a full wardrobe screen with a live 3D preview.

Running Paper? Get the Paper plugin version instead: arthou’s skin manager (Paper).

Which file do I need?

The server files and the client files are different downloads:

• Don’t put the client mod on a server or the server mod in your game. Each file loads on one side only.
• Players without the client mod can still join and play normally.
• The client mod also works on Paper servers running the plugin version.

Server mod

• Each player gets a personal library: skins, capes, and outfits (a skin and cape saved together), up to 100 of each.
• /skin, /cape and /outfit commands with tab completion: list, select, rename, delete, reset, and more.
• Storage is built in. Everything is saved in the server’s own folder, with no database, URL or API key to set up, and it survives restarts.
• Appearance changes apply without respawn, teleport or relog.
• Works behind a Velocity proxy.

Client mod (optional)

• Wardrobe screen: press K, or click the shirt button under your character in the pause menu. It has a grid library, a live 3D preview and Classic/Slim models.
• Import your own PNGs: 64×64 skins and 64×32 capes (capes also show on the elytra). Your files stay in your instance folder (arthous-skins/), and your selection is applied automatically on every compatible server you join. A server that already has the file doesn’t receive it again.
• Account tab: change your Microsoft account’s skin and official cape through the official Minecraft API, using your launcher session. Your login is never sent to the server.
• See other players’ looks: custom skins, custom capes and elytra of other players who use the mod.
• No chat spam: changes made in the wardrobe are confirmed on screen, not in chat.

What players without the client mod see

Minecraft only draws skins signed by Mojang and official capes. Because of that, custom PNG skins, custom capes and custom elytra are visible only to players who have the client mod. Everyone else sees the regular Mojang skins, and nothing else changes for them.

Optional: shared backend for networks

By default, each server keeps its own libraries. A network that wants one shared library across several servers (NeoForge and Paper, different versions) can set backend-mode=http and run the included backend (Docker: FastAPI, PostgreSQL, Redis and S3-compatible storage). It also enables /skin set <player> to use the skin of any Minecraft account.

Configuration

• config/arthous-skins/server.properties (backend-mode=local by default).
• Messages default to Portuguese. Edit config/arthous-skins/messages.properties to translate them.

Requirements

• Java 21
• NeoForge 21.1.244+ (Minecraft 1.21.1) or 21.11.45+ (Minecraft 1.21.11)
• Dedicated servers only. The server mod doesn’t run in singleplayer.

Credits

Player refresh adapted from SkinRestorer (MIT).

Made by arthou · Discord