MRchunks

Paper plugin · Chunk loader with invites, squaremap integration and fair limits.

This page is currently only available in German.

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.

Auf einen Blick
Server Paper 26.3 (oder ein Fork wie Purpur), Java 25
Benötigt nichts - LuckPerms ist empfohlen, squaremap für die Webkarte, MRadmin optional
Sprachen Deutsch, Englisch (eigene Übersetzungen möglich)
Status Vorabversion (0.x) - Config, Befehle und Permissions können sich bis 1.0.0 noch ändern

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:

Knopf Wofür Permission
Mitglieder für alle Loader Spieler für alle deine Loader einladen mrchunks.invite
Mit mir geteilt Loader anderer Spieler, zu denen du eingeladen bist –
Webkarte Link zur Webkarte im Chat (nur mit squaremap) mrchunks.map
Verknüpfte Accounts Zweit-Account verknüpfen oder lösen mrchunks.link
Chunkloader holen / zurückgeben Loader-Items holen oder zurückgeben mrchunks.use

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

Was der Block im Menü bedeutet

Block Status
Smaragdblock Alles OK
Grauer Beton Ausgeschaltet
Magmablock Über einer Warnschwelle des Lag-Schutzes
Redstone-Block Wegen Lag gesperrt
Spinnennetz Pausiert, weil der ganze Server laggt

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:

Befehl Was er tut Permission
/mrchunks gui Admin-Menü: alle Spieler und ihre Loader mrchunks.admin.gui
/mrchunks tp <spieler> <nr> Zu einem Chunkloader teleportieren mrchunks.admin.teleport
/mrchunks toggle <spieler> <nr> Chunkloader an/aus mrchunks.admin.manage
/mrchunks delete <spieler> <nr> Chunkloader löschen mrchunks.admin.manage
/mrchunks unlock <spieler> <nr> Lag-Sperre aufheben mrchunks.admin.manage
/mrchunks lag Auffällige und gesperrte Loader anzeigen mrchunks.admin.manage
/mrchunks dummy <spieler> <nr> Dummy eines Loaders an/aus (auch über das Limit hinaus) mrchunks.admin.manage
/mrchunks link <haupt> <zweit> Accounts ohne Zustimmung verknüpfen mrchunks.admin.manage
/mrchunks unlink <spieler> Verknüpfung lösen mrchunks.admin.manage
/mrchunks limit <spieler> <place|active|dummy> <anzahl|reset> Limit eines Spielers setzen (siehe Limits) mrchunks.admin.limit
/mrchunks ban <spieler> [dauer|permanent] [grund] Sperren: löscht alle Loader und verhindert neue mrchunks.admin.ban
/mrchunks unban <spieler> · bans Sperre aufheben · alle Sperren anzeigen mrchunks.admin.ban
/mrchunks map [setup] Status der Webkarte · squaremap neu einrichten mrchunks.admin.map
/mrchunks discord [test] Discord-Status · Testnachricht mrchunks.admin.discord
/mrchunks reload Config und Sprachdatei neu laden mrchunks.admin.reload
/mrchunks version Version und Update-Status alle

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

Permission Standard Wofür
mrchunks.player OP Alle Spieler-Rechte auf einmal (use, map, view, invite, link) - am besten der Default-Gruppe geben
mrchunks.use OP Chunkloader holen, setzen und die eigenen verwalten
mrchunks.map OP Knopf Webkarte
mrchunks.view OP Menü fremder Loader ansehen (nur ansehen und Grenze anzeigen)
mrchunks.invite OP Mitspieler zu eigenen Loadern einladen
mrchunks.link OP Zweit-Account verknüpfen
mrchunks.limit.<anzahl> – So viele Loader setzen, z.B. mrchunks.limit.15
mrchunks.active.<anzahl> – So viele gleichzeitig aktiv, z.B. mrchunks.active.3
mrchunks.dummies.<anzahl> – So viele Dummy-Spieler, z.B. mrchunks.dummies.2
mrchunks.limit.unlimited · active.unlimited · dummies.unlimited niemand Ohne Begrenzung
mrchunks.exempt niemand Komplett ausgeschlossen: keine Loader, keine Einladungen - vorhandene Loader werden beim Betreten gelöscht

Admin

Permission Standard Wofür
mrchunks.admin OP Alle folgenden Admin-Rechte
mrchunks.admin.gui OP Admin-Menü öffnen (Aktionen darin brauchen ihre eigene Permission)
mrchunks.admin.manage OP Fremde Loader schalten, umbenennen, löschen, entsperren, Dummies, Verknüpfungen
mrchunks.admin.teleport OP Zu Loadern teleportieren
mrchunks.admin.limit OP Limits vergeben
mrchunks.admin.ban OP Spieler sperren und entsperren
mrchunks.admin.map OP /mrchunks map
mrchunks.admin.discord OP /mrchunks discord
mrchunks.admin.reload OP /mrchunks reload
mrchunks.admin.update OP Update-Hinweis beim Betreten des Servers

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.

LuckPerms-Beispiele
# 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:

Setzen Gleichzeitig aktiv
Standard (Config) loaders.default-limit (3) loaders.default-active-limit (3)
Per Permission mrchunks.limit.<n> mrchunks.active.<n>
Unbegrenzt mrchunks.limit.unlimited mrchunks.active.unlimited
Per Admin /mrchunks limit <spieler> place <n|reset> /mrchunks limit <spieler> active <n|reset>

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:

Messwert Was gezählt wird Warnung Sperre
entities Mobs, Tiere, Loren, Items … 300 800
items Items am Boden 200 1000
redstone Redstone-Änderungen pro Sekunde 500 2000
hoppers Trichter-Transfers pro Sekunde 300 1200
pistons Kolben-Bewegungen pro Sekunde 40 150
spawns neue Mobs und Items pro Sekunde 20 80
  • Ü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.

Abschnitt Die wichtigsten Einstellungen
loaders radius (3 = 7×7 Chunks), default-limit, default-active-limit, overlap, load-method
invites an/aus, Dauer-Auswahl, höchstens so viele Mitglieder
linked-accounts an/aus, wie viele Zweit-Accounts
dummies an/aus (Standard aus), Limit, Skin, sitzend
lag-protection · server-pause Mess- und Sperrgrenzen, TPS-Schwellen
item · border Aussehen des Loaders und der Grenze
squaremap Adresse der Webkarte, Farben, Raster
discord · update-checker · gui Logs, Update-Hinweise, Menüs

Ü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).

Eigene Domain, Reverse Proxy (nginx, Caddy, Cloudflare Tunnel)
address reverse-proxy Link
"" (Standard) – automatisch → http://1.2.3.4:8080/
map.deinserver.de false http://map.deinserver.de:8080/
map.deinserver.de true https://map.deinserver.de/
https://deinserver.de/karte/ egal genau so, z.B. für einen Proxy mit Pfad

Der Proxy leitet auf squaremaps Port weiter. Läuft er auf demselben Rechner, lass squaremap nur lokal lauschen (internal-webserver.bind: 127.0.0.1 in plugins/squaremap/config.yml). Beispiel nginx:

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;
    }
}

Unter einem Pfad: location /karte/ { proxy_pass http://127.0.0.1:8080/; } und in MRchunks address: "https://deinserver.de/karte/". Die öffentliche IP wird nur ermittelt, wenn weder address noch server-ip gesetzt ist - abschaltbar mit squaremap.detect-public-ip: false.


Zusammenarbeit mit anderen Plugins

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

Funktion Braucht
MRchunks im Dashboard, Spieler-Menü und Serverzustand von MRadmin, Seite Chunkloader in der Weboberfläche MRadmin
Automatisches Ticket für den Owner bei einer Lag-Sperre MRadmin
In der Arena-Welt von MRpvp lassen sich keine Loader setzen MRadmin + MRpvp
Webkarte squaremap
Dummy-Spieler zählen bei MRsleep, MRadmin und MRpvp nicht als Spieler nichts

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:

✅ Erlaubt ❌ Nicht erlaubt
Nutzen - privat und gewerblich, auch auf Servern mit Spenden, Rängen oder Shops Weiterveröffentlichen (auch verändert), z.B. auf Modrinth, Spigot, in Modpacks
Verändern und neu kompilieren Verkaufen oder gegen Geld anbieten
An dein Team oder deinen Hoster weitergeben Als eigenes Werk ausgeben, Lizenzhinweis entfernen
Verbesserungen per Pull Request einreichen

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.

Source: mrchunks/README.md ↗