SkinsRestorer - Ability to restore/change skins on servers! (Offline and Online Mode). (Bungee/Bukkit/Sponge)

This is a discussion topic for the Ore project, SkinsRestorer. View the full project on Ore for downloads and more information.


!!-=We don’t support forge!=-!!

Completely working from 1.8 till 1.17.1!

Wiki | Discord Support Chat | Feature requests | Issue tracker | Source code

Relevant Tools

SkinFile Generator

With SkinFile Generator you can upload your own custom .png skin to obtain a .skin file that you can put in your skins folder. Check it out here.

SkinSystem

With SkinSystem, a server owner can connect an authentication system such as forum/authme and SkinsRestorer, and allow users to change their skin through a web interface. Server owners may use it to host a website that gives their players the ability to upload & manage custom skins. Check it out here.

SkinsRestorer Info

What is SkinsRestorer?

SkinsRestorer is a plugin that restores skins for offline mode servers & networks and gives the players ability to change their skins by typing a single command.

Where can i use SkinsRestorer?

Currently you can use SkinsRestorer on these platforms:

Servers:

  • Craftbukkit
  • Spigot
  • PaperSpigot
  • TacoSpigot
  • Spongevanilla (not forge)

Clouds:

  • BungeeCord (PaperMC)
  • Waterfall
  • FlexPipe
  • VelocityPowered

Installation Guide

Follow this little guide, so you don’t go wrong :slightly_smiling_face:

For more info see Wiki

For Sponge:

  1. Place the plugin in ./mods/ folder (where Sponge is located).
  2. Restart the server.

For Spigot:

  1. Place the plugin in ./plugins/ folder.
  2. Restart the server.
  3. (Optional) Edit the config.yml inside ./plugins/SkinsRestorer/ folder.

For BungeeCord :

  1. Place the plugin in ./plugins/ folders of every spigot server.
  2. Place the plugin in ./plugins/ folder of every bungeecord server.
  3. Check & set on every Spigot server spigot.yml → bungeecord: true
  4. Give permissions inside the bungee server
  5. Restart the server.
  6. (Optional) Edit the config inside ./plugins/SkinsRestorer/ folder. (bungeecord)

Commands and Permissions

Here’s a list with commands and permissions to use them
Note: If you use the plugin with bungeecord you will need to add the permissions on the bungeecord side (e.g. config.yml)

Player commands:

/skin - main command.
/skin <skin name> - Sets your skin.
/skin <URL> - Allow players to set a .png skin.
/skin update - Updates your current skin.
/skin clear - clears your skin.
/skins - GUI (spigot 1.13+ only).

Admin commands:

/sr - main admin command
/skin set <playername> <skinname> - Sets player's skin.
/skin clear <player> - clear a player's skin.
/skin update <player> update a player's skin.
/skin drop <skinname> - Removes skins data from database.
/sr reload - Reloads config and locale.
/sr props <playername> - Returns properties of a player.
/sr status - check the plugin status.

Additional Permissions:

skinsrestorer.bypasscooldown -> bypasses skinscooldown config
skinsrestorer.bypassdisabled -> bypass the disabledskins list

More info & Permissions:

see: wiki

[!] only works with "NewPermissions: true" (if false see old perms!)
[!] wildcards ("*") don't work

A new version has been released for SkinsRestorer, it is available for download here.


No description given.

A new version has been released for SkinsRestorer, it is available for download here.


Hey all, long wanted update is here!

Added:

/skin to set skins by URL using MineSkin (Permission: "skinsrestorer.command.set.url")
Warning on spigot when using bungeecord to avoid confusion
Verbose config setting to reduce logging messages from SR
"skinsrestorer.ownskin" permission
Remove ChangeSkin detection (we are no longer the underdog)
Support for Java versions older and newer than 1.8
More debugging information to /sr status

Fixed:

/skins GUI skull ordering now always ensured

A new version has been released for SkinsRestorer, it is available for download here.


This is a small bugfix release.

Added:

CodeMC maven repository for the upcomming API.

Fixed:

MySQL driver on Velocity
Skins GUI on older versions
SkinStorage nullpointer exception on spigot when running in bungee mode

Great support! I recommend :stuck_out_tongue:

1 Like

A new version has been released for SkinsRestorer, it is available for download here.


Your spigot server should update automatically, if you haven’t disabled that option.

Added:

  • Support for Minecraft 1.15
  • Simple API for Bungee, Bukkit, Sponge and Velocity

A new version has been released for SkinsRestorer, it is available for download here.


Your spigot server should update automatically, if you haven’t disabled that option.

Added:

  • SKINWITHOUTPERM for /skin
  • /skins (gui) command on bungeecord

A new version has been released for SkinsRestorer, it is available for download here.


No description given.

A new version has been released for SkinsRestorer, it is available for download here.


Important Note: While this was compiled against API 7.0.0, you actually have to be using 7.3.0. Sorry for the inconvenience.

Changelog copied and pasted from our SpigotMC resource page, below:


(!) SECURITY EXPLOIT PATCH (!)

This version contains a security exploit fix in which proxy ip’s can be exploited using skinurl. A change has been made to only allow imgur, (and some other domains).

About the exploit

Since we validate a image before sending it to our api, this can cause security issues like leaking ip’s. This patch will be put in place till the api validate the image instead of us.

Upcoming api changes

In the next majour release (v14) we will make breaking changes to the api. If you’re using our api, make sure to check and make changes before we release it.

A new Dev appeared!

Pistonmaster has been working hard to improve skinsrestorer. He already cut the jar file size by more than 60%! He is working hard to clean up the code, and improving performance! Big shoutout to Pistonmaster for helping us out.

All changes:

  • fixed a exploit that could leak your servr ip (By Pistonmaster)
  • smaller wiki links

A new version has been released for SkinsRestorer, it is available for download here.


Full changelist can be found here: Merge branch 'dev' · SkinsRestorer/[email protected] · GitHub

9a990ecb Improve via ver check

7cefdfbb Last changes for 14.1.0 release (#545)

update gson & velocity-api

Plugin shut down if your using a unsupported ViaVersion version.

Removed snapshot

51d72a31 Add new way to get named fieds (#543)

b8c5e27c Feature/pistons corner (#542)

fixing joining on older version

2a41b34f Fix bungeecord x2 (#540)

246ee375 Feature/pistons corner (#539)

Fix bungee support

71933c5e fix whitespace for skinUrl (#538)

6962e118 More improvements (#533)

MineSkinAPI que system & API key

These updates to MineSkinAPi should make a hookable api possible for MineSkin.

e337e681 Another code cleanup (#532)

b3a8e1a Feature/fix 1.17 (#530)

added MC 1.17 support

1e61709 Yet another giant code rewrite (#529)

Breaking api changes (again) → SkinsRestorerAPI.getApi().getSkinName(name) see

(GitHub - SkinsRestorer/SkinsRestorerAPIExample) & (GitHub - SkinsRestorer/SRPlaceholderAPIExpansion: PlaceholderAPI expansion for SkinsRestorer placeholders) for changes.

huge applier rewrite

applySkin can be cancelled

moving around code

9a307c3 Put viaversion stuff in another class (#528)

4ab8e60 Dont check versionhack plugin if not paper (#523)

ba22f88 noinspection deprecation on intentional fallback (#522)

908292b update ViaVersion (#517)

viaversion v4.0.0 is now required

fe20878 improve SkinsRestorer is OFFLINE warning message (#501)

5647cfd Feature/respect mineskin next request + skinType Fix (#498)

We now retry again in loop if we dont get the skin.

better error feedback.

459ff03 mistook Objects.toString(Object) for String.valueOf(Object) with skinType (#499)

a51dad5 Feature/added optional url skin type variant & translatable syntax (#496)

added [steve/slim] to syntax for /skin url & /sr CreateCustom

Redone command completion → made them locale (@skin,@url&@skinname).

Removed duplicate title on incomplete command message

b23ddb4 Feature/improved name check v2 (#487)

Don’t apply if no skin & custom username.

Add Config.NO_SKIN_IF_LOGIN_CANCELED to Sponge

Allow invalid custom skin names

9a672b3 Feature/improve sr createcustom descirption & syntax (#488)

Change /sr createcustom syntax “name” → “skinName”

change HELP_SR_CreateCustom to better reflect its purpose.

Align syntax over all implementations.

c454a09 Merge my bunch of fixes and additions (#460)

Added bstats for Velocity

Make use of paperlib

Fix hasPassengers NPE

Renamed fileEnableRemountEntiteis to fileDisableRemountPlayer (#442)

Timestamp 0 will now also prevent “/skin update”

Skin success empty will now not send the locale

Update plugin.yml api-version & new commands

Use more file API

Improve color stuff

Add apply event and make escaping to methods

Improve skinstorage code

Fix message on older versions

A new version has been released for SkinsRestorer, it is available for download here.


This is a patch release that should fix the recently introduced issues that came up with the last release (v14.1.0)

known issues:
Velocity MYSQL is still not fixed

Fixes:

  • fix Api
  • fix SkinUpdate
  • DefaultSkins fixed for non-premium
  • (possible) genskin spam fix.
  • Reduce api.github.com messages
  • We now warn on unsupported ViaVersion.

Full changes can be found here:

A new version has been released for SkinsRestorer, it is available for download here.


No description given.

Like the new update, thanks.

A new version has been released for SkinsRestorer, it is available for download here.


This update marks our MC 1.18 support release!

Note to plugin dev’s using us as a dependency:
We changed the artifact ID of SkinsRestorer!
see This commit marks the release of SR 14.1.7 by xknat · Pull Request #739 · SkinsRestorer/SkinsRestorerX · GitHub for changes!

This update fixes the following issues:

  • Support MC 1.18
    • Nexst time we will tell you if we don’t support it instead of just error.
  • Support java 17 fully
  • Instant skins with protocollib
  • No more refresher messages

Issues? → join our discord

Full changes can be found here:
https://github.com/SkinsRestorer/SkinsRestorerX/releases/tag/14.1.7ers! (Offline and Online Mode)

A new version has been released for SkinsRestorer, it is available for download here.


Ability to restore/change skins on servers! (Offline and Online Mode)

Hotfix protocollib issues

A new version has been released for SkinsRestorer, it is available for download here.


SkinsRestorer 14.1.9 (Protocollib, openj9, MalformedInputException & more)
This update is to hotfix the mentioned issues in the title.

Changes:

  • Fix MalformedInputException
  • Fix broken packet into protocllib
  • Fix openj9 crash
  • Added new command: /sr setskinall (console only)
  • Fix cardboard
  • Make protocollib listener async

Changelog: Release SkinsRestorer 14.1.9 (fix Protocollib, openj9, MalformedInputException & more) · SkinsRestorer/SkinsRestorerX · GitHub