Slip Into Skin

SlipIntoSkin connects your Minecraft server to slipinto.skin through an authenticated WebSocket connection. Players generate a short link code in-game, claim it on the website, then use the web panel to import, upload, save, favourite and apply skins.

The plugin does not replace SkinsRestorer. It uses SkinsRestorer as the skin backend and sends skin changes through the SkinsRestorer API.

• Central web panel - Players manage skins from slipinto.skin
• Simple account linking - Players run `/sis link`, then claim the generated code in the browser
• Mojang username import - Import a signed skin texture from a Minecraft username
• PNG skin upload - Upload valid 64x64 or 64x32 Minecraft skin PNG files
• Saved skin history - Recently used skins are kept for the browser session
• Favourites - Mark up to 5 saved skins as favourites
• Multiple linked players - One browser session can hold multiple player/server connections
• Online status awareness - The web panel can show server/player online state
• Pending offline skins - If a player is offline, the selected skin is stored and applied on next join
• Cooldown protection - Configurable skin-change limits help reduce abuse
• Auto registration - First startup can register the server and save credentials automatically

1. Join the Minecraft server.
2. Run `/sis link`.
3. Copy the link code shown in chat.
4. Open slipinto.skin.
5. Claim the code in the web panel.
6. Import a Mojang username, upload a skin PNG, or reuse a saved skin.
7. Apply the skin from the website.

Aliases:

• /sis link - Generates a temporary code for linking the player to the web panel
• /sis status - Shows WebSocket state and pending offline skin status
• /sis unlink - Requests unlinking the player's browser session from the web service
• /sis reload - Reloads config and requests a reconnect
• /sis reconnect - Forces a WebSocket reconnect
• /sis debug - Shows server id, connection state, pending requests, pending offline skins and SkinsRestorer API status

slipintoskin.use
slipintoskin.admin

• slipintoskin.use - Allows `/sis link`, `/sis status` and `/sis unlink` - default: true
• slipintoskin.admin - Allows `/sis reload`, `/sis reconnect` and `/sis debug` - default: op

• SkinsRestorer - Required hard dependency
• Java 21 - The plugin is built with a Java 21 toolchain
• Minecraft/Spigot API - Built against Spigot API 1.21.11
• Internet access - The server must be able to reach `wss://slipinto.skin/api/plugin/ws`

SlipIntoSkin was coded and built against Minecraft 1.21.11 / Spigot API 1.21.11. Since the plugin logic is lightweight and mostly communicates with SkinsRestorer and the web service, it may work on many nearby versions, but 1.21.11 is the main target.

SkinsRestorer API dependency used during development:

net.skinsrestorer:skinsrestorer-api:15.7.3

1. Install SkinsRestorer on your server.
2. Download `slipintoskin.jar` from the web panel download endpoint.
3. Place `slipintoskin.jar` in your server's `plugins` folder.
4. Restart the server.
5. On first startup, SlipIntoSkin registers the server with the web service and saves credentials to `config.yml`.
6. Run `/sis status` or `/sis debug` to check the connection.

Default config:

server-id: ""
shared-token: ""
websocket-url: "wss://slipinto.skin/api/plugin/ws"
reconnect:
initial-delay-seconds: 2
max-delay-seconds: 60
cooldown:
mode: "only-identifier-generation"
max-changes: 3
window-minutes: 10
debug: false

• server-id - Saved automatically after server registration
• shared-token - Saved automatically after server registration
• websocket-url - WebSocket endpoint used by the plugin
• reconnect.initial-delay-seconds - First reconnect delay
• reconnect.max-delay-seconds - Maximum reconnect delay
• cooldown.mode - `only-identifier-generation` or `all`
• cooldown.max-changes - Maximum allowed skin changes per cooldown window; set to 0 to disable
• cooldown.window-minutes - Cooldown window length
• debug - Logs WebSocket messages with secrets redacted

• Mojang username - The website fetches signed texture data from Mojang and sends it to the plugin
• PNG upload - Accepts Minecraft skin PNGs sized 64x64 or 64x32
• Saved skins - Previously used skins can be applied again from the web panel

The web panel tracks recent apply requests for the selected player.

• sent - Request was sent to the connected plugin
• pending - Server/plugin was not connected yet, so the web service is holding the request
• pending_offline - Player was offline; the plugin will apply the skin when they join
• ok - Skin was applied successfully
• cooldown - Skin change was blocked by cooldown settings
• error - Skin apply failed

• The plugin authenticates to the web service using `server-id` and `shared-token`.
• The web panel stores browser sessions in an HTTP-only cookie.
• The website can manage more than one linked player/server connection in the same browser session.
• Saved skin library entries are session-based, with favourites kept at the top.
• There is currently no separate documentation or support server listed.