Iris - Motore Dimensionale

GITHUB • DOCUMENTAZIONE • DISCORD

Panoramica - Cosa fa Iris

Iris sostituisce il generatore di chunk. Terreno, biomi, grotte, strutture, oggetti, entità e bottini provengono tutti da un pacchetto di progetto: una cartella di JSON leggibile che puoi modificare, versionare e condividere come qualsiasi altra sorgente.

• Terreno e regioni Componi biomi di terra, mare, costa e grotta attraverso definizioni di regione, ognuna con la propria forma, altezza e comportamento superficiale.

• Impostazioni bioma Palette, colori, decoratori, spawn, meteo e i collegamenti del generatore che impostano la banda di altezza che un bioma occupa.

• Scavare grotte Forme di grotte, profili e scavo dimensionale, con biomi di grotta che portano le proprie palette e decoratori.

• Oggetti Posiziona file di oggetti con rotazione, scala, marcatori, bottini e regole di trova-sostituisci, attraverso 20 modalità di posizionamento.

• Strutture Costruisci e modifica strutture a puzzle in gioco, o importa strutture vanilla e datapack nel tuo pacchetto come risorse modificabili.

• Rumore ed espressioni Guida un generatore con uno stile di rumore, una mappa immagine o un'espressione aritmetica, e scegli come i suoi valori vengono interpolati.

• Decoratori e depositi Dettagli di superficie, soffitto, costa e fluido, e depositi minerari rimappati ad altri blocchi all'interno di una banda di altezza.

• Oggetti procedurali Alberi, rovine, formazioni, corallo, funghi e cristalli generati da JSON del pacchetto, ciascuno come un pool di varianti deterministiche.

• Entità e bottini Spawn di entità, equipaggiamento, attributi, passeggeri e le tabelle di bottino che sostituiscono le loro cadute vanilla.

• Pregenerazione Genera il tuo mondo con cache su disco per riprendere in seguito con aggiornamenti di progresso in tempo reale.

Installazione

Iris non installa alcun pacchetto al primo avvio Scegli quale pacchetto desideri installare.

1. Installa Inserisci il jar in plugins/ e avvia il server. (Niente viene scaricato e nessun mondo viene creato per te)

2. Aggiungi un pacchetto Esegui uno dei comandi qui sotto.

3. Riavvia una volta. Assicurati di riavviare il server dopo aver installato i pacchetti in modo che possa installare i pacchetti di dati.

/iris download pack=overworld          Installa il pacchetto overworld integrato
/iris download pack=underworld          Installa il pacchetto underworld integrato
/iris download link=<zip-url>          Installa da un URL di archivio diretto

Fornisci pacchetto o link. link deve puntare direttamente a un URL di archivio.

Preferisci farlo offline? Decomprimi un pacchetto direttamente in plugins/Iris/packs/<name>/ a mano. Tutto il resto è uguale.

Una volta che un pacchetto è installato e il server è stato riavviato:

/iris create <name> type=<pack> seed=<long>    Crea un mondo da un pacchetto
/iris replace <world> type=<pack>              Prepara un mondo esistente per Iris
/iris tp <world>                                  Teletrasportati in esso

Comandi e permessi

Il comando principale è /iris. Alias: /ir, /irs.

Mondi

/iris create <name> type=<pack> seed=<long>    Crea un mondo da un pacchetto
/iris replace <world> type=<pack>               Prepara un mondo esistente per Iris
/iris tp <world>                                   Teletrasportati in un mondo
/iris what region                                   Riporta la regione in cui ti trovi

Pregenerazione

/iris pregen start <radius> center=<x,z>        Avvia un lavoro di pregenerazione
/iris pregen pause                               Metti in pausa o riprendi
/iris pregen stop                                Ferma il lavoro in corso
/iris pregen status                              Progresso, tasso e tempo rimanente

Studio

/iris studio create name=<name> template=<pack> Avvia un nuovo pacchetto
/iris studio open <dimension> seed=<long>       Apri un pacchetto in un mondo Studio
/iris studio vscode dimension=<pack>             Scrivi lo spazio di lavoro dell'editor
/iris studio close                               Chiudi e scarta il mondo Studio

Pacchetti e diagnostica

/iris download pack=overworld                     Installa un pacchetto integrato
/iris pack validate                                 Valida un pacchetto installato
/iris find biome <biome>                          Trova e viaggia verso un bioma
/iris dev goldenhash radius=8                     Controlla la determinismo della generazione

Permessi

iris.all          L'intero albero dei comandi      default: op
iris.treefeller    L'albero feller opzionale      default: op

Argomenti opzionali devono essere chiave Sul plugin, qualsiasi argomento che porta un valore predefinito può essere fornito solo come chiave=valore; gli argomenti richiesti si riempiono in ordine posizionale come mostrato.

/iris create MyWorld                       Funziona
/iris create MyWorld type=overworld        Funziona
/iris create MyWorld overworld             Fallisce
/iris studio open overworld seed=1337      Funziona
/iris studio open overworld 1337            Fallisce

Lo Studio - Creazione di un Pacchetto

Lo studio è un ambiente di sviluppo completamente attrezzato per creare mondi. Gli studi di puzzle e oggetti sono un modo semplice per creare oggetti e puzzle.

• Mondi usa e getta Ogni mondo Studio è nominato iris-<uuid> e aperto in creativo con tempo e meteo congelati. Chiuderlo elimina il mondo e salva automaticamente il tuo lavoro.

• Pacchetti Hotloaded Salvare un file di pacchetto caricherà automaticamente le modifiche nella generazione dei tuoi mondi.

• Lo Studio di Puzzle Un editor di strutture in gioco: celle di lavoro, piscine, pezzi e connettori, un menu a pagine, contorni di particelle e altro.

• Datapack Vanilla Converti una struttura di puzzle vanilla registrata nei tuoi pezzi modificabili, ricostruiscila, quindi esporta il risultato come un datapack vanilla.

• Schemi consapevoli del registro Aprire VSCode scrive uno schema JSON per ogni tipo di risorsa JSON, riempito dai registri del server live, in modo che i blocchi e i biomi mod completi insieme a quelli vanilla.

• La catena di strumenti per oggetti Una bacchetta che porta la sua selezione nell'oggetto stesso, incolla e annulla, riduci e plausibilizza, e un mondo Studio che dispone ogni oggetto su una griglia incorniciata.

Cartelle di pacchetti

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

Un pacchetto è una normale cartella. Copialo, versionalo o condividilo. Ci sono diciassette tipi di risorse in totale; gli otto sopra sono alcuni di quelli con cui lavorerai.

Integrazione React - Cosa monitora

Usa il nostro plugin React insieme a Iris per un monitoraggio più approfondito senza configurazione aggiuntiva, React estrarrà automaticamente i dati da Iris.

React estrae dati da 69 metriche live da Iris

• Ciclo di vita del motore Motori attivi, chiusura, falliti e in Studio, registrazioni in attesa, hotload

• Attività di generazione Chunk di questa sessione e vita, chunk al secondo, aggiornamenti di blocchi al secondo, parallelismo del motore, contratti di generazione attivi

• Tempi per fase Totale, terreno, bioma, grotta, decorazione, deposito, post, perfezione, aggiornamenti, risoluzione di scavo, applicazione di scavo e precompilazione del contesto

• Salute del mantello Piatti tettonici residenti e in coda, minimo inattivo, medio e massimo, utilizzo della memoria, urgenza di recupero

• Cache Conteggio, voci, capacità e utilizzo su quattro livelli: risorsa, stream 2D, stream 3D e altro

• Pregenerazione Attivo, in pausa, progresso, generato, totale, coda, throughput, ETA, trascorso e fallito, più permesso e tempi di attesa adattivi

• Caricamento del mondo Chunk caricati, entità caricate e saturazione delle entità

PlaceholderAPI

Iris ha una varietà di segnaposto a cui puoi collegarti quando PlaceholderAPI è presente.

%iris_available%                     È il servizio Terreno attivo
%iris_world.available%                 Se il giocatore è in un mondo Iris
%iris_world.biome%                     Nome visualizzato del bioma superficiale
%iris_world.biome-key%                 Chiave di caricamento del bioma superficiale
%iris_world.region%                    Nome visualizzato della regione
%iris_world.region-key%                Chiave di caricamento della regione
%iris_world.dimension%                 Chiave di caricamento del pacchetto del mondo del giocatore
%iris_pregen.available%                Vero mentre un lavoro di pregenerazione è in esecuzione
%iris_pregen.world%                    Mondo in fase di pregenerazione
%iris_pregen.percent%                  Percentuale di un lavoro di pregenerazione
%iris_pregen.eta%                      Tempo rimanente in secondi di una pregenerazione
%iris_pregen.eta-text%                 Stima dello stesso tipo di 2m 5s o 1h 30m
%iris_pregen.chunks%                   Chunk generati finora
%iris_pregen.total%                     Chunk rimanenti nel lavoro
%iris_pregen.chunks-per-second%        Quanto velocemente i chunk vengono generati al secondo
%iris_pregen.paused%                   Se la pregenerazione è in pausa

Compatibilità - runtime e Java

Iris supporta Paper, Purpur, Leaf, Folia, Canvas e Spigot su Java 25 per Minecraft 26.x+

• PlaceholderAPI è una dipendenza opzionale

• React estrae dati da 69 metriche live da Iris: peer mesh, portali remoti, peggior round-trip peer, byte in entrata e in uscita, rapporto di compressione, backlog di sideband, abbonamenti alla vista, blocchi replicati, resync e conteggi di trasferimento