Iris - Dimensionsmotor

GITHUB  •  DOCUMENTATION  •  DISCORD

Überblick - Was Iris tut

Iris ersetzt den Chunk-Generator. Terrain, Biome, Höhlen, Strukturen, Objekte, Entitäten und Beute stammen alle aus einem Projektpaket: einem Ordner mit lesbarem JSON, den Sie bearbeiten, versionieren und wie jede andere Quelle teilen können.

• Terrain und Regionen Komponieren Sie Land-, See-, Küsten- und Höhlenbiome durch Regionsdefinitionen, jede mit ihrer eigenen Form, Höhe und Oberflächenverhalten.

• Biomeinstellungen Paletten, Farben, Dekoratoren, Spawns, Wetter und die Generatorverknüpfungen, die den Höhenbereich festlegen, den ein Biome einnimmt.

• Höhlenbearbeitung Höhlenformen, Profile und Dimensionen, mit Höhlenbiomen, die ihre eigenen Paletten und Dekoratoren tragen.

• Objekte Platzieren Sie Objektdateien mit Rotation, Maßstab, Markierungen, Beute und Regeln für Suchen und Ersetzen in 20 Platzierungsmodi.

• Strukturen Erstellen und bearbeiten Sie Jigsaw-Strukturen im Spiel oder importieren Sie Vanilla- und Datapack-Strukturen in Ihr Paket als bearbeitbare Ressourcen.

• Geräusch und Ausdrücke Steuern Sie einen Generator mit einem Geräuschstil, einer Bildkarte oder einem arithmetischen Ausdruck und wählen Sie aus, wie seine Werte interpoliert werden.

• Dekoratoren und Ablagerungen Oberflächen-, Decken-, Küsten- und Flüssigkeitsdetails sowie Erzablagerungen, die auf andere Blöcke innerhalb eines Höhenbereichs umgemappt werden.

• Prozedurale Objekte Bäume, Ruinen, Formationen, Korallen, Pilze und Kristalle, die aus Pack-JSON generiert werden, jeweils als gesäte Sammlung deterministischer Varianten.

• Entitäten und Beute Entitätsspaß, Ausrüstung, Attribute, Passagiere und die Beutetabellen, die ihre Vanilla-Drops ersetzen.

• Vorbereitung Generieren Sie Ihre Welt mit einem Cache auf der Festplatte, um später mit Live-Fortschrittsaktualisierungen fortzufahren.

Installation

Iris installiert beim ersten Start kein Paket Wählen Sie aus, welches Paket Sie installieren möchten.

1. Installieren Legen Sie die JAR-Datei in plugins/ und starten Sie den Server. (Nichts wird heruntergeladen und keine Welt wird für Sie erstellt)

2. Fügen Sie ein Paket hinzu Führen Sie einen der folgenden Befehle aus.

3. Einmal neu starten. Stellen Sie sicher, dass Sie den Server nach der Installation der Pakete neu starten, damit die Datenpakete installiert werden können.

\/iris download pack=overworld           Installieren Sie das integrierte Overworld-Paket
\/iris download pack=underworld          Installieren Sie das integrierte Underworld-Paket
\/iris download link=<zip-url>           Installieren Sie von einer direkten Archiv-URL

Geben Sie pack oder link. link muss direkt auf eine Archiv-URL zeigen.

Bevorzugen Sie es, offline zu arbeiten? Entpacken Sie ein Paket direkt in plugins/Iris/packs/<name>/ von Hand. Alles danach bleibt gleich.

Sobald ein Paket installiert ist und der Server neu gestartet wurde:

\/iris create <name> type=<pack> seed=<long>    Erstellen Sie eine Welt aus einem Paket
\/iris replace <world> type=<pack>              Bereiten Sie eine vorhandene Welt für Iris vor
\/iris tp <world>                               Teleportieren Sie sich hinein

Befehle und Berechtigungen

Der Hauptbefehl ist \/iris. Aliase: \/ir, \/irs.

Welten

\/iris create <name> type=<pack> seed=<long>     Erstellen Sie eine Welt aus einem Paket
\/iris replace <world> type=<pack>               Bereiten Sie eine vorhandene Welt für Iris vor
\/iris tp <world>                                Teleportieren Sie zu einer Welt
\/iris what region                               Berichten Sie über die Region, in der Sie sich befinden

Vorbereitung

\/iris pregen start <radius> center=<x,z>        Starten Sie einen Vorbereitungsjob
\/iris pregen pause                              Pausieren oder fortsetzen
\/iris pregen stop                               Stoppen Sie den laufenden Job
\/iris pregen status                             Fortschritt, Rate und verbleibende Zeit

Studio

\/iris studio create name=<name> template=<pack> Starten Sie ein neues Paket
\/iris studio open <dimension> seed=<long>       Öffnen Sie ein Paket in einer Studio-Welt
\/iris studio vscode dimension=<pack>            Schreiben Sie den Editor-Arbeitsbereich
\/iris studio close                              Schließen und verwerfen Sie die Studio-Welt

Pakete und Diagnosen

\/iris download pack=overworld                   Installieren Sie ein integriertes Paket
\/iris pack validate                             Validieren Sie ein installiertes Paket
\/iris find biome <biome>                        Lokalisieren und reisen Sie zu einem Biome
\/iris dev goldenhash radius=8                   Überprüfen Sie die Determinismus der Generierung

Berechtigungen

iris.all           Der gesamte Befehlsbaum      standardmäßig: op
iris.treefeller    Der optionale Baumfäller     standardmäßig: op

Optionale Argumente müssen zugeordnet sein Im Plugin kann jedes Argument, das einen Standardwert hat, nur als key=value; erforderliche Argumente füllen sich positionsabhängig in der angegebenen Reihenfolge.

\/iris create MyWorld                     Funktioniert
\/iris create MyWorld type=overworld      Funktioniert
\/iris create MyWorld overworld           Fehler
\/iris studio open overworld seed=1337    Funktioniert
\/iris studio open overworld 1337         Fehler

Das Studio - Ein Paket erstellen

Das Studio ist eine voll ausgestattete Entwicklungsumgebung zum Erstellen von Welten. Jigsaw- und Objektstudios sind eine einfache Möglichkeit, Objekte und Jigsaws zu erstellen.

• Einwegwelten Jede Studio-Welt wird iris-<uuid> genannt und im kreativen Modus mit eingefrorenem Wetter und Zeit geöffnet. Das Schließen löscht die Welt und speichert Ihre Arbeit automatisch.

• Pakete Hotloaded Das Speichern einer Paketdatei lädt die Änderungen automatisch in die Generierung Ihrer Welten.

• Das Jigsaw-Studio Ein Struktur-Editor im Spiel: Arbeitszellen, Pools, Teile und Verbindungen, ein seitenmenü, Partikelumrisse und mehr.

• Vanilla-Datapacks Konvertieren Sie eine registrierte Vanilla-Jigsaw-Struktur in Ihre eigenen bearbeitbaren Teile, bauen Sie sie neu und exportieren Sie das Ergebnis dann als Vanilla-Datapack zurück.

• Registry-bewusste Schemata Das Öffnen von VSCode schreibt ein JSON-Schema für jeden JSON-Ressourcentyp, gefüllt aus den Live-Server-Registrierungen, sodass Mod-Blöcke und Biome neben den Vanilla-Blöcken vervollständigt werden.

• Die Objekt-Toolchain Ein Zauberstab, der seine Auswahl im Element selbst trägt, Einfügen und Rückgängig machen, Verkleinern und Plausibilisieren sowie eine Studio-Welt, die jedes Objekt auf einem gerahmten Raster anordnet.

Paketordner

plugins/Iris/packs/<name>/
    dimensions/   regions/    biomes/     generators/
    objects/      loot/       entities/   images/

Ein Paket ist ein normaler Ordner. Kopieren Sie es, versionieren Sie es oder teilen Sie es. Es gibt insgesamt siebzehn Ressourcentypen; die acht oben sind einige der, mit denen Sie arbeiten werden.

React-Integration - Was es überwacht

Verwenden Sie unser Plugin React zusammen mit Iris für eine detailliertere Überwachung ohne zusätzliche Konfiguration, React wird automatisch die Daten von Iris abrufen.

React ruft Daten von 69 Live-Metriken von Iris ab

• Engine-Lebenszyklus Aktive, schließende, fehlgeschlagene und in Studio befindliche Motoren, ausstehende Registrierungen, Hotloads

• Generierungsaktivität Chunks in dieser Sitzung und Lebensdauer, Chunks pro Sekunde, Blockaktualisierungen pro Sekunde, Motorparallelität, aktive Generierungsleasing

• Pro-Stadium-Zeiten Gesamt, Terrain, Biome, Höhle, Dekoration, Ablagerung, Nachbearbeitung, Perfektion, Aktualisierungen, Bearbeitungsauflösung, Bearbeitungsanwendung und Kontextvorbefüllung

• Mantelgesundheit Resident und wartende tektonische Platten, Leerlaufminimum, Durchschnitt und Maximum, Heap-Nutzung, Rückgewinnungsdringlichkeit

• Caches Anzahl, Einträge, Kapazität und Nutzung über vier Ebenen: Ressource, 2D-Stream, 3D-Stream und andere

• Vorbereitung Aktiv, pausiert, Fortschritt, generiert, insgesamt, Warteschlange, Durchsatz, ETA, vergangene Zeit und fehlgeschlagen, plus Genehmigung und adaptive Wartezeiten

• Weltladung Geladene Chunks, geladene Entitäten und Entitätssättigung

PlaceholderAPI

Iris hat eine Vielzahl von Platzhaltern, in die Sie sich einhaken können, wenn PlaceholderAPI vorhanden ist.

%iris_available%                    Ist der Terrain-Service aktiv
%iris_world.available%              Wenn der Spieler sich in einer Iris-Welt befindet
%iris_world.biome%                  Oberflächenbiom-Anzeigename
%iris_world.biome-key%              Oberflächenbiom-Ladeschlüssel
%iris_world.region%                 Regionsanzeigename
%iris_world.region-key%             Regionsladeschlüssel
%iris_world.dimension%              Pack-Ladeschlüssel der Welt des Spielers
%iris_pregen.available%             Wahr, während ein Vorbereitungsjob läuft
%iris_pregen.world%                 Welt, die vorbereitet wird
%iris_pregen.percent%               Prozentsatz eines Vorbereitungsjobs
%iris_pregen.eta%                   Verbleibende Zeit in Sekunden eines Vorbereitungsjobs
%iris_pregen.eta-text%              Gleiche Schätzung wie 2m 5s oder 1h 30m
%iris_pregen.chunks%                Bisher generierte Chunks
%iris_pregen.total%                 Verbleibende Chunks im Job
%iris_pregen.chunks-per-second%     Wie schnell Chunks pro Sekunde generiert werden
%iris_pregen.paused%                Wenn die Vorbereitung pausiert ist

Kompatibilität - Laufzeiten und Java

Iris unterstützt Paper, Purpur, Leaf, Folia, Canvas und Spigot auf Java 25 für Minecraft 26.x+

• PlaceholderAPI ist eine optionale Abhängigkeit

• React ruft Daten von 69 Live-Metriken von Iris ab: Mesh-Peers, Remote-Portale, schlechtester Peer-Round-Trip, Drahtbytes hinein und hinaus, Kompressionsverhältnis, Sideband-Rückstand, Ansicht-Abonnements, replizierte Blöcke, Resynchronisierungen und Übertragungszahlen