MRtoolbar

Tool-Slots für die Hotbar: Ein Hotbar-Slot wird zum Werkzeuggürtel mit bis zu 8 Tools, durch die du per Taste schaltest. Spitzhacke, Axt, Schaufel und Schwert brauchen nur noch einen Platz - der Rest der Hotbar bleibt frei für Blöcke und Essen. Dazu: Inventar und Kisten mit einem Klick sortieren.

MRtoolbar besteht aus zwei Teilen - beide gibt es auf der Download-Seite:

Spieler ohne Mod spielen ganz normal auf dem Server, nur ohne Werkzeugleiste. Plugin und Mod haben eigene Versionen: Nicht jedes Plugin-Update braucht ein Mod-Update.

#Was kann MRtoolbar?

• Tool-Slots: Ein Hotbar-Slot wird zum Gürtel mit bis zu 8 Werkzeugen. Du schaltest per Taste oder Alt + Mausrad durch - die Hotbar bleibt frei für Blöcke und Essen.
• Mending im Gürtel: Werkzeuge mit Mending werden auch im Gürtel repariert - erst der Gürtel in der Hand, dann die anderen.
• Inventar und Kisten sortieren mit einem Mausrad-Klick. Welche Slots dabei bleiben, legst du selbst fest.
• Hotbar-Design: Rahmen, Ecken, Unterstrich, Hintergrund oder eine eigene Textur für deine Tool-Slots.
• Sicher: Alle Items liegen auf dem Server, der Mod zeigt nur an. Spieler ohne Mod spielen ganz normal und holen ihre Tools mit /toolbar takeback zurück.
• Für Admins: Anzahl der Slots und Gürtelgröße per Permission, Übersicht über alle Gürtel, alles in der config.yml einstellbar.

#Für Spieler

#Einrichten

1. Fabric Loader und Fabric API für Minecraft 26.3 installieren.
2. Den MRtoolbar-Mod herunterladen (Zeile „Fabric-Mod (Client)“) und in den Ordner mods/ legen.
3. Auf den Server gehen und /toolbar öffnen: Einen Hotbar-Slot zum Tool-Slot machen.
4. Auf dem Tool-Slot B drücken: Der Gürtel öffnet sich wie eine Kiste - Tools hineinlegen.
5. Alt halten + Mausrad schaltet durch die Tools.

#Tasten

Alle Tasten änderst du unter Optionen → Steuerung → MRtoolbar.

#Inventar sortieren

Gleiche Items werden zusammengelegt und nach Kategorie, Name oder Menge geordnet. In /toolbar → Trichter (oder /toolbar sort) legst du fest, welche Slots bleiben, wo sie sind: Ein Menü wie dein Inventar, jeder Slot ein Schalter - grün wird sortiert, rot bleibt. Standardmäßig bleibt die Hotbar, wie sie ist. Tool-Slots, Rüstung und Zweithand werden nie angefasst.

#Hotbar-Design

Wie deine Tool-Slots in der Hotbar markiert werden: Rahmen, Ecken, Unterstrich, Hintergrund oder eine Textur aus deinem Resourcepack - dazu Farbe, Deckkraft, Dicke und Abstand. Öffnen über den Knopf in /toolbar, eine eigene Taste oder „Konfigurieren“ in Mod Menu. Gespeichert wird auf deinem PC in config/mrtoolbar.json.

#Befehle für Spieler

Ob es ein Mod-Update gibt, zeigt /toolbar im Buch oben links.

#Für Server-Admins

#Schnellstart

1. Plugin herunterladen (Zeile „Plugin (Server)“) und in den Ordner plugins/ legen.
2. Den Server starten.
3. Spielern die Rechte geben - ohne sie dürfen nur OPs die Werkzeugleiste nutzen:

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

4. Deinen Spielern den Link zum Mod geben: https://mrtechnology.marcelr.at/download/mrtoolbar/. Im Spiel steht der Link auch in /toolbar, und wer mit Tool-Slots, aber ohne Mod beitritt, bekommt einen Hinweis mit Link.

Update: Die alte JAR durch die neue ersetzen und den Server neu starten. Die Config wird automatisch angepasst.

#Befehle

#Permissions

/lp group default permission set mrtoolbar.player true      # alle Spieler
/lp group vip permission set mrtoolbar.slots.3 true          # VIPs: 3 Tool-Slots …
/lp group vip permission set mrtoolbar.belt.8 true           # … mit je 8 Plätzen
/lp group default permission set mrtoolbar.sort.containers false   # Kisten nicht sortieren

#Konfiguration

Am einfachsten im Browser: Mit MRadmin (ab der Version mit „Konfiguration im Browser“) unter Plugins → MRtoolbar → Konfiguration - jede Einstellung mit Erklärung, Speichern lädt MRtoolbar sofort neu (Permission mradmin.config). Alles steht außerdem kommentiert in plugins/MRtoolbar/config.yml; Änderungen von Hand übernimmst du mit /mrtoolbar reload.

Alle Texte stehen in plugins/MRtoolbar/lang/de.yml und en.yml (MiniMessage). Plugin und Mod richten sich nach der Minecraft-Sprache des Spielers - so gibt es keine gemischten Sprachen. Eine eigene fr.yml bekommen französische Spieler automatisch.

#Discord-Log

MRtoolbar meldet in einen Discord-Kanal, wer mit zu alter, zu neuer oder ganz ohne Mod spielt, wenn das Team einen Gürtel ansieht und wenn jemand neu lädt.

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. /mrtoolbar reload, dann mit /mrtoolbar discord test prüfen.

Unter discord.events legst du pro Ereignis fest, ob es gesendet wird und in welcher Farbe (mod-too-old, mod-too-new, mod-missing, belt-view, admin-reload). „Ohne Mod“ (mod-missing) ist anfangs aus, weil es bei jedem Login ohne Mod kommt. Die Texte stehen in der Sprachdatei unter discord.

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.

#Wie Plugin und Mod zusammenarbeiten

Der Server macht alles, was mit Items zu tun hat: Gürtel speichern, Tools wechseln, Tool-Slots schützen, Rechte, Tod. Der Mod kümmert sich nur um Tasten und Darstellung und fragt beim Server an - er kann keine Items erzeugen oder verschieben. Beim Betreten prüfen beide, ob ihre Versionen zusammenpassen. Details: docs/COMPATIBILITY.md.

#Zusammenarbeit mit anderen Plugins

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

#Multiverse-Inventories

Jede Inventar-Gruppe hat eigene Tool-Slots und Gürtel. Wechselt Multiverse-Inventories das Inventar, wechseln die Gürtel mit, damit keine Werkzeuge zwischen getrennten Gruppen wandern. Bei deinem ersten Besuch in einer Gruppe gibt es dort noch keine Tool-Slots, du richtest sie wie gewohnt mit /toolbar ein. An/Aus und die Sortier-Einstellungen gelten überall.

#Häufige Fragen

Ich drücke B, aber nichts passiert. Prüf, ob der Mod geladen ist (Mod Menu) und ob der Slot ein Tool-Slot ist (/toolbar). Admins sehen mit /mrtoolbar debug <spieler>, ob die Verbindung zum Mod steht.

Muss jeder Spieler den Mod installieren? Nein. Spieler ohne Mod spielen ganz normal, nur ohne Werkzeugleiste. /toolbar takeback und das Sortieren über /toolbar sort gehen auch ohne Mod.

Was passiert mit den Tools beim Tod? Standardmäßig fallen sie wie normale Items (toolbar.on-death: drop). Mit keep bleiben sie im Gürtel.

Repariert Mending auch die Tools im Gürtel? Ja. Was Minecraft nicht für das Item in der Hand und die Rüstung braucht, geht an die Gürtel: zuerst an den Gürtel des Tool-Slots, den du gerade in der Hand hast, dann an die anderen Gürtel von links nach rechts - in jedem Gürtel ein Tool nach dem anderen, in der Reihenfolge, in der sie im Gürtel liegen. Erst wenn alles heil ist, bekommst du die XP. Abschalten: toolbar.mending: false bzw. Permission mrtoolbar.mending entziehen.

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

#Lizenz

MRtoolbar (Plugin und Mod) 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