MRwaypoints

Gemeinsame Wegpunkte für deinen Server: Das Team legt Kategorien fest (Spawn, Shops, Farmen …), Spieler und Team tragen dort Wegpunkte ein - und jeder findet sie im Spiel über ein Menü mit Wegweiser, in Xaero's Minimap und World Map und auf der Karte der Spielerseite (mit MRadmin).

MRwaypoints ist eine Vorabversion. Rückmeldungen gern über Fehler melden.

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

Spieler ohne Mod nutzen Menü und Wegweiser ganz normal. Plugin und Mod haben eigene Versionen.

#Was kann MRwaypoints?

• Kategorien vom Team: Name pro Sprache, Farbe, Symbol, wer darin Wegpunkte anlegen darf und wie viele pro Spieler.
• Wegpunkte auf dem Server gespeichert: Jeder sieht dieselben - anders als private Wegpunkte in Xaero, die nur auf deinem PC liegen.
• Menü /waypoints für alle: meine Wegpunkte, alle Wegpunkte (mit Filter nach Kategorie, Sortierung und Suche), neue Wegpunkte an der eigenen Position anlegen - immer für die Dimension, in der du bist.
• Wegweiser: Ein Klick auf einen Wegpunkt zeigt in der Actionbar einen Pfeil, die Entfernung und den Höhenunterschied - ohne Mod.
• Teleport nur fürs Team (Admins).

#Schnellstart

1. MRwaypoints herunterladen und die JAR in den Ordner plugins/ legen.
2. Den Server starten. Dabei entstehen plugins/MRwaypoints/config.yml, categories.yml mit vier Beispiel-Kategorien und die Sprachdateien in plugins/MRwaypoints/lang/.
3. Rechte geben - ohne sie dürfen nur OPs:

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

4. Die Kategorien in plugins/MRwaypoints/categories.yml anpassen und /mrwaypoints reload.

Update: Die alte JAR durch die neue ersetzen und den Server neu starten. Die Config wird automatisch angepasst: Deine Werte bleiben, neue Optionen kommen dazu, und die alte Datei wird als config.v<N>.backup.yml gesichert.

#Für Spieler

/waypoints (auch /waypoint, /wegpunkte) öffnet ein kleines Menü mit drei Knöpfen. Alles darin gilt für die Welt bzw. Dimension, in der du gerade bist - Wegpunkte im Nether siehst du im Nether.

In den Listen:

Private Wegpunkte legst du wie gewohnt direkt in Xaero's Minimap an - sie bleiben auf deinem PC.

#In Xaero's Minimap und World Map (mit Mod)

1. Fabric API, Xaero's Minimap (und gern Xaero's World Map) und den MRwaypoints-Mod (Zeile „Fabric-Mod (Client)“) in den Ordner mods/ legen.

2. Auf den Server gehen - die Server-Wegpunkte erscheinen von selbst auf der Minimap, im Spiel und auf der World Map, in der Farbe ihrer Kategorie. Sie liegen getrennt von deinen eigenen Xaero-Wegpunkten.

3. Ein Menü für alles: Die Taste J (änderbar unter Optionen → Steuerung → MRwaypoints) und der Knopf „Server-Wegpunkte …“ in Xaeros Wegpunkt-Menü öffnen /waypoints. Dort schaltest du unter Kategorien ein und aus, welche Kategorien in Xaero erscheinen (Klick pro Kategorie, „Alle an“ / „Alle aus“). Deine Auswahl speichert der Server - sie gilt auf jedem PC und auch auf der Spielerseite im Web.

4. Tasten (Optionen → Steuerung → MRwaypoints, schneller über /waypoints → Einstellungen → Tastenbelegung): nur J ist vorbelegt, die anderen legst du selbst fest, damit nichts mit Xaero oder anderen Mods kollidiert.

   Taste	Was passiert
   Wegpunkt-Menü (J)	/waypoints
   Wegpunkt hier erstellen	der Dialog mit Name und Kategorie - wie im Menü
   Server-Wegpunkte ein/aus	alle Server-Wegpunkte in Xaero aus- und wieder einblenden (nur auf diesem PC, deine Auswahl pro Kategorie bleibt)

5. Sichtweite und Anzeige: In /waypoints → Einstellungen legst du fest, wie du die Server-Wegpunkte siehst. Der Server speichert das für dich. Der Knopf Tastenbelegung dort öffnet Minecrafts Steuerung, um die Tasten von MRwaypoints festzulegen.

   Einstellung	Was sie tut
   Sichtweite	wie weit um dich die Wegpunkte im Spiel und auf der Minimap erscheinen: 10, 20, 50 oder 100 Chunks in jede Richtung oder unbegrenzt (Linksklick weiter, Rechtsklick näher; die Stufen legt der Server fest). Xaeros eigene Grenze für Wegpunkte im Spiel gilt zusätzlich.
   Anzeige	„Welt, Minimap und Weltkarte“ oder „nur Weltkarte“
   Entfernte auf der Weltkarte	Wegpunkte außerhalb der Sichtweite trotzdem auf der World Map zeigen (nur bei begrenzter Sichtweite)

   Xaero zeigt einen Wegpunkt im Spiel und auf der Minimap immer gemeinsam - „nur Minimap“ oder „nur im Spiel“ gibt es pro Wegpunkt nicht. Dafür hat Xaero eigene Einstellungen, die dann für alle Wegpunkte gelten.

#Für Server-Admins

#Kategorien

Am bequemsten in der MRadmin-Weboberfläche (Seite Wegpunkte, mrwaypoints.admin.categories) - ohne MRadmin direkt in der Datei. In plugins/MRwaypoints/categories.yml, danach /mrwaypoints reload:

Mitgeliefert sind Spawn & Warps (nur Team), Shops (Spieler, je 3), Farmen (Spieler, je 5, nicht auf der Karte) und Sehenswürdigkeiten (Spieler, je 3).

Löschst du eine Kategorie aus der Datei, verschwinden ihre Wegpunkte aus den Menüs, bleiben aber in waypoints.yml. Mit derselben id kommen sie zurück.

#Befehle

#Permissions

Am einfachsten vergibst du die Gruppen - sie sind in allen MRtechnology-Plugins gleich aufgebaut, jede enthält die darunter. Standardmäßig haben sie nur OPs.

Shops nur für VIPs? players-create: false setzen und /lp group vip permission set mrwaypoints.create.shops true.

#Konfiguration

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

Texte: Alle Texte stehen in plugins/MRwaypoints/lang/<sprache>.yml, die Namen der Kategorien in categories.yml. Die Konsole ist immer Englisch.

#Discord-Log

MRwaypoints meldet in einen Discord-Kanal, wenn Wegpunkte angelegt, umbenannt, in eine andere Kategorie verschoben, versetzt oder gelöscht werden (auch mehrere auf einmal im Web), wenn Kategorien angelegt, geändert, gelöscht oder umsortiert werden, wenn sich ein Admin zu einem Wegpunkt teleportiert und wenn jemand neu lädt - egal ob im Spiel, auf der Seite Wegpunkte oder auf der Karte der Spielerseite.

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

Unter discord.events legst du pro Ereignis fest, ob es gesendet wird und in welcher Farbe (z.B. waypoint-created, waypoint-deleted, category-changed, teleport). Die Texte stehen in der Sprachdatei unter discord, Kategorien heißen dort wie in general.server-language.

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.

#Zusammenarbeit mit anderen Plugins

MRwaypoints läuft allein. Zusammen mit anderen MRtechnology-Plugins kann es mehr:

#Häufige Fragen

Ein Spieler kann keinen Wegpunkt anlegen. In der Kategorie braucht er mrwaypoints.create.<kategorie> - oder die Kategorie hat players-create: true und er hat mrwaypoints.player. Ist das Limit (max-per-player) erreicht, wird der Knopf grau.

Brauchen Spieler einen Mod? Nein. Menü und Wegweiser funktionieren mit jedem Client. Der Mod bringt die Wegpunkte zusätzlich in Xaero's Karten.

Mit Mod erscheinen keine Wegpunkte in Xaero. Ist die Kategorie für dich eingeschaltet (/waypoints → Kategorien)? Ist Xaero's Minimap installiert (die World Map allein reicht nicht)? Im Client-Log steht „Connected to MRwaypoints …“ bzw. bei einer nicht unterstützten Xaero-Version eine Fehlermeldung.

#Lizenz

MRwaypoints 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