# Whether custom skins are enabled in the /skins GUI
enabled:false
# Order of custom skins relative to the other skin types
index:0
# Whether only specific custom skins are allowed in the /skins GUI
onlyShowList:true
# Specific custom skins to show in the /skins GUI
list:
- xknat
- pistonmaster
# Control player skins in the /skins GUI
players:
# Whether player skins are enabled in the /skins GUI
enabled:false
# Order of player skins relative to the other skin types
index:1
# Whether only specific player skins are allowed in the /skins GUI
onlyShowList:false
# Specific player skins to show in the /skins GUI
list:
- 7dcfc130-344a-4719-9fbe-3176bc2075c6
- b1ae0778-4817-436c-96a3-a72c67cda060
# Control recommended skins in the /skins GUI
recommendations:
# Whether recommended skins are enabled in the /skins GUI
enabled:true
# Order of recommended skins relative to the other skin types
index:2
# Whether only specific recommended skins are allowed in the /skins GUI
onlyShowList:false
# Specific recommended skins to show in the /skins GUI
list:
- vampire
- space-suit
###########
# Storage #
###########
# Here you can design the plugin the way you want it.
# Enable or disable default skins
# applyForPremium: false will only put a skin on skinless/steve players.
# If there is more than one, the plugin will choose a random one.
# You can use "<random>" in the defaultSkins list to select a random SkinsRestorer recommended skin.
# [!] url.png skins will be cached and therefore will not be updated
storage:
defaultSkins:
enabled:false
applyForPremium:false
list:
- xknat
- pistonmaster
# <!! Warning !!>
# Enable this will require players to run "/skin update" to update their skin.
disallowAutoUpdateSkin:false
# Time that skins are stored in the database before we request again (in minutes).
# [?] A value of 0 will always trigger a request to the Mojang API.
# [!] Lowering this value will increase the amount of requests which could be a problem on large servers.
skinExpiresAfter:15
# How long we should cache the UUIDs of players (in minutes).
# [?] A value of 0 will always trigger a request to the Mojang API.
# [!] Lowering this value will increase the amount of requests which could be a problem on large servers.
uuidExpiresAfter:60
#########
# Proxy #
#########
# Change proxy specific settings here.
proxy:
# Disable all SkinsRestorer commands on specific backend servers.
# [!] This only works & is relevant if you're using proxies like BungeeCord / Velocity
notAllowedCommandServers:
# Whether to enable the backend server command blocking feature.
enabled:true
# Block players from executing SkinsRestorer commands before having joined a server.
ifNoServerBlockCommand:false
# When false means servers in the list are NOT allowed to execute SkinsRestorer commands, true means ONLY servers in the list are allowed to execute SkinsRestorer commands.
allowList:false
# List of servers where SkinsRestorer commands are allowed/disallowed depending on the 'allowList' setting.
list:
- auth
##########
# Server #
##########
# Change server specific settings here.
server:
# Disabling this will stop SkinsRestorer from changing skins when a player loads a server resource pack.
# When a player loads a server resource pack, their skin is reset. By default, SkinsRestorer reapplies the skin when the player reports that the resource pack has been loaded or an error has occurred.
resourcePackFix:true
# Dismounts a mounted (on a horse, or sitting) player when their skin is updated, preventing players from becoming desynced.
dismountPlayerOnSkinUpdate:true
# Remounts a player that was dismounted after a skin update (above option must be true).
# Disabling this is only recommended if you use plugins that allow you ride other players, or use sit. Otherwise you could get errors or players could be kicked for flying.
remountPlayerOnSkinUpdate:true
# Dismounts all passengers mounting a player (such as plugins that let you ride another player), preventing those players from becoming desynced.
dismountPassengersOnSkinUpdate:false
sound:
# Play a sound when a player runs /skin to change their skin.
enabled:true
# Sound to play when a player runs /skin to change their skin.
# Proxy mode settings. Allows SkinsRestorer to work with proxies.
proxyMode:
# Proxy mode detection. Valid values are ENABLED, DISABLED, AUTO. Auto will auto detect based on your server configuration.
detection:AUTO
# Proxy mode API will make server-side plugin calls to SkinsRestorer API possible. Only works if a database is set up instead of file storage.
api:true
login:
# Stops the process of setting a skin if the LoginEvent was canceled by an AntiBot plugin.
# [?] Unsure? leave this true for better performance.
noSkinIfLoginCanceled:true
# This will make SkinsRestorer always apply the skin even if the player joins as premium on an online mode server.
alwaysApplyPremium:false
api:
# Here you can fill in your APIKey for lower MineSkin request times.
# Key can be requested from https://mineskin.org/apikey
# MineSkin offers 10% off your first three months (all plans except Lite) with the coupon SKINSRESTORER10.
# All plans other than Lite include cape generation, higher limits, and other exclusive features.
# [?] A key is not required, but recommended.
mineskinAPIKey:key
# SkinsRestorer uses MineSkin to generate usable skins from links.
# All skins generated by MineSkin are by default shown in their public gallery on their website.
# Enabling this option will hide all skins generated by MineSkin from their public gallery.
mineskinSecretSkins:false
# SkinsRestorer provides curated recommended skins for players to use
# These skin can be used via /skin random and the /skins GUI
# If you would like to opt out of this feature, set this to false.
# It will prevent loading of recommended skins from storage and downloading new ones.
# Be aware that commands like /skin random will not work without this feature.
fetchRecommendedSkins:true
# Window size in seconds for batching Mojang API requests to avoid rate limits.
# Requests are batched in windows of this duration or up to 10 requests, whichever comes first.
# Default is 1 second.
mojangBatchWindowSeconds:1
# Enable Ely.by as a skin data provider.
# When enabled, SkinsRestorer will use Ely.by to fetch player skins instead of Mojang.
# This is useful for servers that support non-premium players using Ely.by accounts.
# Disabled by default. Enable only if your server uses Ely.by.
elyByEnabled:false
###############
# Danger Zone #
###############
# ABSOLUTELY DO NOT CHANGE SETTINGS HERE IF YOU DO NOT KNOW WHAT YOU DO!
advanced:
# <!! Warning !!>
# Enabling this will stop SkinsRestorer to change skins on join.
# Handy for when you want run /skin apply to apply skin after texturepack popup
disableOnJoinSkins:false
# <!! Warning !!>
# This enables the PaperMC join event integration that allows instant skins on join.
# It is recommended over the fallback listener because it is smoother and should not lag the server.
# It also fixes all resource pack skin apply issues.
# If your players are experiencing extremely long loading screens, try disabling this.
enablePaperJoinListener:true
# <!! Warning !!>
# This is a very dangerous feature that should only be used if you know what you are doing.
# Instead of resending player skins to other players by hiding and shadowing them, we will teleport them to a far away location and back
# This is a workaround for some server software with broken vanishing support, like Arclight.
teleportRefresh:false
# <!! Warning !!>
# When enabled SkinsRestorer will not try to connect to any web server, which means the follow things won't work:
# Getting new skins from Mojang, looking up uuids of players, skin url, update checking and more.
# SkinsRestorer will only be able to access already downloaded skins.
# This is useful for servers that are not connected to the internet or have a firewall blocking connections.
noConnections:false
# <!! Warning !!>
# When enabled SkinsRestorer will use the new player head objects inside chat messages.
# While these new objects look great, they are not supported by all server software and plugins, especially older servers.
# This option will be on by default in the future when backwards compatibility is no longer a concern.
playerHeadChatObjects:false
# Updater Settings
# <!! Warning !!>
# Using outdated version void's support, compatibility & stability.
# To block all types of automatic updates (which can risk keeping an exploit):
# Create a file called 'noautoupdate.txt' in the plugin directory (./plugins/SkinsRestorer/ )
################
# DEV's corner #
################
# Enable these on the dev's request
dev:
# Enable to start receiving debug messages about api requests & more.
debug:false
# End #
# Useful tools:
#
# SkinFile Generator:
# With SkinFile Generator, you can upload your own custom skin to get a unique .skin file that you can put in your skins folder, to use with SkinsRestorer.
# Check it out here: https://generator.skinsrestorer.net
#
# SkinSystem:
# With SkinSystem, you, as a server owner, can connect AuthMe with the SkinSystem website that you can host, to give your players the ability to upload custom skins.
# Check it out here: https://github.com/SkinsRestorer/SkinSystem
