Iris - Moteur de Dimension

GITHUB • DOCUMENTATION • DISCORD

Aperçu - Ce que fait Iris

Iris remplace le générateur de chunks. Le terrain, les biomes, les grottes, les structures, les objets, les entités et le butin proviennent tous d'un pack de projet : un dossier de JSON lisible que vous pouvez éditer, versionner et partager comme n'importe quelle autre source.

• Terrain et régions Composez des biomes de terre, de mer, de rivage et de grotte à travers des définitions de région, chacune avec sa propre forme, hauteur et comportement de surface.

• Paramètres de biome Palettes, couleurs, décorateurs, apparitions, météo et les liens du générateur qui définissent la bande de hauteur qu'un biome occupe.

• Sculpture de grotte Formes de grotte, profils et sculpture de dimension, avec des biomes de grotte qui portent leurs propres palettes et décorateurs.

• Objets Placez des fichiers d'objets avec rotation, échelle, marqueurs, butin et règles de recherche et remplacement, à travers 20 modes de placement.

• Structures Construisez et éditez des structures de puzzle dans le jeu, ou importez des structures vanille et de datapack dans votre pack en tant que ressources éditables.

• Bruit et expressions Faites fonctionner un générateur avec un style de bruit, une carte d'image ou une expression arithmétique, et choisissez comment ses valeurs sont interpolées.

• Décorateurs et dépôts Détails de surface, de plafond, de rivage et de fluide, et dépôts de minerai remappés à d'autres blocs à l'intérieur d'une bande de hauteur.

• Objets procéduraux Arbres, ruines, formations, corail, champignons et cristaux générés à partir de JSON de pack, chacun comme un pool de variantes déterministes.

• Entités et butin Apparition d'entités, équipement, attributs, passagers, et les tables de butin qui remplacent leurs drops vanille.

• Prégénération Générez votre monde avec un cache sur disque pour reprendre plus tard avec des mises à jour de progression en direct.

Installation

Iris n'installe aucun pack au premier démarrage Choisissez quel pack vous souhaitez installer.

1. Installer Déposez le jar dans plugins/ et démarrez le serveur. (Rien n'est téléchargé et aucun monde n'est créé pour vous)

2. Ajouter un pack Exécutez l'une des commandes ci-dessous.

3. Redémarrez une fois. Assurez-vous de redémarrer le serveur après avoir installé les packs afin qu'il puisse installer les packs de données.

/iris download pack=overworld          Installer le pack overworld intégré
/iris download pack=underworld          Installer le pack underworld intégré
/iris download link=<zip-url>          Installer à partir d'une URL d'archive directe

Fournissez pack ou link. link doit pointer directement vers une URL d'archive.

Préférez-vous le faire hors ligne ? Dézippez un pack directement dans plugins/Iris/packs/<name>/ à la main. Tout le reste est identique.

Une fois qu'un pack est installé et que le serveur a été redémarré :

/iris create <name> type=<pack> seed=<long>    Créez un monde à partir d'un pack
/iris replace <world> type=<pack>              Préparez un monde existant pour Iris
/iris tp <world>                                  Téléportez-vous dedans

Commandes et permissions

La commande racine est /iris. Alias : /ir, /irs.

Mondes

/iris create <name> type=<pack> seed=<long>    Créez un monde à partir d'un pack
/iris replace <world> type=<pack>              Préparez un monde existant pour Iris
/iris tp <world>                                  Téléportez-vous dans un monde
/iris what region                                  Signalez la région dans laquelle vous vous trouvez

Prégénération

/iris pregen start <radius> center=<x,z>        Démarrez un travail de prégénération
/iris pregen pause                              Pause ou reprendre
/iris pregen stop                               Arrêtez le travail en cours
/iris pregen status                             Progression, taux et temps restant

Studio

/iris studio create name=<name> template=<pack> Démarrez un nouveau pack
/iris studio open <dimension> seed=<long>      Ouvrez un pack dans un monde Studio
/iris studio vscode dimension=<pack>            Écrivez l'espace de travail de l'éditeur
/iris studio close                              Fermez et abandonnez le monde Studio

Packs et diagnostics

/iris download pack=overworld                      Installer un pack intégré
/iris pack validate                                  Validez un pack installé
/iris find biome <biome>                           Localisez et voyagez vers un biome
/iris dev goldenhash radius=8                       Vérifiez le déterminisme de génération

Permissions

iris.all          L'ensemble de l'arbre de commandes      par défaut : op
iris.treefeller    L'optionnel abatteur d'arbres      par défaut : op

Les arguments optionnels doivent être clés Dans le plugin, tout argument qui a une valeur par défaut ne peut être fourni que sous la forme key=value; les arguments requis se remplissent par ordre de position.

/iris create MyWorld                          Fonctionne
/iris create MyWorld type=overworld           Fonctionne
/iris create MyWorld overworld                 Échoue
/iris studio open overworld seed=1337         Fonctionne
/iris studio open overworld 1337               Échoue

Le Studio - Création d'un Pack

Le studio est un environnement de développement entièrement équipé pour créer des mondes. Les studios de puzzle et d'objets sont un moyen facile de créer des objets et des puzzles.

• Mondes jetables Chaque monde Studio est nommé iris-<uuid> et ouvert en créatif avec la météo et le temps figés. Le fermer supprime le monde et enregistre automatiquement votre travail.

• Packs chargés à chaud Enregistrer un fichier de pack chargera automatiquement les modifications dans la génération de vos mondes.

• Le Studio de Puzzle Un éditeur de structure dans le jeu : cellules de travail, bassins, pièces et connecteurs, un menu paginé, contours de particules et plus.

• Datapacks vanille Convertissez une structure de puzzle vanille enregistrée en vos propres pièces éditables, reconstruisez-la, puis exportez le résultat en tant que datapack vanille.

• Schémas conscients du registre Ouvrir VSCode écrit un schéma JSON pour chaque type de ressource JSON, rempli à partir des registres du serveur en direct, de sorte que les blocs et biomes modifiés soient complétés aux côtés de ceux vanille.

• La chaîne d'outils d'objets Une baguette qui porte sa sélection dans l'élément lui-même, coller et annuler, réduire et plausibiliser, et un monde Studio qui dispose chaque objet sur une grille encadrée.

Dossiers de pack

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

Un pack est un dossier normal. Copiez-le, versionnez-le ou partagez-le. Il y a dix-sept types de ressources au total ; les huit ci-dessus sont certains de ceux avec lesquels vous travaillerez.

Intégration React - Ce qu'il surveille

Utilisez notre plugin React avec Iris pour un suivi plus approfondi sans configuration supplémentaire, React tirera automatiquement les données d'Iris.

React tire des données de 69 métriques en direct d'Iris

• Cycle de vie du moteur Moteurs actifs, fermeture, échec et en Studio, en attente d'enregistrements, chargements à chaud

• Activité de génération Chunks cette session et durée de vie, chunks par seconde, mises à jour de blocs par seconde, parallélisme du moteur, baux de génération actifs

• Temps par étape Total, terrain, biome, grotte, décoration, dépôt, post, perfection, mises à jour, résolution de sculpture, application de sculpture et pré-remplissage de contexte

• Santé du manteau Plaques tectoniques résidentes et en file d'attente, minimum, moyenne et maximum inactifs, utilisation de la mémoire, urgence de récupération

• Caches Compte, entrées, capacité et utilisation à travers quatre niveaux : ressource, flux 2D, flux 3D et autres

• Prégénération Actif, en pause, progression, généré, total, file d'attente, débit, ETA, écoulé et échoué, plus temps d'attente de permis et adaptatif

• Chargement du monde Chunks chargés, entités chargées et saturation des entités

PlaceholderAPI

Iris a une variété de Placeholders auxquels vous pouvez vous connecter lorsque PlaceholderAPI est présent.

%iris_available%                      Le service Terrain est-il en direct
%iris_world.available%                  Si le joueur est dans un monde Iris
%iris_world.biome%                      Nom d'affichage du biome de surface
%iris_world.biome-key%                  Clé de chargement du biome de surface
%iris_world.region%                     Nom d'affichage de la région
%iris_world.region-key%                 Clé de chargement de la région
%iris_world.dimension%                  Clé de chargement du pack du monde du joueur
%iris_pregen.available%                 Vrai pendant qu'un travail de prégénération s'exécute
%iris_pregen.world%                     Monde en cours de prégénération
%iris_pregen.percent%                   Pourcentage d'un travail de prégénération
%iris_pregen.eta%                       Temps restant en secondes d'une prégénération
%iris_pregen.eta-text%                  Même estimation que 2m 5s ou 1h 30m
%iris_pregen.chunks%                    Chunks générés jusqu'à présent
%iris_pregen.total%                     Chunks restants dans le travail
%iris_pregen.chunks-per-second%         À quelle vitesse les chunks sont générés par seconde
%iris_pregen.paused%                    Si la prégénération est en pause

Compatibilité - environnements d'exécution et Java

Iris prend en charge Paper, Purpur, Leaf, Folia, Canvas et Spigot sur Java 25 pour Minecraft 26.x+

• PlaceholderAPI est une dépendance optionnelle

• React tire des données de 69 métriques en direct d'Iris : pairs de maillage, portails distants, pire aller-retour de pair, octets de fil entrants et sortants, taux de compression, arriéré de bande latérale, abonnements de vue, blocs répliqués, resynchronisations et comptes de transfert