Iris - Motor de Dimensão

GITHUB • DOCUMENTAÇÃO • DISCORD

Visão Geral - O que o Iris faz

Iris substitui o gerador de chunks. Terreno, biomas, cavernas, estruturas, objetos, entidades e loot vêm de um pacote de projeto: uma pasta de JSON legível que você pode editar, versionar e compartilhar como qualquer outra fonte.

• Terreno e regiões Componha biomas de terra, mar, costa e caverna através de definições de região, cada uma com sua própria forma, altura e comportamento de superfície.

• Configurações de bioma Paletas, cores, decoradores, spawns, clima e os links do gerador que definem a faixa de altura que um bioma ocupa.

• Esculpindo cavernas Formas, perfis e escultura de dimensões de cavernas, com biomas de caverna que carregam suas próprias paletas e decoradores.

• Objetos Coloque arquivos de objetos com rotação, escala, marcadores, loot e regras de encontrar e substituir, em 20 modos de colocação.

• Estruturas Construa e edite estruturas de quebra-cabeça no jogo, ou importe estruturas vanilla e datapack para seu pacote como recursos editáveis.

• Ruído e expressões Acione um gerador com um estilo de ruído, um mapa de imagem ou uma expressão aritmética, e escolha como seus valores são interpolados.

• Decoradores e depósitos Detalhes de superfície, teto, costa e fluido, e depósitos de minério remapeados para outros blocos dentro de uma faixa de altura.

• Objetos procedurais Árvores, ruínas, formações, corais, fungos e cristais gerados a partir do JSON do pacote, cada um como um pool de variantes determinísticas.

• Entidades e loot Spawn de entidades, equipamentos, atributos, passageiros e as tabelas de loot que substituem suas quedas vanilla.

• Pré-geração Gere seu mundo com cache em disco para retomar mais tarde com atualizações de progresso ao vivo.

Instalação

Iris não instala nenhum pacote na primeira inicialização Escolha qual pacote você gostaria de instalar.

1. Instalar Coloque o jar em plugins/ e inicie o servidor. (Nada é baixado e nenhum mundo é criado para você)

2. Adicionar um pacote Execute um dos comandos abaixo.

3. Reinicie uma vez. Certifique-se de reiniciar o servidor após instalar os pacotes para que ele possa instalar os pacotes de dados.

/iris download pack=overworld          Instale o pacote de overworld embutido
/iris download pack=underworld          Instale o pacote de underworld embutido
/iris download link=<zip-url>          Instale a partir de uma URL de arquivo direto

Forneça pack ou link. link deve apontar diretamente para uma URL de arquivo.

Prefere fazer isso offline? Descompacte um pacote diretamente em plugins/Iris/packs/<name>/ manualmente. Tudo depois disso é o mesmo.

Uma vez que um pacote está instalado e o servidor foi reiniciado:

/iris create <name> type=<pack> seed=<long>    Crie um mundo a partir de um pacote
/iris replace <world> type=<pack>              Prepare um mundo existente para o Iris
/iris tp <world>                                  Teleporte para ele

Comandos e permissões

O comando raiz é /iris. Aliases: /ir, /irs.

Mundos

/iris create <name> type=<pack> seed=<long>    Crie um mundo a partir de um pacote
/iris replace <world> type=<pack>                Prepare um mundo existente para o Iris
/iris tp <world>                                    Teleporte para um mundo
/iris what region                                    Relate a região em que você está

Pré-geração

/iris pregen start <radius> center=<x,z>        Inicie um trabalho de pré-geração
/iris pregen pause                                  Pause ou retome
/iris pregen stop                                   Pare o trabalho em execução
/iris pregen status                                 Progresso, taxa e tempo restante

Estúdio

/iris studio create name=<name> template=<pack> Inicie um novo pacote
/iris studio open <dimension> seed=<long>      Abra um pacote em um mundo do Estúdio
/iris studio vscode dimension=<pack>             Escreva o espaço de trabalho do editor
/iris studio close                                Feche e descarte o mundo do Estúdio

Pacotes e diagnósticos

/iris download pack=overworld                      Instale um pacote embutido
/iris pack validate                                  Valide um pacote instalado
/iris find biome <biome>                            Localize e viaje para um bioma
/iris dev goldenhash radius=8                       Verifique a determinismo da geração

Permissões

iris.all          A árvore de comandos inteira      padrão: op
iris.treefeller    O opcional cortador de árvores    padrão: op

Argumentos opcionais devem ser chaveados No plugin, qualquer argumento que tenha um padrão só pode ser fornecido como key=value; argumentos obrigatórios preenchem posicionalmente na ordem mostrada.

/iris create MyWorld                          Funciona
/iris create MyWorld type=overworld           Funciona
/iris create MyWorld overworld                 Falha
/iris studio open overworld seed=1337         Funciona
/iris studio open overworld 1337               Falha

O Estúdio - Autoria de um Pacote

O estúdio é um ambiente de desenvolvimento totalmente equipado para criar mundos. Estúdios de Quebra-Cabeça e Objetos são uma maneira fácil de criar objetos e quebra-cabeças.

• Mundos descartáveis Cada mundo do Estúdio é nomeado iris-<uuid> e aberto em criativo com clima e tempo congelados. Fechar exclui o mundo e salva automaticamente seu trabalho.

• Pacotes Hotloaded Salvar um arquivo de pacote carregará as alterações automaticamente na geração dos seus mundos.

• O Estúdio de Quebra-Cabeça Um editor de estruturas no jogo: células de trabalho, pools, peças e conectores, um menu paginado, contornos de partículas e mais.

• Datapacks Vanilla Converta uma estrutura de quebra-cabeça vanilla registrada em suas próprias peças editáveis, reconstrua-a e, em seguida, exporte o resultado de volta como um datapack vanilla.

• Esquemas cientes de registro Abrir o VSCode escreve um esquema JSON para cada tipo de recurso JSON, preenchido a partir dos registros do servidor ao vivo, para que blocos e biomas de mods sejam completados junto com os vanilla.

• A cadeia de ferramentas de objetos Uma varinha que carrega sua seleção no próprio item, cola e desfaz, encolhe e plausibiliza, e um mundo do Estúdio que organiza cada objeto em uma grade emoldurada.

Pastas de pacotes

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

Um pacote é uma pasta normal. Copie, versione ou compartilhe. Existem dezessete tipos de recursos no total; os oito acima são alguns dos que você trabalhará.

Integração com React - O que ele Monitora

Use nosso plugin React junto com o Iris para monitoramento mais aprofundado sem configuração adicional, o React puxará automaticamente os dados do Iris.

O React puxa dados de 69 métricas ao vivo do Iris

• Ciclo de vida do motor Motores ativos, fechando, falhados e no Estúdio, registros pendentes, hotloads

• Atividade de geração Chunks nesta sessão e vida, chunks por segundo, atualizações de bloco por segundo, paralelismo do motor, locações de geração ativas

• Tempos por estágio Total, terreno, bioma, caverna, decoração, depósito, pós, perfeição, atualizações, resolução de escultura, aplicação de escultura e preenchimento de contexto

• Saúde do manto Placas tectônicas residentes e enfileiradas, mínimo ocioso, médio e máximo, uso de heap, urgência de recuperação

• Caches Contagem, entradas, capacidade e uso em quatro níveis: recurso, fluxo 2D, fluxo 3D e outros

• Pré-geração Ativo, pausado, progresso, gerado, total, fila, taxa de transferência, ETA, decorrido e falhado, além de tempos de espera de permissão e adaptativos

• Carregamento do mundo Chunks carregados, entidades carregadas e saturação de entidades

PlaceholderAPI

O Iris tem uma variedade de Placeholders que você pode conectar quando o PlaceholderAPI estiver presente.

%iris_available%                       O serviço de Terreno está ativo
%iris_world.available%                  Se o jogador está em um mundo Iris
%iris_world.biome%                      Nome de exibição do bioma de superfície
%iris_world.biome-key%                  Chave de carregamento do bioma de superfície
%iris_world.region%                     Nome de exibição da região
%iris_world.region-key%                 Chave de carregamento da região
%iris_world.dimension%                  Chave de carregamento do pacote do mundo do jogador
%iris_pregen.available%                 Verdadeiro enquanto um trabalho de pré-geração estiver em execução
%iris_pregen.world%                     Mundo sendo pré-gerado
%iris_pregen.percent%                   Porcentagem de um trabalho de pré-geração
%iris_pregen.eta%                       Tempo restante em segundos de uma pré-geração
%iris_pregen.eta-text%                  Mesma estimativa que 2m 5s ou 1h 30m
%iris_pregen.chunks%                    Chunks gerados até agora
%iris_pregen.total%                     Chunks restantes no trabalho
%iris_pregen.chunks-per-second%        Quão rápido os chunks estão sendo gerados por segundo
%iris_pregen.paused%                   Se a pré-geração está pausada

Compatibilidade - tempos de execução e Java

O Iris suporta Paper, Purpur, Leaf, Folia, Canvas e Spigot no Java 25 para Minecraft 26.x+

• PlaceholderAPI é uma dependência opcional

• O React puxa dados de 69 métricas ao vivo do Iris: pares de malha, portais remotos, pior tempo de ida e volta, bytes de fio para dentro e para fora, taxa de compressão, backlog de banda lateral, assinaturas de visualização, blocos replicados, ressincronizações e contagens de transferência