Commands and Permissions

A permission works only when the player also has its parent permissions.

For example, skinsrestorer.command.set.other also needs skinsrestorer.command.set and skinsrestorer.command.

If commands do not work, read the installation guide.

Commands

SkinsRestorer provides player commands and administrator commands.

Player commands

These parent permissions give access to all player commands: skinsrestorer.player / skinsrestorer.command.*

Command	Description	Permission
`/skin`	Changes your own skin.	`skinsrestorer.command`
`/skin set <skinName>`	Changes your skin.	`skinsrestorer.command.set`
`/skin set <skinName> <target>`	Sets the skin for a target player.	`skinsrestorer.command.set.other`
`/skin set <skinName> <target> <skinVariant>`	Sets the skin for a target player.	`skinsrestorer.command.set.other`
`/skin url <url>`	Changes your skin from a URL.	`skinsrestorer.command.set.url`
`/skin url <url> <skinVariant>`	Changes your skin from a URL.	`skinsrestorer.command.set.url`
`/skin update`	Updates your skin.	`skinsrestorer.command.update`
`/skin update <target>`	Updates the skin of a target player.	`skinsrestorer.command.update.other`
`/skin search <searchString>`	Searches for a skin.	`skinsrestorer.command.search`
`/skin clear`	Clears your skin.	`skinsrestorer.command.clear`
`/skin clear <target>`	Clears the skin of a target player.	`skinsrestorer.command.clear.other`
`/skin random`	Applies a random recommended skin.	`skinsrestorer.command`
`/skin undo`	Reverts to your previous skin.	`skinsrestorer.command`
`/skin history`	Shows your skin change history.	`skinsrestorer.command`
`/skin favourite`	Adds or removes the current favorite.	`skinsrestorer.command`
`/skin favourites`	Lists your favorited skins.	`skinsrestorer.command`
`/skin edit`	Opens the skin editor in browser.	`skinsrestorer.command`
`/skin upload`	Shows skin upload information.	`skinsrestorer.command.set.url`
`/skin <skinName>`	Changes your own skin.	`skinsrestorer.command`
`/skin help`	Shows command help.	`skinsrestorer.command.set`
`/skins`	Opens the skins GUI.	`skinsrestorer.command.gui`

Admin commands

These parent permissions give access to all administrator commands: skinsrestorer.admin / skinsrestorer.admincommand.*

Command	Description	Permission
`/sr`	Admin commands for SkinsRestorer.	`skinsrestorer.admincommand`
`/sr createcustom <skinName> <skinInput>`	Creates a custom server-wide skin.	`skinsrestorer.admincommand.createcustom`
`/sr createcustom <skinName> <skinInput> <skinVariant>`	Creates a custom server-wide skin.	`skinsrestorer.admincommand.createcustom`
`/sr setskinall <skinName> <skinVariant>`	Sets one skin for every player.	`skinsrestorer.admincommand.setskinall`
`/sr info <playerOrSkin> <input>`	Displays info about a player or skin.	`skinsrestorer.admincommand.info`
`/sr props <playerOrSkin> <input>`	Displays info about a player or skin.	`skinsrestorer.admincommand.info`
`/sr lookup <playerOrSkin> <input>`	Displays info about a player or skin.	`skinsrestorer.admincommand.info`
`/sr drop <playerOrSkin> <target>`	Removes player or skin data from the database.	`skinsrestorer.admincommand.drop`
`/sr remove <playerOrSkin> <target>`	Removes player or skin data from the database.	`skinsrestorer.admincommand.drop`
`/sr purgeolddata <days>`	Removes skin data older than the given age.	`skinsrestorer.admincommand.purgeolddata`
`/sr applyskin <target>`	Applies the target player's skin again.	`skinsrestorer.admincommand.applyskin`
`/sr dump`	Uploads support data to bytebin.lucko.me.	`skinsrestorer.admincommand.dump`
`/sr applyskinall`	Applies every online player's skin again.	`skinsrestorer.admincommand.applyskinall`
`/sr status`	Shows the required API services.	`skinsrestorer.admincommand.status`
`/sr reload`	Reloads the configuration file.	`skinsrestorer.admincommand.reload`

Special permissions

These permissions control specific features.

Permission	Description
`skinsrestorer.bypasscooldown`	Bypasses any command cooldown in the configuration.
`skinsrestorer.bypassdisabled`	Bypasses the list of disabled skins in the configuration.
`skinsrestorer.ownskin`	Allows access to set your own skin.
`skinsrestorer.skin.<skin>`	Allows access to a specific skin if `perSkinPermissions` is enabled.

Cooldowns

Cooldowns limit repeated commands.

Default cooldowns

Action	Default	Config option
Skin change	30 seconds	`commands.skinChangeCooldown`
Skin error retry	5 seconds	`commands.skinErrorCooldown`
Skull command	30 seconds	`commands.skullCooldown`
Skull error retry	5 seconds	`commands.skullErrorCooldown`

Bypassing cooldowns

Grant skinsrestorer.bypasscooldown to ignore all cooldowns.

Permission plugin examples

LuckPerms

Give all players basic skin access:

/lp group default permission set skinsrestorer.player true

Give staff admin commands:

/lp group staff permission set skinsrestorer.admin true

PermissionsEx (Legacy)

/pex group default add skinsrestorer.player
/pex group staff add skinsrestorer.admin
/pex group vip add skinsrestorer.bypasscooldown

Restricting skin access

Disable specific skins

Add skins to the disabled list in config.yml:

commands:
  disabledSkins:
    - "steve"
    - "owner"
    - "admin"
    - "inappropriateskin"

Players with skinsrestorer.bypassdisabled can still use these skins.

Restrict URL domains

Allow skin URLs only from specific domains:

commands:
  restrictSkinUrls:
    enabled: true
    list:
      - "https://i.imgur.com"
      - "https://textures.minecraft.net"

Per-skin permissions

Require a permission for each listed skin:

commands:
  perSkinPermissions:
    enabled: true
    list:
      - "Notch"
      - "specialskin"

Players need skinsrestorer.skin.<skinname> to use skins in the list.

Command usage examples

Set skin for every player

Use this command to change every online player's skin until they rejoin:

/sr setskinall <skinName> <skinVariant>

Example:

/sr setskinall Santa classic

Create a custom server skin

Create a skin that all players can use:

/sr createcustom <name> <playerName|url>

Examples:

/sr createcustom staff Notch
/sr createcustom event "https://i.imgur.com/abc123.png" slim

Look up skin information

/sr info player <playerName>
/sr info skin <skinName>

Remove old data

Purge skin data older than 30 days:

/sr purgeolddata 30

Create a support report

If you need support, run /sr dump. Then send the generated link to the developers.

/sr dump

The command uploads server information, the configuration, and logs to a paste service.

Commands and Permissions

On this page