MRchunks

Chunkloader für Survival-Server: Ein Block, und deine Farm läuft weiter - auch wenn du offline bist. Mit fairen Limits, Einladungen für Mitspieler, Lag-Schutz und einer Webkarte.

#Was kann MRchunks?

• Chunkloader-Blöcke: Einmal platziert, bleibt ein 7×7-Chunk-Bereich dauerhaft geladen - in allen Dimensionen, auch wenn der Spieler offline ist.
• Faire Limits: wie viele Loader ein Spieler setzen darf und wie viele davon gleichzeitig aktiv sind - aus der Config, per Permission oder per Admin-Befehl.
• Mitspieler einladen: Farm-Partner dürfen deine Loader an- und ausschalten.
• Dummy-Spieler (optional): ein künstlicher Spieler auf dem Loader, damit Mobs aktiv bleiben und Farmen wie mit einem echten Spieler daneben laufen.
• Zweit-Accounts verknüpfen: Haupt- und AFK-Account teilen sich Loader und Limit.
• Unzerstörbar: kein Abbauen, keine Explosionen, Kolben, Wither oder Endermen.
• Lag-Schutz: Loader, die den Server ausbremsen, werden erkannt und gesperrt. Laggt der ganze Server, pausieren alle Loader automatisch.
• Webkarte mit echtem Gelände über squaremap, automatisch eingerichtet.
• Menüs statt Befehle für Spieler, ein Admin-Menü für das Team, Discord-Logs und Update-Prüfung.

#Schnellstart

1. MRchunks herunterladen und die JAR in den Ordner plugins/ legen.
2. Den Server starten. Dabei entstehen plugins/MRchunks/config.yml und die Sprachdateien in plugins/MRchunks/lang/.
3. Spielern die Rechte geben - ohne sie dürfen nur OPs Chunkloader nutzen:

   /lp group default permission set mrchunks.player true
   

4. Fertig. Jeder Spieler darf standardmäßig 3 Loader setzen und alle 3 gleichzeitig nutzen. Anpassen in der Config, dann /mrchunks reload.

Gruppen mit * oder mrchunks.* bekommen in LuckPerms auch mrchunks.exempt - und deren Loader werden gelöscht. Setz dort ausdrücklich /lp group admin permission set mrchunks.exempt false. Mehr unter Permissions.

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.

#So funktioniert's (für Spieler)

1. /chunkloader (oder /cl) öffnet dein Menü. Unten rechts holt Chunkloader holen einen Loader ins Inventar (Linksklick 1, Shift bis zu 64 - so viele, wie dein Limit erlaubt). Chunkloader zurückgeben daneben nimmt Items wieder zurück.
2. Block platzieren - ab sofort bleiben die 7×7 Chunks rundherum geladen.
3. Rechtsklick auf den Block öffnet sein Menü: Infos, umbenennen, Mitglieder, Grenze anzeigen, an/aus, Dummy, löschen. Sneak + Rechtsklick verhält sich normal, du kannst also weiter Blöcke daran bauen.
4. Löschen geht nur über das Menü (zweimal klicken). Danach ist dein Limit wieder frei.

Die Menüleiste in /chunkloader von links nach rechts:

Hast du mehr als 45 Loader, erscheinen Pfeile zum Blättern.

#Was der Block im Menü bedeutet

#Was läuft in geladenen Chunks?

• Läuft: Redstone, Trichter, Öfen, Tiere und andere Entities, Pflanzenwachstum - alles, was Zufalls-Ticks braucht.
• Braucht trotzdem einen Spieler in der Nähe: natürliches Mob-Spawning, Spawner und volle Mob-KI (Mobs bewegen sich ohne Spieler kaum und laufen z.B. nicht durch Portale). Dafür gibt es Dummy-Spieler.

#Namen, Nummern und Grenze

• Jeder Loader bekommt die kleinste freie Nummer („Chunkloader 4“). Über Umbenennen gibst du ihm einen eigenen Namen - er erscheint im Chat, in Menüs, auf der Webkarte und in Discord.
• Grenze anzeigen zeichnet einen leuchtenden Zaun an die Außenkante des Bereichs, sichtbar auch durch Blöcke und nur für dich. Er verschwindet nach einer Weile von selbst.

#Mitspieler einladen

Lade Farm-Partner ein, damit sie deine Loader an- und ausschalten können, auch wenn du offline bist:

• Ein Loader: Menü des Loaders → Mitglieder → Spieler einladen.
• Alle Loader (auch künftige): /chunkloader → Mitglieder für alle Loader.
• Dauer mit der Uhr wählen (1 Tag, 7 Tage, 30 Tage oder dauerhaft), dann auf einen Kopf klicken. Für Offline-Spieler gibt es Namen eingeben.
• Eingeladene finden die Loader unter Mit mir geteilt. Umbenennen, löschen und einladen darfst nur du.
• Einladungen zählen bei niemandem zum Limit. Schaltet ein Eingeladener einen Loader an, gilt dein Aktiv-Limit.

#Zweit-Accounts verknüpfen

Hast du einen Zweit-Account (z.B. zum AFK-Farmen), verknüpf ihn mit deinem Haupt-Account. Danach verhalten sich beide wie ein Spieler:

• Beide sehen und verwalten dieselben Loader. Was der Zweit-Account setzt, gehört dem Haupt-Account.
• Es gilt ein gemeinsames Limit - das des Haupt-Accounts.
• Verknüpfen: /chunkloader → Verknüpfte Accounts → Account verknüpfen. Der andere Account muss online sein und zustimmen.
• Lösen kann jeder der beiden jederzeit im selben Menü. Die Loader bleiben beim Haupt-Account.
• Erlaubt ist standardmäßig ein Zweit-Account (linked-accounts.max-accounts). Eine Sperre gilt für alle verknüpften Accounts.

#Dummy-Spieler

Ein Chunkloader hält Chunks geladen - für den Server steht dort aber kein Spieler. Mobs sind deshalb fast inaktiv, und es spawnt nichts. Ein Dummy ist ein künstlicher Spieler, der auf dem Loader sitzt und als Spieler in der Nähe zählt.

• Einschalten: Menü des Loaders → Dummy einschalten. Er sitzt dort, solange der Loader aktiv ist.
• Aussehen: dein Skin, Name [D<nr>]<dein Name>, sitzend.
• Sonst kein Spieler: unverwundbar, von Mobs ignoriert, nicht in der Tab-Liste und nicht in der Spielerzahl. MRsleep, MRadmin und MRpvp ignorieren ihn.
• Limit: standardmäßig 1 pro Spieler, mehr per Permission oder Admin-Befehl.

Dummies sind standardmäßig ausgeschaltet (dummies.enabled: false). Ein Dummy kostet so viel Leistung wie ein echter Spieler an dieser Stelle. Er nutzt Server-Interna von Paper: Passt die MRchunks-Version nicht genau zur Server-Version, bleiben Dummies aus (Hinweis in der Konsole) - alles andere funktioniert normal.

#Befehle (Admin)

Spieler brauchen keine Befehle außer /chunkloader - alles läuft über Menüs. Für das Team gibt es /mrchunks:

Owner dürfen ihre eigenen Loader auch mit toggle und delete steuern.

#Admin-Menü

/mrchunks gui zeigt oben eine Übersicht (Loader, aktive Loader, geladene Chunks, Sperren) und darunter alle Spieler mit Loadern als Köpfe.

• Klick auf einen Kopf: Limits mit Links-/Rechtsklick ändern (+1/−1, Shift = zurücksetzen), alle Loader löschen, sperren oder entsperren - und darunter alle Loader des Spielers.
• Klick auf einen Loader: an/aus, umbenennen, Grenze anzeigen, hinteleportieren, löschen.

Alle Menüs aktualisieren sich jede Sekunde. Jede Aktion prüft ihre eigene Permission.

#Permissions

„OP“ heißt: nur Operatoren haben sie automatisch. „niemand“ heißt: muss ausdrücklich vergeben werden.

Spieler

Admin

Wildcards: * und mrchunks.* enthalten in LuckPerms alles - auch mrchunks.exempt (Loader werden gelöscht!) und die unlimited-Rechte. Für solche Gruppen:

/lp group admin permission set mrchunks.exempt false

Sollen die Limits trotzdem gelten, auch mrchunks.limit.unlimited und mrchunks.active.unlimited auf false setzen.

# Alle Spieler dürfen Chunkloader nutzen
/lp group default permission set mrchunks.player true

# VIPs: 15 Loader setzen, davon 3 gleichzeitig aktiv
/lp group vip permission set mrchunks.limit.15 true
/lp group vip permission set mrchunks.active.3 true

# Moderatoren: Menü, Teleport, Sperren - aber keine fremden Loader löschen
/lp group mod permission set mrchunks.admin.gui true
/lp group mod permission set mrchunks.admin.teleport true
/lp group mod permission set mrchunks.admin.ban true

# Admins: alles
/lp group admin permission set mrchunks.admin true

# Zweit-Accounts komplett ausschließen
/lp group alt permission set mrchunks.exempt true

#Limits

Jeder Spieler hat zwei Limits - wie viele Loader er setzen darf und wie viele davon gleichzeitig aktiv sein dürfen:

Beispiel: 15 Loader setzen, davon 3 gleichzeitig nutzen → /mrchunks limit Steve place 15 und /mrchunks limit Steve active 3.

• Ist beim Setzen kein Aktiv-Platz mehr frei, wird der Loader gesetzt, bleibt aber aus. Zum Einschalten muss zuerst ein anderer aus.
• Senkt ein Admin das Aktiv-Limit, werden überzählige Loader sofort ausgeschaltet (die zuletzt gesetzten zuerst) und der Owner informiert.
• Reihenfolge: Ein Admin-Limit hat Vorrang, danach zählt die höchste Permission-Zahl, mindestens aber der Standard aus der Config.
• Dummies haben ein drittes Limit nach demselben Muster (dummies.default-limit, mrchunks.dummies.<n>, /mrchunks limit <spieler> dummy <n>).

#Lag-Schutz

MRchunks misst alle 30 Sekunden, was im Bereich jedes aktiven Loaders passiert:

• Über „Warnung“: Der Loader taucht in /mrchunks lag auf (und in MRadmin), dazu ein Discord-Log. Sonst passiert nichts.
• Über „Sperre“: Gesperrt wird erst, wenn der Wert mehrere Messungen hintereinander darüber liegt (Standard 3, also 1,5 Minuten) und der Server dabei laggt. Eine große Farm, mit der der Server gut zurechtkommt, wird nicht gesperrt. Beim Doppelten der Sperrgrenze wird auch ohne Server-Lag gesperrt.
• Gesperrt heißt: Der Loader ist aus und kann nur von Admins entsperrt werden (Menü oder /mrchunks unlock). Der Owner wird informiert, mit MRadmin bekommt er automatisch ein Ticket mit allen Details.
• Das Menü jedes aktiven Loaders zeigt die letzte Messung - so können Spieler ihre Farm selbst einschätzen.
• Alle Grenzen stehen unter lag-protection.limits. 0 schaltet eine Messung ab.

Die Standardwerte sind bewusst großzügig: Normale Farmen bleiben weit darunter, außer Kontrolle geratene Maschinen nicht.

#Server-Pause

Laggt der ganze Server - egal warum -, pausiert MRchunks alle Loader:

• Pause, wenn die TPS 30 Sekunden lang unter 15 liegt. Kurze Lag-Spitzen lösen nichts aus. Direkt davor werden alle Loader noch einmal gemessen, und klare Verursacher werden gesperrt.
• Weiter, wenn die TPS 60 Sekunden lang wieder bei mindestens 18 liegt. Niemand muss etwas neu einschalten.
• Owner und Admins werden informiert, im Menü steht „⏸ Pausiert“. Einstellbar unter server-pause.

#Konfiguration

Alles steht in plugins/MRchunks/config.yml. Jede Option ist in der Datei kommentiert. Änderungen übernimmst du mit /mrchunks reload.

Überschneidende Loader (loaders.overlap): allow erlaubt einfach, warn (Standard) erlaubt mit Hinweis und zeigt die Grenze, deny-own verbietet Überschneidungen mit eigenen Loadern, deny-all mit allen. Jeder Chunk wird ohnehin nur einmal geladen gehalten.

#Sprache & Texte

• Sprache in der config.yml: language: de oder language: en.
• Alle Texte - Chat, Menüs, Item, Webkarte, Discord - stehen in plugins/MRchunks/lang/<sprache>.yml. Ein leerer Text ("") schaltet die Nachricht ab.
• Eigene Sprache: lang/en.yml kopieren (z.B. als lang/fr.yml), übersetzen und language: fr setzen. Neue Texte aus Updates werden automatisch ergänzt.

#Discord

Webhook anlegen (Kanal bearbeiten → Integrationen → Webhooks), discord.enabled: true setzen, die webhook-url eintragen, /mrchunks reload und mit /mrchunks discord test prüfen. Welche Ereignisse gesendet werden (Loader gesetzt, gelöscht, gesperrt, Einladungen, Admin-Aktionen …), stellst du unter discord.events ein.

#Webkarte (squaremap)

MRchunks zeigt alle Chunkloader auf squaremap, einer Webkarte mit echtem Minecraft-Gelände. Ohne squaremap gibt es keine Webkarte - alles andere funktioniert trotzdem.

1. squaremap in plugins/ legen und den Server neu starten. MRchunks erkennt es und richtet es einmalig passend ein (schnelle Aktualisierung, keine Spieler auf der Karte, Weltauswahl Overworld/Nether/End). Danach kannst du squaremap frei anpassen.
2. Einmal alles rendern, damit bestehende Gebiete erscheinen:

   /squaremap fullrender minecraft:overworld
   /squaremap fullrender minecraft:the_nether
   /squaremap fullrender minecraft:the_end
   

3. Adresse festlegen (squaremap.address), damit Spieler über den Knopf Webkarte einen funktionierenden Link bekommen. Leer lassen = MRchunks ermittelt sie selbst (http://<server-ip>:8080/). Port 8080 muss dann beim Hoster freigegeben sein.

Auf der Karte gibt es zwei Ebenen, die jeder Besucher oben links ein- und ausschaltet: Chunkloader (Bereiche in einer Farbe pro Owner, ausgeschaltete grau, Infos beim Anklicken) und Chunkraster (Chunk-Linien, Regionsgrenzen, Koordinaten).

server {
    server_name map.deinserver.de;
    # listen 443 ssl; + Zertifikat (z.B. per certbot)
    location / {
        proxy_pass http://127.0.0.1:8080/;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

#Zusammenarbeit mit anderen Plugins

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

#Häufige Fragen

Ein Spieler kann keine Chunkloader holen. Er braucht mrchunks.use - am einfachsten mrchunks.player für die Default-Gruppe (siehe Schnellstart).

Die Loader eines Admins verschwinden beim Betreten. Die Gruppe hat über * auch mrchunks.exempt. Setz mrchunks.exempt für die Gruppe auf false.

Ein Loader-Block ist trotzdem verschwunden (z.B. durch /fill oder WorldEdit). Solche Befehle umgehen den Schutz. MRchunks prüft deshalb regelmäßig und beim Laden des Chunks und stellt den Block wieder her (loaders.restore-missing-blocks).

Was passiert, wenn ein Chunkloader-Item verloren geht? Nichts Schlimmes - gezählt werden nur gesetzte Loader. Ein neues Item holst du dir im Menü unter Chunkloader holen. Normale Smaragdblöcke sind übrigens keine Chunkloader, nur Items aus dem Menü.

Funktioniert das im Nether und im End? Ja. Hast du in Paper disable-world-ticking-when-empty aktiviert, stell loaders.load-method: forceload ein.

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

#Lizenz

MRchunks 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/MRchunks-mc<minecraft>-v<version>.jar. Aufbau des Codes: docs/DOKUMENTATION.md, Branches und Releases: docs/RELEASES.md.

Quelle: mrchunks/README.md ↗