Allow anonymous analytics?

Our cookieless analytics show us which features get used and store nothing on your device. We never sell your data or use it for advertising.

Privacy choices

Choose what ModDex may collect. You can change this anytime from Privacy choices in the footer.

Read the full privacy policy

Strictly necessary Required for the site to work: login sessions, security tokens, and abuse prevention. Always on and cannot be disabled. Always on
Analytics Cookieless analytics through PostHog's EU servers, used only to see which features get used. Nothing is stored on your device, and the anonymous visitor ID resets every day. Needs your consent because usage data goes to a third party. Never used for advertising or profiling. Off by default in the EU and UK.

arthou's skin manager

Quick rating

Community listing page, reviews may not be monitored by the author.

How listings work Are you the author?

arthou's skin manager

By arthou

No reviews yet

Skins, capes and outfits for NeoForge servers, with an optional client mod that adds a wardrobe screen and 3D preview.

Mod Loaders
Minecraft
Shockbyte server hosting: 35% off your first server with code MODDEX35 (opens in a new tab)

About

Description

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:

Goes on Minecraft File
Server NeoForge 1.21.1 arthous-skin-manager-server-neoforge-1.21.1 → server mods/
Server NeoForge 1.21.11 arthous-skin-manager-server-neoforge-1.21.11 → server mods/
Player NeoForge 1.21.1 arthous-skin-manager-client-neoforge-1.21.1 → your instance's mods/ (optional)
Player NeoForge 1.21.11 arthous-skin-manager-client-neoforge-1.21.11 → your instance's mods/ (optional)
  • 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