MRsleep

Faire Schlafquote für Multiplayer-Server: Wer nicht mitschlafen kann oder will, bremst die Nacht nicht mehr aus, und mit /nosleep hält man die Nacht fest, wenn man sie für eine Farm braucht.

#Was kann MRsleep?

• Schlafquote mit Ausnahmen: Bots, Cam-Accounts, Zuschauer und AFK-Spieler zählen nicht mit. Die Nacht wird übersprungen, sobald genug echte Spieler schlafen.
• /nosleep: Ein Spieler blockiert das Schlafen für eine oder mehrere Nächte - perfekt für Mob-Farmen oder Bauprojekte bei Nacht.
• Admin-Menü: Alle Spieler als Köpfe mit Live-Status. Sperren, Cooldown aufheben oder Blockaden lösen geht per Klick.
• Anzeige nach Wahl: Fortschritt als Bossbar, Actionbar oder Titel, dazu Chat-Hinweise wie „Alex hat sich schlafen gelegt (1/2)“.
• Alles einstellbar: Eine config.yml, alle Texte in Sprachdateien, für jede Funktion eine eigene Permission.
• Discord-Logs über einen Webhook und eine Update-Prüfung, die dich im Spiel informiert.

#Schnellstart

1. MRsleep herunterladen und die JAR in den Ordner plugins/ legen.
2. Den Server starten. Dabei entstehen plugins/MRsleep/config.yml und die Sprachdateien in plugins/MRsleep/lang/.
3. Rechte geben - Spieler brauchen sie für /nosleep, das Team für das Admin-Menü:

   /lp group default permission set mrsleep.player true
   /lp group supporter permission set mrsleep.groups.support true
   /lp group staff permission set mrsleep.groups.staff true
   /lp group admin permission set mrsleep.groups.admin true
   

4. Fertig - die Standardquote ist 50 %. Wer etwas anpassen will: Config ändern und /mrsleep reload ausführen.

Nutzt du LuckPerms mit *-Rechten für Admins? Dann lies kurz den Hinweis zu Wildcards, sonst zählen deine Admins nicht zur Quote.

Update: Die alte JAR durch die neue ersetzen und den Server neu starten. Ändert sich der Aufbau der Config, passt MRsleep sie automatisch an: Deine Einstellungen bleiben, neue Optionen kommen mit Standardwerten dazu, und die alte Datei wird als config.v<N>.backup.yml gesichert.

#Funktionen

#Schlafquote mit Ausnahmen

Spieler, die nicht zählen, werden komplett aus der Rechnung genommen:

Quote 50 %, 6 Spieler online, 2 davon sind Bots mit mrsleep.exempt → es zählen 4 Spieler → 2 müssen schlafen.

Nicht mitgezählt werden:

• Spieler mit der Permission mrsleep.exempt (z.B. Bots und Cam-Accounts)
• Zuschauer (sleep.ignore.spectators)
• Spieler, die ein AFK-Plugin als „sleeping ignored“ markiert (sleep.ignore.sleeping-ignored)
• Spieler im Admin-Modus von MRadmin und Spieler im Duell bei MRpvp - siehe Zusammenarbeit mit anderen Plugins
• Dummy-Spieler von MRchunks

Wer nicht zählt, bekommt beim Hinlegen einen Hinweis mit dem Grund. Wie in Vanilla wird die Nacht übersprungen, wenn die nötigen Spieler etwa 5 Sekunden im Bett liegen.

Verwaltet werden alle normalen Oberwelten. Nether und End sind ausgenommen, weitere Welten schließt du über sleep.disabled-worlds aus.

Jede Welt stimmt für sich ab, Zeit und Wetter ändern sich nur dort - das gilt auch für zusätzliche Welten von Multiverse.

#/nosleep - die Nacht festhalten

• Solange irgendein Spieler blockiert, wird die Nacht nicht übersprungen. Alle anderen sehen, wer blockiert.
• Cooldown (Standard 15m, nosleep.cooldown): Er startet erst, wenn die blockierte Nacht anbricht. Wer tagsüber blockiert und vor Nachtbeginn wieder aufhebt, bekommt keinen Cooldown. Auch OPs haben ihn - außer sie bekommen mrsleep.nosleep.nocooldown.
• Geht der blockierende Spieler offline, endet seine Blockade (nosleep.release-on-quit).
• Admins können den Cooldown eines Spielers auf Zeit aufheben (Bypass) oder Spieler von /nosleep sperren.
• Blockaden, Cooldowns, Bypässe und Sperren überstehen einen Neustart.

#Anzeige & Chat-Hinweise

• Fortschritt als Bossbar (Standard), Actionbar, Titel oder gar nicht (sleep.display.mode). Die Bossbar wird vom Chat im Bett nicht verdeckt.
• Die eingebaute Minecraft-Anzeige „x/y Spieler schlafen“ in der Actionbar zählt alle Spieler und kennt die Regeln von MRsleep nicht. MRsleep ersetzt sie deshalb sofort durch den eigenen Fortschritt (bei sleep.display.mode: actionbar) bzw. blendet sie aus (sleep.display.hide-vanilla-message, Standard an).
• Schlaf-Nachricht „Alex hat sich schlafen gelegt (1/2)“ an die Welt, den ganzen Server oder niemanden (sleep.chat.sleep-message).
• Hinweise, wenn die Nacht blockiert ist, wenn sie übersprungen wurde („Guten Morgen!“), wenn eine Blockade abläuft und wenn ein Admin etwas ändert.
• Jeder Text steht in der Sprachdatei und lässt sich ändern oder mit "" abschalten.

#Admin-Menü

/mrsleep gui öffnet eine Übersicht, die sich jede Sekunde aktualisiert:

• Welt: Uhrzeit, wie viele zählen, schlafen und gebraucht werden, wer blockiert. Ein Klick wechselt zur nächsten Welt.
• Spielerköpfe: Blockierer leuchten. Der Tooltip zeigt, ob jemand zählt (und warum nicht), schläft, blockiert, Cooldown oder eine Sperre hat.
• Filter: Alle, Schlafende, Blockierer, Ausgenommene, Gesperrte.

Ein Klick auf einen Kopf öffnet das Spieler-Menü: Bypass für 30m / 2h / 1d, Cooldown zurücksetzen, Sperren für 1h / 1d / dauerhaft, Blockade aufheben, zum Spieler teleportieren. Jede Aktion braucht ihre eigene Permission - fehlt sie, steht „Keine Berechtigung“ am Button. Die Zeiten und Sounds stellst du unter gui in der Config ein.

Wie lange das Team darf (limits in der Config - gilt für Befehle, Menü und die MRadmin-Weboberfläche):

Knöpfe mit einer längeren Dauer zeigen „Keine Berechtigung“, ein zu langer Befehl sagt, wie lange man höchstens darf.

#Befehle

Alle Befehle haben Tab-Vervollständigung. Bypass, Sperren und Cooldown-Reset funktionieren auch bei Spielern, die gerade offline sind.

#Permissions

Wildcards: Gruppen mit * oder mrsleep.* bekommen in LuckPerms auch mrsleep.exempt - und zählen dann nicht zur Quote. Setz für solche Gruppen mrsleep.exempt ausdrücklich auf false: /lp group admin permission set mrsleep.exempt false

/lp user CamAccount permission set mrsleep.exempt true          # Bot aus der Quote nehmen
/lp group mod permission set mrsleep.groups.staff true          # Mods: wie Staff …
/lp group mod permission set mrsleep.admin.ban.unlimited true   # … aber auch dauerhaft sperren
/lp group vip permission set mrsleep.nosleep.nocooldown true    # VIPs ohne Cooldown
/lp group guest permission set mrsleep.nosleep false            # Gäste ohne /nosleep

#Konfiguration

Am einfachsten im Browser: Mit MRadmin (ab der Version mit „Konfiguration im Browser“) unter Plugins → MRsleep → Konfiguration - jede Einstellung mit Erklärung, Speichern lädt MRsleep sofort neu (Permission mradmin.config). Ohne MRadmin steht alles in plugins/MRsleep/config.yml, jede Option ist dort kommentiert.

• Zeitangaben: d, h, m, s kombinierbar (15m, 1h30m, 2d). Eine reine Zahl zählt als Minuten.
• Änderungen übernehmen: /mrsleep reload - ein Neustart ist nicht nötig.
• config-version bitte nicht ändern - daran erkennt MRsleep, ob die Datei aktualisiert werden muss.
• Umlaute kaputt („ä“ statt „ä“)? Stell die Kodierung im Editor auf UTF-8.

#Sprache & Texte

• Jeder Spieler bekommt seine Sprache: Mit general.language: auto (Standard) richtet sich MRsleep nach der Sprache, die der Spieler in Minecraft eingestellt hat - Deutsch (auch Österreich und Schweiz) bekommt Deutsch, Englisch bekommt Englisch. Für Sprachen ohne eigene Datei gilt general.fallback-language (Standard Englisch). Mit general.language: de oder en bekommen alle dieselbe Sprache.
• Server-Sprache: Discord-Logs haben keinen einzelnen Empfänger - sie kommen in general.server-language (Standard en). Auf einem deutschen Server also general.server-language: de setzen.
• Die Konsole ist immer Englisch.
• Alle Texte (Chat, Anzeige, Menüs, Discord) stehen in plugins/MRsleep/lang/<sprache>.yml im MiniMessage-Format. Ein leerer Text ("") schaltet die Nachricht ab.
• Eigene Sprache: lang/en.yml kopieren (z.B. als lang/fr.yml) und übersetzen - mit general.language: auto bekommen französische Spieler sie dann automatisch.
• Neue Texte aus Updates ergänzt MRsleep automatisch - deine Änderungen bleiben erhalten.

#Discord-Webhook

1. In Discord: Kanal bearbeiten → Integrationen → Webhooks → Neuer Webhook und die Webhook-URL kopieren.
2. In der Config discord.enabled: true setzen und die URL bei webhook-url eintragen.
3. /mrsleep reload, dann mit /mrsleep discord test prüfen - der Befehl sagt dir, ob die Nachricht ankam oder warum nicht.

Unter discord.events legst du pro Ereignis fest, ob es gesendet wird und in welcher Farbe (z.B. nosleep-activated, night-skipped, admin-ban). Die Texte stehen in der Sprachdatei unter discord. @everyone löst nie einen Ping aus.

Kein eigener Webhook? Mit MRadmin geht es auch über dessen Discord-Log: discord.enabled: true, webhook-url leer lassen und discord.use-mradmin-webhook: true setzen.

Mit MRadmin steht jedes Ereignis außerdem im Protokoll der Weboberfläche (bis zu 14 Tage) - auch wenn Discord aus ist.

#Update-Prüfung

MRsleep prüft beim Start und danach alle paar Stunden (updates.interval-hours), ob es eine neue Version gibt:

• in der Konsole mit Download-Link,
• im Spiel für Spieler mit mrsleep.admin.update als anklickbarer Hinweis beim Betreten,
• jederzeit mit /mrsleep version.

Angeboten werden nur Versionen für deine Minecraft-Version. Wer eine Vorabversion nutzt, bekommt auch neuere Vorabversionen angezeigt.

#Zusammenarbeit mit anderen Plugins

MRsleep läuft allein. Zusammen mit anderen MRtechnology-Plugins kann es mehr - die Plugins sprechen dafür über MRadmin miteinander:

#Häufige Fragen

Ich liege im Bett, aber die Nacht wird nicht übersprungen. Führ /mrsleep debug aus oder öffne das Admin-Menü: Dort steht für jeden Spieler, ob er zählt (und warum nicht), ob er schläft und ob jemand blockiert. Häufigste Ursache: Über * hat ein Spieler auch mrsleep.exempt - siehe Wildcards.

Die Gamerule playersSleepingPercentage steht auf 100. Das ist gewollt, die Quote kommt aus sleep.percentage.

Was zählt als „eine Nacht“? Wer tagsüber /nosleep nutzt, blockiert die kommende Nacht, wer es nachts nutzt, die laufende. Blockaden gelten pro Welt.

Ich habe einen Fehler gefunden oder einen Wunsch. Gern über das Formular auf der Website - am besten mit der Ausgabe von /mrsleep version und /mrsleep debug.

#Lizenz

MRsleep steht unter der MRtechnology Lizenz (source-available, nicht Open Source). Kurz gesagt:

Die Nutzung erfolgt auf eigenes Risiko - leg vor Updates eine Sicherung an. Maßgeblich ist der vollständige Text in LICENSE.

#Für Entwickler

Selbst bauen mit Java 25: gradlew build → build/libs/MRsleep-mc<minecraft>-v<version>.jar. Versionen heißen mc<minecraft>-v<version> (z.B. mc26.3-v1.1.5). Aufbau des Codes: docs/DOKUMENTATION.md, Branches und Releases: docs/RELEASES.md.