Discord
SkinsRestorer
Wiki - Plugins

SkinsRestorer: Skins auf deinem Server verwalten

SkinsRestorer ist das beliebteste Plugin zur Verwaltung von Skins auf Minecraft-Servern. Spieler ändern damit ihren Skin per /skin-Befehl, ohne sich neu einzuloggen. Es funktioniert auf Offline-Mode-Servern und synchronisiert Skins über BungeeCord-/Velocity-Netzwerke.

Lesezeit: ca. 5 Min. Plattform: Paper / Spigot / Velocity / BungeeCord

Was SkinsRestorer ist

SkinsRestorer ist ein kostenloses Open-Source-Plugin, das Spielern die Kontrolle über ihren Skin direkt auf dem Server gibt. Im normalen Minecraft musst du zum Ändern deines Skins auf minecraft.net gehen, eine PNG-Datei hochladen und dich neu mit dem Server verbinden. SkinsRestorer macht daraus einen einzigen Befehl.

Am wichtigsten ist das Plugin auf Servern im Offline-Modus (online-mode: false), auf denen die Skins der Spieler nicht an ein Mojang-Konto gebunden sind. Mit SkinsRestorer können sie einen beliebigen Skin wählen, und er bleibt über Sitzungen hinweg erhalten.

SkinsRestorer ist auf Tausenden Servern installiert und hat über 3 Millionen Downloads. Du bekommst es auf der offiziellen Website, bei SpigotMC oder bei Modrinth.

Skin-Befehle

Befehl Was er macht Berechtigung
/skin set [nick] Setzt den Skin eines anderen Spielers mit Premium-Account skinsrestorer.command.skin.set
/skin url [link] Setzt einen Skin aus einer PNG-Datei (URL) skinsrestorer.command.skin.set.url
/skin clear Setzt den Skin auf den Standard zurück (Steve/Alex) skinsrestorer.command.skin.clear
/skin update Aktualisiert deinen Skin (nachdem du ihn auf minecraft.net geändert hast) skinsrestorer.command.skin.update
/skins Öffnet eine GUI mit einer Liste verfügbarer Skins skinsrestorer.command.skins

Mit dem Befehl /skin set kannst du den Skin jedes Spielers mit Premium-Account verwenden. Du gibst den Namen eines bekannten Spielers ein (zum Beispiel Technoblade, Dream), und SkinsRestorer holt sich dessen Skin von der Mojang-API. Die Änderung gilt sofort: Du musst dich nicht neu einloggen.

Installation

Auf einem einzelnen Server besteht die Installation darin, die .jar-Datei in plugins/ zu legen und neu zu starten. In einem Netzwerk aus mehreren Servern ist das Setup etwas aufwendiger:

  1. Installiere SkinsRestorer auf dem Proxy (Velocity oder BungeeCord)
  2. Installiere SkinsRestorer auf jedem Backend-Server
  3. Stelle SkinsRestorer auf den Backend-Servern auf den Proxy-Modus

Setze in plugins/SkinsRestorer/config.yml auf den Backends Folgendes:

# Auf Backend-Servern hinter einem Proxy
api:
  enabled: true

# Skin-Befehle auf den Backends nicht erlauben - nur auf dem Proxy
commands:
  disable-skin-command-on-backend: true

So kümmert sich der Proxy um die Skin-Befehle, und die Backends zeigen nur die vom Proxy synchronisierten Skins an.

Netzwerk-Setup

In einem Servernetzwerk synchronisiert SkinsRestorer Skins über Plugin Messaging (den BungeeCord-/Velocity-Kanal). Ändert ein Spieler seinen Skin auf dem Proxy, wird die Änderung automatisch an alle Backend-Server weitergegeben.

Wichtige Netzwerk-Einstellungen:

  • Proxy-Modus - installiere die Hauptinstanz auf dem Proxy und auf den Backends nur das Synchronisationsmodul
  • Speicherung - SkinsRestorer speichert Skins in Dateien oder MySQL. In einem Netzwerk empfiehlt sich MySQL für den gemeinsamen Zugriff
  • Cache - das Plugin speichert abgerufene Skins zwischen, damit es die Mojang-API nicht bei jedem Login abfragt
  • Cooldown - lege eine Wartezeit für Skin-Wechsel fest (zum Beispiel 30 Sekunden), um API-Spam zu verhindern

Eigene Skins

SkinsRestorer unterstützt mehrere Skin-Quellen:

  • Name eines Premium-Accounts - /skin set Notch holt den aktuellen Skin vom Mojang-Konto
  • URL einer PNG-Datei - /skin url https://example.com/skin.png wandelt das Bild in einen Skin um
  • Skin-GUI - /skins öffnet ein Menü mit vordefinierten Skins (die Liste konfigurierst du in der Config)
  • Standard-Skins - ein Admin kann für neue Spieler statt Steve/Alex einen Standard-Skin festlegen

Die vordefinierten Skins in der GUI konfigurierst du in der skins.yml. Das ist praktisch auf RPG-Servern, wo du den Spielern Skins anbieten willst, die zum Thema des Servers passen (Ritter, Magier, Diebe und so weiter).

Tipps

  • Unpassende Skins sperren - mit SkinsRestorer kannst du bestimmte Skins und Spielernamen sperren (zum Beispiel Skins mit beleidigenden Motiven). Nutze dafür die Sperrliste in der Config
  • Ratenbegrenzung der Mojang-API - die Mojang-API begrenzt Anfragen. SkinsRestorer speichert Skins zwischen, aber wenn sich Hunderte Spieler gleichzeitig einloggen, kann es zu Verzögerungen kommen
  • Funktioniert mit FastLogin - die beiden Plugins arbeiten auf Servern zusammen, die das „Semi-Premium“-Setup von FastLogin nutzen. FastLogin loggt Spieler mit Premium-Accounts ein, SkinsRestorer verwaltet die Skins
  • Skins über die Konsole - ein Admin kann die Skins anderer Spieler in der Server-Konsole mit /skin set [player] [nick] ändern

Verwandt: so änderst du deinen Skin, FastLogin, Velocity.