This documentation is for Iris - Dimension Engine (spigot)

Puede descargar Iris en Spigot.

Ahí podrás ver más características del plugin.

在 Spigot 获取 Iris.

关于插件功能的更多信息也能从手册中查阅到.

Preparation

• Install Iris by putting the latest jar file in the */plugins folder.

• Start the server.

• Wait. Iris will restart the server to install the pack. You may need to manually start it again.

• Make sure it all went right, by reading above the Iris logo in the console, and making sure the number of loaded Custom Biomes is at least 70. This number can vary, but less is likely a problem.

Creating new Worlds

Simple! Run /iris create

Replacing your Main World

1. Create a new world with the command above

2. Stop the server

3. Navigate to the folder of your main world (usually just the world folder)

4. Move the datapacks folder from that folder -> to the folder with the name of the world you created with /iris create

5. Next, open your server.properties file and search for level-name=world

6. Replace world with the name of your Iris world (where you just moved the datapacks folder to)

7. If you want to keep your current end or nether, you need to rename the world_nether and world_the_end folders to be newname_nether and newname_the_end (replacing newname with the name of the world you created with /iris create). Otherwise, a new nether and end will be generated.

8. Start the server

Accessing the World

There are multiple options to access and manage worlds.

Support

We offer support on our Discord. You can ask questions there if you run into an error, for example, and want to know how to fix it. Thank you for using Iris!

• The Volmit Software Team

קבלו את אייריס ב

מידע נוסף על תכונות נמצא גם שם.

Iris может создавать и генерировать для вас любое количество миров. Iris поставляется с небольшим руководством, мы стараемся сделать его более простым для понимания.

Подготовка

• Установите Iris, поместив в папку */plugins.

• Запустите сервер.

• Подождите. Iris перезапустит сервер для установки пака. Возможно, вам придется вручную (самостоятельно) запустить его снова.

• Убедитесь, прочитав над логотипом Iris в консоли, что все загрузилось правильно и что количество загруженных пользовательских биомов составляет не менее 70. Это число может варьироваться, но меньшее, скорее всего, является проблемой.

Далее, вам нужно:

Создание нового мира

• Создайте мир, написав команду: /rift create <название_мира> Iris:overworld

• Телепортируйтесь в этот мир, написав команду: /rift to <название_мира>

• Готово!

Перезапись основного мира

• Остановите сервер

• Удалите все из папки */world, кроме папки datapacks

• Откройте файл */bukkit.yml

• Добавьте в конец файла следующие строки:

• Запустите сервер

• Готово!

Помощь

Спасибо, что пользуетесь Iris!

• Команда Volmit Software

准备工作

• 安装 Iris 需要把 放到文件夹 */plugins 中。

• 启动服务器。

• 坐下放松等待。Iris 会重新启动服务器以安装包。 你可能需要再次手动启动服务器。

• 查看控制台 Iris logo 的上方，并确保加载的 自定义生物群系 的数量至少为 70 个，以确保一切加载顺利。这个数字可能会有所不同，但如果更少，你可能就需要注意了。

创建新的世界

很简单！只需要执行 /iris create

接管你的主世界

1. 停止服务器

2. 导航到你目前的主世界文件夹（通常是 world 文件夹）

3. 将 datapacks 文件夹移动到 -> 你刚刚使用 /iris create 创建的世界名称的文件夹中

4. 接下来，打开服务器目录下的 server.properties 文件，并搜索 level-name=world

5. 将 world 替换为你的 Iris 世界的名称（你刚刚把 datapacks 移动到这个地方过）

6. 启动服务器

访问世界

有多种选择来访问和管理世界。我们建议使用 Essentials 或 MyWorlds。

模板

获取支持

• Volmit Software 团队

El comando principal

El comando principal es /iris. Ejecutar este comando mostrará la página principal de comandos.

Información adicional

Puede pasar el cursor por encima de cualquier comando o parámetro para ver lo siguiente:

• Descripción

• Una advertencia si no tiene permiso para usarlo

• Ejemplos de uso

• Información sobre los parámetros

• El valor por defecto de los parámetros (si lo tiene)

• El tipo de parámetro (ya sea un texto, entero, IrisDimension o un mundo)

Clic

Puede hacer clic en cualquier comando para:

• Ejecutar el comando (si no tiene parámetros)

• Sugerir el comando (se copiará en el chat para que pueda ser modificado)

The main command

The main command to access is /iris. Running this command shows you the main page of commands.

Hovering

You can hover over any command or parameter to see:

• A description

• A warning if you do not have permission to use it

• Examples of how to use

• If a parameter is required or not

• If a parameter can be derived from context (such as the world you are in)

• The default value of the parameter (if it has one)

• The type of a parameter (such as String or Integer, or even IrisDimension or World)

Context

Iris is really good at guessing what you want / filling in the blanks. If you specify a command that is specific for a world, like /iris pregen, Iris will guess that the world you are currently in (as a player) is the world you want to use the command on. You can always manually input the value if Iris is guessing wrong, by adding it to the command.

Clicking

You can click any command to either:

• Run the command (if it has no parameters. I.e. a subsection)

• Suggest the command (put it in your chat box, so you can add further values)

הפקודה הראשית

הפקודה הראשית בשביל לקבל את כל המידע היא iris/. הרצת הפקודה הזאת תציג לכם את רשימת הדפים של הפקודות.

לרחף

אפשר לרחף מעל כל פקודה בשביל לראות:

• תיאור

• אזהרה אם אין לך הרשאה להשתמש בפקודה

• דוגמאות לשימוש

• אם יש צורך בפרמטר או לא

• אם ניתן לגזור פרמטר מהקשר (כגון העולם שבו שאתם נמצאים)

• ערך ברירת המחדל של הפרמטר (אם יש לו כזה)

• סוג הפרמטר (כגון מחרוזת או מספר שלם, או אפילו IrisDimension או World)

לחיצה

אתם יכולים ללחוץ על כל פקודה בשביל:

• הפעלת הפקודה (אם אין לה פרמטרים, כלומר תת-סעיף)

• הצעת הפקודה (שימו אותה בתיבת הצ'אט שלכם, כדי שתוכלו להוסיף ערכים נוספים)

Create a world without any players on it (see Getting Started for how you do that)

Pick a size

Pick a center

• Generally you don't need to specify a center

• if you want to set the center at your location, use center=self

• if you want to set the center by a coordinate, use center=0,0

Run the pregen:

• If you are in the world: /iris pregen start <radius>

• If you are in the server: /iris pregen start <radius> world=<worldName>

• If you are in the console: iris pregen start <radius> world=<worldName>

Restarts

If you need to restart your server during a pregeneration, it is safe to do so at any time. You can ignore any errors about threads not shutting down.

After starting your server again, resume the pregen with the same command you entered before. Iris will skip any chunks that were already generated.

• צריך שיהיה לכם כבר עולם (ראו מתחילים)

• בחרו גודל

• הפעילו את הפריג'ן:

  • אם אתם נמצאים בתוך העולם: <iris pregen start <radius/

  • אם אתם בתוך השרת: <iris pregen start <radius> world=<worldName/

  • אם אתם נמצאים בקונסלה: <iris pregen start <radius> world=<worldName/

• סיימתם!

הפעלות מחדש

אם שאתם צריכים להפעיל מחדש את השרת שלכם במהלך פריג'ן, זה בטוח לעשות זאת בכל עת. אתם יכול להתעלם מכל שגיאה לגבי שרשורים שלא נסגרים.

לאחר הפעלת השרת שלכם שוב, המשיכו את הפריג'ן עם אותה פקודה שהזנת קודם לכן. אייריס תדלג על כל צ'אנקים שכבר נוצרו.

• 准备好一个世界（详见 准备工作）

• 选择预加载范围

• 启用预加载:

  • 若您在所生成世界内时启用: /iris pregen start 半径

  • 若您在服务器内时启用: /iris pregen start 半径 world=世界名

  • 若在控制台启用: iris pregen start 半径 world=世界名

• 完成!

重启服务器

预生成期间可随时关闭服务器, 同时会保存进度

启动服务器后通过执行相同的命令以继续预加载

.

Основная команда

Основная команда для доступа это /iris . Прописав эту команду, вы увидите основное меню с командами.

Наведение курсора

Вы можете навести курсор на любую команду или параметр, чтобы увидеть:

• Описание

• Предупреждение, если у вас нет разрешения использовать что-то

• Примеры использования (как что-то использовать)

• Обязателен ли параметр или нет

• Может ли быть параметр получен из контекста (например, мир, в котором вы находитесь)

• Значение параметра по умолчанию (если оно есть)

• Тип параметра (например, String или Integer, или даже IrisDimension или World)

Нажатия

Вы можете нажать любую команду, чтобы:

• Выполнить команду (если у нее нет параметров. т.е. подразделов)

• Предложить команду (т.е. поместить ее в окно чата, чтобы можно было добавить дополнительные значения)

Decree

Iris 는 얼마든지 월드를 창조하고 생성할 수 있습니다. Iris 는 약간의 매뉴얼과 함께 제공되지만, 우리는 당신을 위해 가능한 한 메뉴얼을 쉽게 유지하려고 노력합니다.

준비하기

• 최신 플러그인 파일을 서버 폴더 안 */plugins 폴더에 넣어 Iris 를 설치합니다.

• 서버를 시작합니다.

• 기다립니다. Iris 가 팩을 설치하기 위해 서버를 다시 시작할 겁니다. 수동으로 다시 시작해야 할 수도 있습니다.

• 콘솔의 Iris 로고 위를 읽고 로드된 커스텀 바이옴 수가 최소 70개인지 확인하여 모든 것이 제대로 되었는지 확인하십시오. 이 숫자는 다를 수 있지만 적은 수라면 문제일 수 있습니다.

다음으로 새 월드 만들기 또는 기본 월드 덮어쓰기 중 하나를 수행해야 합니다.

새 월드 만들기

• Rift 설치

• 다음 명령어를 실행하여 월드를 생성하세요: /rift create <worldName> Iris:overworld

• 다음 명령어를 실행하여 생성한 월드로 이동하세요: /rift to <worldName>

• 끝입니다!

기존 월드 덮어쓰기

• 서버를 중지합니다.

• */world 폴더에서 데이터 팩 폴더를 제외한 모든 항목 삭제합니다.

• */bukit.yml 파일을 엽니다.

• 다음 내용을 맨 아래에 추가하세요:

worlds:
  world:
    generator: Iris:overworld

• 서버를 시작합니다.

• 끝입니다!

지원

저희는 디스코드 에서 지원을 제공하고 있습니다. 만약 오류가 발생하여 해결 방법을 알고 싶은 경우 여기에서 질문을 할 수 있습니다. Iris 를 이용해 주셔서 감사합니다!

• Volmit Software

Preparación

• Puede instalar Iris arrastrando el último jar en la carpeta `*/plugins`.

• Inicie el servidor.

• Espere a que Iris reinicie el servidor para instalar el pack. Puede que tenga que encender el servidor manualmente.

• Asegúrate de que todo ha ido bien, puede comprobarlo leyendo el texto encima del logo de Iris y revisando que la cantidad de biomas (Custom Biomes) es mayor a 70. Este número puede variar dependiendo de la versión, pero no supone un problema.

Crear mundos nuevos

¡Muy simple! Ejecuta /iris create.

Reemplaza su mundo principal

1. Apague su servidor.

2. Ves a la carpeta de su mundo (generalmente suele ser la carpeta */world).

3. Mueve la carpeta de datapacks a la carpeta de datapacks al mundo que acaba de crear (el nombre del mundo es el que usó como parámetro cuando lo creo, por ejemplo /iris create prueba creará una carpeta llamada prueba).

4. Abra el archivo server.properties y busque la opción level-name=world.

5. Reemplaze el nombre por el mundo que creo previamente (en el ejemplo anterior sería prueba, por ende level-name=prueba).

6. Inicie el servidor

Accediendo al Mundo

Hay multiples maneras de acceder y de administrar su mundo. Aunque recomendamos el uso de Essentials o MyWorlds.

Prefabricados

Si está teniendo problemas configurando sus mundos, nosotros proveemos servidores prefabricados para la versión 1.19.2. Para ambas opciones es necesario instalar Iris 2.3.9-1.19.2 antes de que inicie el servidor.

1. Servidor con Iris como mundo principal

2. Servidor con Iris como mundo secundario (con mundo principal vanilla)

Soporte

Ofrecemos soporte en nuestro Discord. Puede preguntar sus dudas ahí si se encuentra con un error y quiere saber como arreglarlo. ¡Gracias por usar Iris!

• El Equipo de Software de Volmit

אייריס יכולה ליצור ולבנות עבורך כל מספר של עולמות. אייריס אמנם מגיעה עם קצת מדריך, אבל אנחנו מנסים לעשות את זה קל ככל האפשר עבורך כאן.

הכנה

• התקינו את אייריס, על ידי כך שתשימו את הקובץ העדכני ביותר בתוך plugins\*

• הפעילו את השרת

• חכו. אייריס תפעיל מחדש את השרת כדי להתקין את החבילה. ייתכן שתצתרכו להפעיל אותו שוב באופן ידני.

• וודאו שהכל הלך כמו שצריך, על ידי קריאה מעל הלוגו של איירס בקונסולה, וודאו את שמספר ה-ביומות מותאמות אישית הוא לפחות 70. מספר זה יכול להשתנות, אך סביר להניח שפחות זה בעיה.

יצירת העולם

• עצרו. את השרת.

• פתחו את הקובץ bukkit.yml/*

• הוסיפו את השורות הבאות:

worlds:  
  NAME:
    generator: Iris:overworld

worlds:
  NAME1:
    generator: Iris:overworld 
  NAME2:
    generator: Iris:overworld

• הפעילו את השרת

גישה לעולם

ישנן אפשרויות רבות לגשת לעולם. אנחנו תומכים ברובם.

תמיכה

אנו מציעים תמיכה בדיסקורד שלנו. אתם יכולים לשאול שם שאלות אם נתקלתם בשגיאה, ורוצים לדעת איך לתקן אותה. תודה על השימוש במנוע באייריס!

• צוות התוכנה של וולמיט

• Подготовьте мир (см. раздел )

• Выберите размер (радиус)

• Запустите преген командами:

  • Если вы находитесь в мире: /iris pregen start <радиус>

  • Если вы находитесь на сервере: /iris pregen start <радиус> world= <название_мира>

  • Если вы находитесь в консоли: iris pregen start <радиус> world= <название_мира>

• Готово!

Перезапуск

Если вам необходимо перезагрузить сервер во время прегенерации, это можно сделать в любое время. Вы можете игнорировать любые ошибки о том, что потоки не завершаются.

После повторного запуска сервера возобновите прегенерацию с помощью той же команды, которую вы ввели ранее. Iris пропустит все части, которые уже были сгенерированы.

Cree un mundo sin ningún jugador en el (puede ver si no sabe como hacer eso)

Elije un tamaño

Configure el centro

• Normalmente no se necesita especificar el centro.

• Si quiere configurar el centro a su posición actual puede usar center=self

• Si quiere configurar el centro a unas coordenadas puede usar center=0,0

Comienze la pregeneración

• Si está en el mundo: /iris pregen start <radio>

• Si está en el servidor: /iris pregen start <radio> world=<nombre del mundo>

• Si está desde la consola: /iris pregen start <radio> world=<nombre del mundo>

Reinicios

Si necesita reiniciar su servidor mientras pregenera un mundo, es seguro hacerlo en cualquier momento. Puede ignorar cualquier error que pueda llegar a aparecer en la consola.

Después de reiniciar su servidor, puede resumir la pregeneración con el mismo comando que ha usado antes. Iris ignorará los chunks que ya haya generado.

Конфигурация (настройка) самого Iris небольшая, поскольку все настройки мира выполняются в паках (более подробная информация здесь).

{
    "general": {
        "commandSounds": true,
        "debug": false,
        "disableNMS": false,
        "pluginMetrics": true,
        "splashLogoStartup": true,
        "useConsoleCustomColors": true,
        "useCustomColorsIngame": true,
        "forceMainWorld": "",
        "spinh": -20,
        "spins": 7,
        "spinb": 8
    },
    "gui": {
        "useServerLaunchedGuis": true,
        "maximumPregenGuiFPS": false
    },
    "generator": {
        "defaultWorldType": "overworld",
        "headlessPregeneration": false,
        "maxBiomeChildDepth": 4,
        "preventLeafDecay": true
    },
    "concurrency": {
        "parallelism": -1
    },
    "studio": {
        "studio": true,
        "openVSCode": true,
        "disableTimeAndWeather": true,
        "autoStartDefaultStudio": false
    },
    "performance": {
        "mantleKeepAliveSeconds": 60,
        "cacheSize": 131072
    }
}

Общее

Это общие настройки, которые необходимо поменять для изменения основных функций программы.

• commandSounds: Если включена, воспроизводит звуки при использовании команд.

• debug: При значении true включает экстремальный по объему поток информации о внутренней работе Iris. Отлично подходит для отладки конкретной проблемы, жутко не удобен для чтения.

• disableNMS: При включении отключает использование NMS. Мы используем NMS (исходный код Minecraft) для получения информации о биомах, регистрации пользовательских имен биомов, регистрации tile entities и многого другого. Установка этого параметра в true отключит все эти системы, но может вызвать множество проблем. Лучше не трогать.

• pluginMetrics: Это переключение метрик плагина для bstats. Это помогает нам узнать, что люди используют, чтобы мы могли улучшить плагин. Вся информация анонимна. Пожалуйста, не выключайте это :)

• splashLogoStartup: Выводит причудливый логотип Iris при запуске, если он включен.

• useConsoleCustomColors: Использование пользовательских цветов в консоли.

• useCustomColorsIngame: Использование пользовательских цветов в игре.

• forceMainWorld: Принудительно помещает датапаки в другую папку. Лучше всего оставить пустым.

• spinh & spins & spinb: Они задают градиенты цветов в консоли и в игре.

GUI (Графический интерфейс пользователя)

Это простая настройка для переключения всплывающих графических интерфейсов Iris. Если у вас хостинговый сервер, вы можете отключить их, так как вы все равно их не увидите.

• useServerLaunchedGuis: При значении true запускает GUI при запуске Прегенерации.

• maximumPregenGuiFPS: При значении true делает FPS графического интерфейса прегенерации намного выше, но также увеличивает использование процессора, снижая скорость прегенерации. Если вы хотите наслаждаться просмотром графического интерфейса некоторое время, установите значение true, но оставьте значение false, если вам нужна максимальная производительность.

Генератор

Это настройки генератора, они позволяют изменять ключевые элементы основной функциональности движка.

• defaultWorldType: Изменяет стандартный пак, который Iris использует при выполнении команды /iris create

• headlessPregeneration: При значении true включает экспериментальную (в основном стабильную) систему генерации, которая сильно увеличивает скорость Прегенерации.

• maxBiomeChildDepth: Iris поддерживает циклические ссылки на биомы. (биом внутри биома) Т.е. пустыня может иметь дочерний(биом внутри биома) биом саванна, а саванна в свою очередь может иметь дочерний биом пустыня, если вы спроектируете его таким образом. Этот параметр не позволяет биомам бесконечно генерировать дочерние биомы. Если ваши биомы не используют более 5 слоев дочерних биомов (глубина), обычно нет необходимости увеличивать этот параметр.

• preventLeafDecay: При значении true, предотвращает активное исчезновение листьев, устанавливая для них тег persistent.

Параллелизм (одновременность)

• parallelism: Этот параметр определяет, сколько потоков разрешено использовать/создавать iris. Установите значение -1, чтобы iris сам определял, что ему использовать. Оставьте значение -1, если вы не знаете, как работают потоки. -2 устанавливает количество потоков на половину доступного, -4 - на четверть. Вы также можете установить значение, например, 6, что позволит Iris использовать 6 потоков.

Студия

Режим студии позволяет разрабатывать миры с помощью проектов. Эта функция используется при разработке миров с локальным сервером.

• studio: При значении true студийный режим активирован и вы можете с ним работать.

• openVSCode: При значении true, Iris автоматически открывает VSCode, когда вы открываете студийный мир.

• disableTimeAndWeather: При значении true изменения времени и погоды не происходят в студийных мирах.

• autoStartDefaultStudio: При запуске сервера этот параметр будет сразу же запускать студийный мир.

Производительность

Настройки предварительной генерации для кеширования, в частности, в Mantle.

• mantleKeepAliveSeconds: Количество секунд, через которое кэшированные данные mantle становятся недействительными и сохраняются. Чем выше это значение, тем больше оперативной памяти требуется во время прегенерации. Значения по умолчанию достаточно для прегенерации. Дальнейшее увеличение этого числа не сильно поможет, по сравнению с тем, сколько дополнительной оперативной памяти это будет стоить.

• cacheSize: Iris кэширует много данных во время генерации. Это экономит много времени во время генерации, но занимает немного дополнительной памяти. Это кэш, который каждый отдельный поток данных может использовать максимально. Это число было сгенерировано с помощью функции оптимизации, изменять его не рекомендуется.

This configuration is small because all world configuration is done in Packs.

{
    "general": {
        "commandSounds": true,
        "debug": false,
        "disableNMS": false,
        "pluginMetrics": true,
        "splashLogoStartup": true,
        "useConsoleCustomColors": true,
        "useCustomColorsIngame": true,
        "forceMainWorld": "",
        "spinh": -20,
        "spins": 7,
        "spinb": 8
    },
    "world": {
        "asyncTeleport": {
            "enabled": false,
            "loadViewDistance": 2,
            "urgent": false
        },
        "postLoadBlockUpdates": true,
        "forcePersistEntities": true,
        "anbientEntitySpawningSystem": true,
        "asyncTickIntervalMS": 700,
        "targetSpawnEntitiesPerChunk": 0.95,
        "markerEntitySpawningSystem": true,
        "effectSystem": true
    },
    "gui": {
        "useServerLaunchedGuis": true,
        "maximumPregenGuiFPS": false
    },
    "autoConfiguration": {
        "configureSpigotTimeoutTime": true,
        "configurePaperWatchdogDelay": true,
        "autoRestartOnCustomBiomeInstall": true
    },
    "generator": {
        "defaultWorldType": "overworld",
        "headlessPregeneration": false,
        "maxBiomeChildDepth": 4,
        "preventLeafDecay": true
    },
    "concurrency": {
        "parallelism": -1
    },
    "studio": {
        "studio": true,
        "openVSCode": true,
        "disableTimeAndWeather": true,
        "autoStartDefaultStudio": false
    },
    "performance": {
        "trimMantleInStudio": false,
        "mantleKeepAlive": 30,
        "cacheSize": 4096,
        "resourceLoaderCacheSize": 1024,
        "objectLoaderCacheSize": 4096,
        "scriptLoaderCacheSize": 512
    }
}

General

These are the general settings that you would need to change for changing core functionalities of the software.

• commandSounds: When enabled, plays sounds when using commands.

• debug: When true, enables an extreme dump of information about Iris' internals working. Great for debugging a specific problem, terrible to read.

• disableNMS: When enabled, turns NMS usage off. We use NMS (Minecraft's raw source code) for getting biome details, registering custom biome names, registering tile entities and more. Turning this setting to true will disable all these systems but may cause a lot of issues. Better not to touch.

• pluginMetrics: This toggles plugin metrics for bstats. It helps us know what people are using so we can improve the plugin. All information is anonymous. Please leave this on :)

• splashLogoStartup: Prints the fancy Iris logo on startup, if enabled.

• useConsoleCustomColors: Use custom colors in the console.

• useCustomColorsIngame: Use custom colors in game.

• forceMainWorld: Force Datapacks to be in another folder. Best to leave empty.

• spinh & spins & spinb: These dictate the gradients of the colors in the console and in-game.

World

Settings for generating worlds, among others.

• asyncTeleport can be enabled and modifies the way players are teleported to (new) Iris worlds. If this is set to true, requests are handled asynchronously and chunks are generated async as well. The loadViewDistance is the distance (radius) in which chunks are prepared. The request can also be marked urgent which makes the server handle it more quickly.

• postLoadBlockUpdates toggles whether Iris schedules block updates, or immediately runs them upon generation. This means that any block that is updated (such as the walls of caves, areas near water, etc) will be done while generating. This makes pregeneration much slower, but will have a decent performance improvement when the world is being used.

• forcePersistEntities makes persistent in chunks, meaning mob spawns will be stored in the metadata Iris stores for each chunk, instead of it being queried from the pack.

• anbientEntitySpawningSystem automatically spawns mobs in the area near the player as configured.

• asyncTickIntervalMS is the delay beween entity spawn checks (higher = more performant, lower = more accurate mob counts)

• targetSpawnEntitiesPerChunk modifies the amount of entities that Iris tries to spawn per chunk on a global level. If it is configured that 10 zombies should be spawned at any time, while this is on 0.9, there will be 9 zombies at any time.

• markerEntitySpawningSystem toggles whether markers (specific locations in buildings) will be used to spawn entities at those locations.

• effectSystem toggles whether particle effects are used in the world (such as little smoke clouds in the desert, pixie particles in the jungle, etc)

GUI

This is just a simple settings for toggling Iris' GUIs that pop up. If you have a hosted server you may want to disable them as you cant see them anyways.

• useServerLaunchedGuis: When true, launches a GUI on Pregeneration start.

• maximumPregenGuiFPS: When true, makes the FPS of the pregeneration GUI a lot higher but will also increase CPU usage, decreasing pregeneration speed. If you want to enjoy watching the GUI for a while, turn this to true, but keep it false if you are looking for maximum performance.

Generator

These are the Generator settings, they allow you to modify key elements of the Engines core functionality.

• defaultWorldType: This changes the default pack Iris uses when any command that uses the default pack.

• maxBiomeChildDepth: Iris supports cyclic biome references. I.e. desert could have a child biome savanna and savanna could in turn have child biome desert if you design it that way. This parameter stops biomes from infinitely generating children. Unless your biomes really take advantage of more than 5 layers of biome children (depth), there is usually no need to increase this.

• preventLeafDecay: When true, prevents the active decay of leaves by setting them all to persistent.

Concurrency

• parallelism: This setting dictates how many threads iris is allowed to use/make set it to -1 allows iris to dictate what its using leave this at -1 if you don't know how threads work. -2 sets the amount of threads to half the available, -4 to a fourth. You can also set this to 6, for example, which allows Iris to use 6 threads.

Studio

Studio mode allows you to design worlds with projects. This feature is used when designing worlds with a local server.

• studio: When true, studio mode is activated and can be used.

• openVSCode: When true, Iris automatically opens VSCode when you open a studio world.

• disableTimeAndWeather: When true, time & weather changes do not happen in studio worlds.

• autoStartDefaultStudio: When starting the server, this will start a studio world immediately.

Performance

Pregeneration settings for caching, specifically within Mantle. Don't modify unless you have some idea of what you're doing. These affect the caches and mantle, two integral parts of the engine & generator.

• trimMantleInStudio toggles whether a truncated, more performant, mantle is used for studio worlds. Set this to true if you are not editing entities, interested in finding objects, or knowing which biome you are in, while in studio worlds, but want better performance.

• mantleKeepAliveSeconds: The number of seconds after which cached mantle data is invalidated and saved. The higher this is, the more RAM you need during pregen. The default is suitable for pregen. Increasing this number further will not help much, compared to how much extra RAM it costs, unless you have really slow drive.

• cacheSize: Iris caches a lot of data during generation. This saves a lot of time during generation but takes some extra memory. This cache is the cache each individual stream of data can use at most. This number was generated with an optimization function, changing it is not advisable.

• resourceLoaderCacheSize modifies the cache size for any non-script and non-object configuration file. Increasing this increases the RAM requirement of your server, for a small performance boost to pregeneration.

• objectLoaderCacheSize modifies the cache size for objects. Higher requires more RAM, but increases performance.

• scriptLoaderCacheSize modifies the cache size for scripts. Higher requires more RAM, but increases performance.

התצורה של איירס עצמה קטנה מכיוון שכל תצורת העולם נעשית בחבילות (עוד מידע כאן)

{    "general": {
        "commandSounds": true,
        "debug": false,
        "disableNMS": false,
        "pluginMetrics": true,
        "splashLogoStartup": true,
        "useConsoleCustomColors": true,
        "useCustomColorsIngame": true,
        "forceMainWorld": "",
        "spinh": -20,
        "spins": 7,
        "spinb": 8
    },
    "world": {
        "asyncTeleport": {
            "enabled": false,
            "loadViewDistance": 2,
            "urgent": false
        },
        "postLoadBlockUpdates": true,
        "forcePersistEntities": true,
        "anbientEntitySpawningSystem": true,
        "asyncTickIntervalMS": 700,
        "targetSpawnEntitiesPerChunk": 0.95,
        "markerEntitySpawningSystem": true,
        "effectSystem": true
    },
    "gui": {
        "useServerLaunchedGuis": true,
        "maximumPregenGuiFPS": false
    },
    "autoConfiguration": {
        "configureSpigotTimeoutTime": true,
        "configurePaperWatchdogDelay": true,
        "autoRestartOnCustomBiomeInstall": true
    },
    "generator": {
        "defaultWorldType": "overworld",
        "headlessPregeneration": false,
        "maxBiomeChildDepth": 4,
        "preventLeafDecay": true
    },
    "concurrency": {
        "parallelism": -1
    },
    "studio": {
        "studio": true,
        "openVSCode": true,
        "disableTimeAndWeather": true,
        "autoStartDefaultStudio": false
    },
    "performance": {
        "trimMantleInStudio": false,
        "mantleKeepAlive": 30,
        "cacheSize": 4096,
        "resourceLoaderCacheSize": 1024,
        "objectLoaderCacheSize": 4096,
        "scriptLoaderCacheSize": 512
    }
}

כללי

אלו הן ההגדרות הכלליות שתצטרכו לשנות בשביל לעדכן פונקציונליות הליבה של התוכנה.

• commandSounds: כאשר מופעל, משמיע צלילים בעת שימוש בפקודות.

• debug: .כאשר זה מופעל, מאפשר איסוף מוגזם של מידע על התפקוד הפנימי של אייריס .מצוין לאיתור באגים בבעיה ספציפית, קשה לקרוא ולהבין

• disableNMS: NMS - קוד המקור הגולמי של מיינקראפט .כאשר מופעל זה, מכבה את השימוש ב-קוד המקור הגולמי של מיינקראפט אנו משתמשים ב-קוד המקור הגולמי של מיינקראפט לקבלת פרטי ביומה, רישום שמות ביומה מותאמים אישית, רישום ישויות צ'אנקים ועוד true-הפיכת הגדרה זו ל תשבית את כל המערכות הללו אך עלולה לגרום לבעיות רבות. עדיף לא לגעת

• pluginMetrics: bstats-זה מכבה את מדדי הפלאגין עבור כל המידע הוא אנונימי. זה עוזר לנו לדעת במה אנשים משתמשים כדי שנוכל לשפר את התוסף :) אנא השאירו את זה פועל

• splashLogoStartup: מדפיס את הלוגו המפואר של איירס בעת ההפעלה, אם מופעל

• useConsoleCustomColors: השתמשו בצבעים מותאמים אישית בקונסולה.

• useCustomColorsIngame: השתמש בצבעים מותאמים אישית במשחק.

• forceMainWorld: להיות בתיקייה אחרת הכי טוב להשאיר ריק Datapacksכפה על

• spinh & spins & spinb: אלה מכתיבים את שיפוע הצבעים בקונסולה ובמשחק.

עולם

הגדרות ליצירת עולמות, בין היתר.

• asyncTeleport can be enabled and modifies the way players are teleported to (new) Iris worlds. If this is set to true, requests are handled asynchronously and chunks are generated async as well. The loadViewDistance is the distance (radius) in which chunks are prepared. The request can also be marked urgent which makes the server handle it more quickly.

• postLoadBlockUpdates toggles whether Iris schedules block updates, or immediately runs them upon generation. This means that any block that is updated (such as the walls of caves, areas near water, etc) will be done while generating. This makes pregeneration much slower, but will have a decent performance improvement when the world is being used.

• forcePersistEntities makes persistent in chunks, meaning mob spawns will be stored in the metadata Iris stores for each chunk, instead of it being queried from the pack.

• anbientEntitySpawningSystem automatically spawns mobs in the area near the player as configured.

• asyncTickIntervalMS is the delay beween entity spawn checks (higher = more performant, lower = more accurate mob counts)

• targetSpawnEntitiesPerChunk modifies the amount of entities that Iris tries to spawn per chunk on a global level. If it is configured that 10 zombies should be spawned at any time, while this is on 0.9, there will be 9 zombies at any time.

• markerEntitySpawningSystem toggles whether markers (specific locations in buildings) will be used to spawn entities at those locations.

• effectSystem toggles whether particle effects are used in the world (such as little smoke clouds in the desert, pixie particles in the jungle, etc)

GUI (ממשק משתמש גרפי)

This is just a simple settings for toggling Iris' GUIs that pop up. If you have a hosted server you may want to disable them as you cant see them anyways.

• useServerLaunchedGuis: When true, launches a GUI on Pregeneration start.

• maximumPregenGuiFPS: When true, makes the FPS of the pregeneration GUI a lot higher but will also increase CPU usage, decreasing pregeneration speed. If you want to enjoy watching the GUI for a while, turn this to true, but keep it false if you are looking for maximum performance.

ג'נרטור

These are the Generator settings, they allow you to modify key elements of the Engines core functionality.

• defaultWorldType: This changes the default pack Iris uses when any command that uses the default pack.

• maxBiomeChildDepth: Iris supports cyclic biome references. I.e. desert could have a child biome savanna and savanna could in turn have child biome desert if you design it that way. This parameter stops biomes from infinitely generating children. Unless your biomes really take advantage of more than 5 layers of biome children (depth), there is usually no need to increase this.

• preventLeafDecay: When true, prevents the active decay of leaves by setting them all to persistent.

במקביל

• parallelism: This setting dictates how many threads iris is allowed to use/make set it to -1 allows iris to dictate what its using leave this at -1 if you don't know how threads work. -2 sets the amount of threads to half the available, -4 to a fourth. You can also set this to 6, for example, which allows Iris to use 6 threads.

סטודיו

Studio mode allows you to design worlds with projects. This feature is used when designing worlds with a local server.

• studio: When true, studio mode is activated and can be used.

• openVSCode: When true, Iris automatically opens VSCode when you open a studio world.

• disableTimeAndWeather: When true, time & weather changes do not happen in studio worlds.

• autoStartDefaultStudio: When starting the server, this will start a studio world immediately.

ביצועים

Pregeneration settings for caching, specifically within Mantle.

• trimMantleInStudio toggles whether a truncated, more performant, mantle is used for studio worlds. Set this to true if you are not editing entities, want to find objects, or know which biome you are in, while in studio worlds, but want better performance.

• mantleKeepAliveSeconds: The amount of seconds after which cached mantle data is invalidated and saved. The higher this is, the more RAM you need during pregen. The default is suitable for pregen. Increasing this number further will not help much, compared to how much extra RAM it costs.

• cacheSize: Iris caches a lot of data during generation. This saves a lot of time during generation, but takes some extra memory. This cache is the cache each individual stream of data can use at most. This number was generated with an optimization function, changing it is not advisable.

• resourceLoaderCacheSize modifies the cache size for any non-script and non-object configuration file. Increasing this increases the RAM requirement of your server, for a small performance boost to pregeneration.

• objectLoaderCacheSize modifies the cache size for objects. Higher requires more RAM, but increases performance.

• scriptLoaderCacheSize modifies the cache size for scripts. Higher requires more RAM, but increases performance.

主要命令

通过执行 /iris 以获取 Iris 的主要命令列表.

悬停信息

将光标移动至一行命令可获取下列信息:

• 命令的描述

• 所需权限（若您未拥有）

• 使用示例

• 定义子选项的必要性

• 子选项对应的当前值（如填写 world=世界名 时直接显示您所处的世界）

• 子选项默认值（若拥有）

• 子选项的值类型（如Intergr, Float, String）

点击事件

点击命令文本将:

• 运行命令（若不存在任何子选项）

• 导入到聊天栏 (将命令行直接输入聊天栏)

若定义为 true, 则本体配置相较于世界生成器配置简单的

{    "general": {
        "commandSounds": true,
        "debug": false,
        "disableNMS": false,
        "pluginMetrics": true,
        "splashLogoStartup": true,
        "useConsoleCustomColors": true,
        "useCustomColorsIngame": true,
        "forceMainWorld": "",
        "spinh": -20,
        "spins": 7,
        "spinb": 8
    },
    "world": {
        "asyncTeleport": {
            "enabled": false,
            "loadViewDistance": 2,
            "urgent": false
        },
        "postLoadBlockUpdates": true,
        "forcePersistEntities": true,
        "anbientEntitySpawningSystem": true,
        "asyncTickIntervalMS": 700,
        "targetSpawnEntitiesPerChunk": 0.95,
        "markerEntitySpawningSystem": true,
        "effectSystem": true
    },
    "gui": {
        "useServerLaunchedGuis": true,
        "maximumPregenGuiFPS": false
    },
    "autoConfiguration": {
        "configureSpigotTimeoutTime": true,
        "configurePaperWatchdogDelay": true,
        "autoRestartOnCustomBiomeInstall": true
    },
    "generator": {
        "defaultWorldType": "overworld",
        "headlessPregeneration": false,
        "maxBiomeChildDepth": 4,
        "preventLeafDecay": true
    },
    "concurrency": {
        "parallelism": -1
    },
    "studio": {
        "studio": true,
        "openVSCode": true,
        "disableTimeAndWeather": true,
        "autoStartDefaultStudio": false
    },
    "performance": {
        "trimMantleInStudio": false,
        "mantleKeepAlive": 30,
        "cacheSize": 4096,
        "resourceLoaderCacheSize": 1024,
        "objectLoaderCacheSize": 4096,
        "scriptLoaderCacheSize": 512
    }
}

整体（"generaal:"）

整体选项影响 Iris 本体的运作

世界（"world:"）

配置一些与世界有关的内容

仅作用于 Iris 所生成的世界

GUI（"gui:"）

定义 Iris 与 GUI界面 有关的内容

世界生成（"generator:"）

世界生成的一些关键设置

调用线程（"concurrency:"）

工作室（"studio:"）

工作室模式用于在本地服务器内设计世界.

缓存预加载（"Performance:"）

用于缓存预加载的设定

La configuración de Iris no es muy externa ya que la configuración está hecha mayormente por los Packs.

General

Estos son los ajustes generales que no cambian características esenciales del plugin.

• commandSounds: Se des/habilita que se ejecute un sonido cuando se ejecuta un comando.

• debug: Si está en true, este mostrará mucha información sobre Iris. Hecho para encontrar bugs o errores para un error especifico (horrible de leer).

• disableNMS: Si se habilita, deshabilita el uso de NMS. Usamos NMS (el código de minecraft) para leer detalles de un bioma, registrar biomas personalizados, registrar tile entities y mucho más. Habilitar esto puede causar muchos problemas, es recomendable no tocarlo.

• pluginMetrics: Esto des/habilita que se pueda registrar el uso del plugin.

• splashLogoStartup: Imprime en pantalla el logo de Iris.

• useConsoleCustomColors: Uso de colores personalizados en la consola.

• useCustomColorsIngame: Uso de colores personalizados en el juego.

• forceMainWorld: Fuerza que los datapacks estén en otro directorio. Mejor no tocar.

• spinh & spins & spinb: Estos configuran la gradiente de los colores de la consola y el juego.

Mundo

Ajustes para el mundo, y otros.

• asyncTeleport: Esta opción modifica la manera en la que los jugadores son teletransportados a un mundo de Iris. Si está habilitado las peticiones se manejan de una manera asíncrona y los chunks son generados de la misma manera. La opción loadViewDistance es la distancia (radio) en la que se preparan los chunks. Las peticiones también pueden ser urgent lo que hace que el servidor pueda manejarlas más rápido.

• postLoadBlockUpdates: Cambia la manera en la cual Iris programa las actualizaciones de los bloques. Esto significa que las actualizaciones de bloques se harán al mismo momento que estos sean cargados. Esta hace que la pregeneración sea muy lenta, pero tendrá una mayor capacidad cuando el mundo se esté usando.

• forcePersistEntities: Hace que los chunks sean persistentes, esto significa que los mobs no despawnearan cuando el chunk se descargue.

• ambientEntitySpawningSystem: Spawnea mobs automaticamente alrededor del jugador.

• asyncTickIntervalMS:

• targetSpawnEntitiesPerChunk: modifica la cantidad de entidades que Iris trata de spawnear por chunk. Si está configurado que 10 zombis sean spawneados en cualquier momento y está opción esta en 0.6, solo habrán 6 zombis por chunk.

• markerEntitiesSpawningSystem: Des/habilita si se deberían usar coordenadas específicas para spawnear entidades.

• effectSystem: Des/habilita el uso de particulas en el mundo.

Iris Entities

遵循下列格式以在 Iris 所生成世界的群系内生成 Mythic实体, 详情见 页面.

然后需要创建一个 Iris 实体文件, 内部名前缀应为 MythicMobs:

MythicMobs 随机生成

示例

Iris Entities

You can spawn mythic mobs in custom biomes by following this format, More info .

As seen here, to make Iris spawn a mythic mob, you'll need to create a new Iris entity file with specialType, where you prefix the name with MythicMobs:

MythicMobs RandomSpawns

See the MythicMobs wiki:

Entidades de Iris

Puedes spawnear mobs en biomas personalizados usando este formato, más información en Entidades

Como se puede apreciar en el código, para poder crear una entidad con MythicMobs se deberá usar el valor specialType (tipo especial), donde se especifica el prefijo MythicMobs:

Spawneos alteatorios

Ya que Mythic Mobs no soporta biomas personalizados, es difícil hacer que sus entidades se generen en lugares alteatorios en el bioma correspondiente.

Incompatible

Compatible

Integrations

ישויות אייריס

אפשר לשגר ישויות בביומות של אייריס, בשביל עוד מידע

כמו שאפשר לראות כאן, בשביל לגרום לאייריס לעשות שיגור לישויות אנחנו צריכים ליצור קובץ אייריס אם סוג היישות המיוחד, יחד אם המזהה שלה בתוך הפלאגין MythicMobs

שיגור רנדומלי ב-MythicMobs

בגלל ש-MythicMobs לא תומך בביומות מותאמות אישית של אייריס, אז יכול להיות קשה להשתמש ב-MythicMobs כדי לשגר ישיות באקראיות בתוך ביומות אייריס.

דוגמא לשימוש

Когда обновлять Iris

Обновление Iris не похоже на обновление любого другого плагина. Чтобы провести сравнение между Iris и Mojang - Когда вы обновляете версию Minecraft на вашем сервере, это приводит к тому, что любой новый чанк, который генерируется, не будет совпадать с существующими чанками, в каждом ванильном мире.

Iris также генерирует миры для вас, поэтому у него та же проблема. Разница в том, что Iris обновляется часто, а Mojang - редко, что заставляет пользователей думать, что обновление безопасно, хотя на самом деле оно может принести больше вреда и проблем.

Итак, когда вам следует обновить Iris?

Обновлять Iris следует только тогда, когда вы готовы удалить все миры Iris.

Если вы думаете об обновлении Iris в любом случае, лучше сначала свяжитесь с поддержкой и обсудите это.

Если вы уверены, что хотите обновить Iris, см. раздел Обновление Overworld.

Предупреждения PaperMC

Для того, чтобы PaperMC не спамил большим количеством предупреждений во время создания вашего мира (которые безвредны и бесполезны), вы можете добавить следующие настройки в конфигурацию paper.yml, заменив существующую конфигурацию:

  watchdog:
    early-warning-every: 5000000
    early-warning-delay: 10000000

Завершение работы (вас кикнуло) во время создания мира

Серверы выкидывают игроков через определенное время. Вы можете увеличить это время, заменив параметр timeout-time установкой следующего значения в */spigot.yml.

settings:
  timeout-time: 60000

Падение сервера Pterodactyl (RAM)

Pterodactyl известен тем, что отключает серверы, использующие полную (всю) оперативную память, например, при создании мира Iris или предварительной генерации. Чтобы решить эту проблему, можно предпринять два шага, оба связаны с установкой флагов запуска.

-XX:+UnlockExperimentalVMOptions -XX:+UseG1GC -XX:G1HeapWastePercent=7 -XX:G1NewSizePercent=15 -XX:G1MaxNewSizePercent=40 -jar server.jar

Если это не сработает, попробуйте следующее:

-XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -Dusing.aikars.flags=https://mcflags.emc.gs/ -Daikars.new.flags=true -Dterminal.jline=false -Dterminal.ansi=true -jar server.jar

Перезагрузка после загрузки пака

Это связано с тем, что дата-паки уже установлены на сервер перед его запуском, в то время как Iris еще не готов к запуску. Iris использует дата-паки для создания удивительных цветных биомов, таких как биом Сакура:

Замысел состоит в том, чтобы ваш сервер мог предоставить все пользовательские цвета, которые может предложить Iris, в генераторе. Если вы не хотите использовать эту функцию в своем мире, удалите раздел Custom-Derivatives из каждого биома в паке.

Почему небезопасно обновлять Iris?

Iris подвергается многочисленным изменениям в генераторе. Это означает, что во многих случаях генерация рельефа существенно меняется. Даже небольшие изменения в исходном коде генерации вызывают значительные различия по краям существующих чанков, когда они должны красиво перетекать в новые чанки.

Вы можете удивиться, почему мы просто не смешиваем биомы:

Чтобы ответить на этот вопрос, приведем цитату нашего ведущего разработчика:

"Обычно невозможно сделать что-то подобное без того, чтобы в итоге не получить жесткие границы / необходимость редактировать миллионы чанков. При изменении карты биомов все меняется. То, что было пустыней, теперь становится лесом. Я мог бы смешать это с помощью интерполятора, но... не обращая внимания на интенсивный процессор (CPU) [требуемый для этого], это все равно будет выглядеть ужасно, потому что это все равно будет выглядеть как стена, только более гладкая, и биомы все равно будут жестко обрезаны. Просто обновитесь, когда будете готовы сделать новую карту, это не большая проблема 😛"

Если вы являетесь или знаете разработчика, который был бы готов добавить это в Iris относительно эффективным (результативным) способом, который также является поддерживаемым и расширяемым, не стесняйтесь создать PR в репозитории Iris.

Красный логотип при запуске

Установите в файле settings.json Configuration -> General -> useConsoleCustomColors значение false

"NoClassDefFoundError: io/papermc/lib/PaperLib"

Вместо использования gradlew build или task > build > build, используйте gradlew shadowJar или tasks > shadow > shadowJar при сборке плагина.

Неподдерживаемые плагины

Есть несколько плагинов, которые слишком сильно вмешиваются в работу Iris. Мы стараемся обеспечить беспроблемное сотрудничество с большинством плагинов, но эти, к сожалению, переходят границы.

Неподдерживаемые плагины:

• Ultra Regions

• Region Manager

• Plugman

• Hotplug

• Любые другие WorldGenerator, которые берут на себя генерацию чанков без каких-либо инструкций (EWG, RWG, DWG не работают. Terra может работать).

Деинсталляция (удаление) Iris

Есть много вещей, которыми управляет Iris, которые будут нарушены, если вы удалите плагин. Многие из этих функций могут вызвать проблемы на серверах выживания, поэтому мы настоятельно рекомендуем оставить Iris установленным.

Функции, которые могут сломаться:

When to update Iris

Updating Iris is not like any other plugin. To draw a comparison between Iris and Minecraft - When you update your server's Minecraft version, it will result in any new chunk that is generated to not be aligned with existing chunks, in every vanilla world.

Iris generates worlds for you as well, and it has the same problem. The difference is that Iris updates a lot, and Minecraft barely, which makes users think it is safe to update, when in reality, it may do more harm than good.

A quote from our lead developer:

Generally, it's not possible to do something like that without ending up with hard borders / having to edit millions of chunks possibly. By changing the biome map, everything changes. Things that were a desert are now a forest. I could blend it by using an interpolator, but... ignoring the intense CPU [required for] that, it would still look terrible, because it would still look like a wall, just smoother, and the biomes would still be cut-off. Just update when you're ready to make a new map, it's not a big issue 😛

So, when should you update Iris?

You should only update Iris when you are ready to delete or recreate all Iris worlds. If you are thinking about updating Iris in any other case, contact support to discuss it first.

You can now update the Iris plugin. If you are sure you want to update Iris, make sure to also update the Overworld pack on your server.

How to update Your Pack

Updating should only be done when needed, or when you are ready to update the content from the latest release. This goes for both the Plugin as the Overworld pack.

Read When to update Iris first.

For new worlds

/iris download <packName> overwrite=true

This command does not update the current Overworld that is in any active Iris world, but only the one in the */plugins/Iris/packs folder. Thus, it only applies to new worlds. This is also why you need to make sure you are ready to delete all existing Iris worlds and create new ones.

Updating loaded worlds can cause terrible transitions between old and new chunks, among other issues, which is why the option below is advised against.

Generated Worlds

/iris update-world

Uninstalling Iris

There are many things Iris controls which will break when you uninstall the plugin. A lot of these features may cause issues in survival servers, so we strongly recommend keeping Iris installed.

Features that are likely to break:

• New chunks will not be custom: New chunks will be normal vanilla chunks which do not align properly with existing chunks. Removing these manually can be difficult if you wish to amend it.

• Custom height modifications: Iris is responsible for setting the max height to something different than vanilla. If you remove Iris, this will not be ensured with every world, and you may end up with mountains cut-off at the new - wrong - build limit.

• World Shifting: A less probable bug, but one that can still seriously mess up your worlds is that certain parts of the world may be shifted up 64 blocks. This allows people to get below the bedrock, breaks the terrain and can even cut player-built buildings in half.

• Custom leaf decay systems: Iris spawns custom trees which have leaves which are too far away from logs without them decaying. Iris controls leaf decay systems and uninstalling the plugin may result in leaves being removed where they shouldn't.

• Strongholds cannot be found with eyes of ender: Iris allows you to directly control how many strongholds can spawn and how far apart they are. Because we don't follow the same method as vanilla, eyes of ender require Iris to be installed to lead to the correct locations. If you uninstall Iris, eyes of ender will lead to locations where there is nothing (where vanilla would place one)

• No mob and animal spawns: Iris does not spawn mobs when it generates chunks, but instead has its own spawning system to evenly distribute mobs/animals over the entire server. These mobs will no longer spawn. Mobs that spawn in structures like silverfish and guardians will no longer spawn.

• Custom particle & sound effects will disappear: There are custom particles & sound effects which will no longer be (dis)played and replaced by (boring) vanilla defaults. Iris uses these to add biome immersion, and all of this would be removed.

How to change the seed in Iris

Iris worlds, as opposed to normal vanilla worlds, generates new worlds with the same seed every time. To change this seed, you have to add it to the server.properties file, which you find in your main server directory (*/server.properties). Just locate the level-seed= setting and add any number behind it, at random. Every time you change this, and generate a new Iris world, you will have new random generation.

Out of bounds error

To fix it, let the server restart when you see Iris warning about biomes in the console. We ask you to restart in the error at the bottom, so please do so. Want to know why? See Why does Iris restart the server?

Manually downloading the Overworld

1. Stop the server

2. Remove */plugins/iris/packs/overworld (the folder), if it exists

3. Download the pack from our Github manually.

4. Place it in the same folder as before, */plugins/iris/packs/overworld

5. Unzip the folder

6. Rename the resulting folder to overworld

7. Follow the getting started tutorial as normal

Restart after downloading a pack

Since Iris uses datapacks for a lot of its biomes (for colors, sounds, etc.), we generate a datapack for each pack that is installed. Since datapacks need to already be installed upon server startup, while Iris is not ready by that time on the first install, Iris needs to reload the server. This is only needed once.

Iris uses Datapacks to make amazingly colored biomes such as the Sakura biome:

Which permission nodes does Iris offer?

The only permissions are iris.all & iris.studio and probably only YOU (the server owner) should have them.

Red logo on startup (Mac only)

Set in the settings.json Configuration -> General -> useConsoleCustomColors to false

Biomes larger / smaller

In this diagram, you see what settings affect biome sizes. To make biomes larger, you can increase the zoom on the region's specific biomes here, which will make the collection of biomes that are in a category larger. You can also change all biome & region sizes to be larger, this setting is found here.

Change object spawn chance

To reduce the number of times an object spawns in a single area, follow the following steps:

1. Find the name of the object by getting an Object Dust with /iris object dust and clicking the object. Remember this name, we need it in step 4.

2. Find the name of the biome by running /iris find

3. Open the configuration file for the biome by locating it in the */plugins/iris/packs/overworld/biomes folder. Each of the folders in there is for one region. The name of the region is included in the name of the biome. Open the biome file. (If you are in a studio world, you can use /iris studio editbiome to directly open the file)

4. Find the "objects" section, which looks similar to the following (more or fewer settings may be present)

"objects": [
    {
        "place": [
            "folder/subfolder/1",
            "folder/subfolder/2",
            "folder/subfolder/3"
        ],
        "chance": 0.1,
        "density": 2,
        "mode": "MIN_HEIGHT"
    }
]

In here, there are 2 options to take into account, chance and density.

Chance dictates the fractional chance of an object spawning per chunk, if it is 0.1, it has a 1 in 10 or 10% chance of spawning. You can decrease this number to decrease the number of times it spawns.

Density dictates the number of times the object spawns if the chance roll was successful. So, for example, if the 10% chance of the example is successful, there are going to be 2 objects of the objects included in the place list, in that chunk. You can decrease this number to see less clusters of objects spawning.

Another option is to remove one or more of the objects from the list under place, this will remove that object from the biome entirely. Note: Do not remove all objects from the list. Instead, set the chance to 0.

Disable Iris' Spawn System

You can disable the Iris spawn system in the config *\plugins\iris\settings.json and look for "ambientEntitySpawningSystem": true, and "markerEntitySpawningSystem": true, and set those to false

Support

We offer support on our Discord. Ask questions you cannot answer using the Wiki there. We ask you to look on the wiki for a solution for your issue before going there. Thank you for using Iris!

• The Volmit Software Team

我应在何时更新插件

更新 Iris 不同于其它插件, 对于原版世界来说 若您变更了服务端对应的 Minecraft版本 变更之后原版世界所加载的区块将不与已加载区块平滑衔接.

Iris 也可以生成世界, 所以它也有相同的问题 不同原版的是 Iris 缓解了该问题

开发者的话:

Generally its not possible to do something like that without ending up with hard borders / having to edit millions of chunks possibly. By changing the biome map, everything changes. Things that were a desert are now a forest. I could blend it by using an interpolator, but... ignoring the intense CPU [required for] that, it would still look terrible, because it would still look like a wall, just smoother, and the biomes would still be hard-cut. Just update when your ready to make a new map, its not a big issue 😛

一般来说，不可能将出现硬边界/不得不编辑数百万块的情况完全杜绝 世界内的一切事物都会随着生物群落地图的改变而改变 如, 原本为沙漠群系的区块现在变变成了森林群系 但我可以通过使用插值器来缓解该问题（区块平滑衔接） 可使用插值器后问题也仍然存在, 只是更为平滑, 缓解了这问题 所以, 在做好准备且创建新世界之前更新插件/服务端对应的Minecraft版本 并不会使该问题放大化 😛

所以, 我该何时更新插件?

您应仅在重建或新建世界时更新插件. 若想在其它情况下更新插件, 请先联系开发者

若您确定要更新 Iris, 见 Updating the Overworld.

如何改变 Iris 所生成世界的种子？

Iris 生成世界与原版不同, 所有由 Iris 所生成世界都拥有相同的种子 若想改变这个种子, 必须在服务器根目录内的server.properties内的level-seed=一行定义它 改变种子后不影响已生成世界

插件报错: Out of bounds

报错的可能原因:

1. 损坏的数据包

2. 所使用数据包已被修改

重新启动服务器

Atomic Cache Failure

请尝试以下步骤来解决这个问题（下列事项至少有80%的概率导致该问题）

1. 删除服务器文件夹所处路径的所有空格 如: C:/1234/Mine Craft/Server -> C:/1234/MineCraft/Server

2. 替换掉服务器文件夹所处路径的所有非ASCII字符（即中文、日文、韩文、俄文等）

3. 关闭服务器, 删除 服务器根目录/plugins/iris/packs 文件夹后启动服务器

若问题仍然存在, 请见下一标题（手动下载 OverWorld 配置包）.

手动下载 OverWorld 配置包

有时 Iris 出于某种原因要求您手动下载Overworld配置包 但这也需要遵循一些步骤:

1. 关闭服务器

2. 删除 服务器根目录/plugins/iris/packs/overworld 文件夹

3. 从 Gitlab 下载配置包（已压缩）

4. 将所下载压缩包放入 服务器根目录/plugins/iris/packs 文件夹内

5. 将压缩包解压至当前文件夹（/plugins/iris/packs）

6. 将解压缩所创建的文件夹更名为overworld

7. 查阅并遵循 起步教程（若已了解则跳过该步骤）

Pterodactyl 服务器崩溃 (内存) (修复于 1.19)

Pterodactyl以强制关闭正在运行的服务器而闻名 如在创建一个Iris世界或预加载一个世界时服务器突然崩溃 为了解决这个问题, 请将服务器启动文件(.bat)的所有文本替换为

-XX:+UnlockExperimentalVMOptions -XX:+UseG1GC -XX:G1HeapWastePercent=7 -XX:G1NewSizePercent=15 -XX:G1MaxNewSizePercent=40 -jar server.jar

若这行文本不工作, 则试试下面这行:

-XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -Dusing.aikars.flags=https://mcflags.emc.gs/ -Daikars.new.flags=true -Dterminal.jline=false -Dterminal.ansi=true -jar server.jar

成功下载配置包后重启服务器

这是由于与配置包有关的数据包需要重启服务器才能被应用, 数据包可制作许多东西 如下图所示的群系颜色（叶子是粉色的）:

使用数据包的目的是在加载 Iris 所生成世界的区块时能够呈现所有自定义颜色 如果你不希望在你的世界中使用这一功能，请删除配置包内的每个群系的Custom-Derivatives部分.

控制台内的红色图标（只有 Mac 系统才有该问题）

将 config.yml 内的 useConsoleCustomColors 设为 false

不兼容的插件

下列插件易导致插件无法正常运作:

• Region Manager

• Plugman

• Hotplug

• 其它世界生成器插件

• EWG / RWG

• Terralith (数据包方面)

卸载 Iris

有很多由 Iris 所控制的东西在你卸载该插件后会被破坏 这些功能可能导致原版生存出现问题, 所以强烈建议保留 Iris 而不使用

可能导致的问题:

• 无法使用末影之眼找到地牢: Iris可控制所生成世界可生成多少个地牢结构以及地牢之间的距离 因为 Iris 不遵循与原版相同的生成器, 所以若卸载 Iris, 末影之眼将指向不存在任何结构的地方

• 不生成生物: Iris 所生成世界拥有不同于原版的生物生成机制 在结构生成后随之生成的实体（如远古守卫者与蠹虫）不会在结构内再次生成

• 所加载区块的群系为原版: Iris 所生成世界的每个区块原本应为自定义群系 但由于 Iris 被卸载, 自定义群系的生成器变回了原版生成器 导致新加载区块为原版群系

• 环境氛围粒子与音效的消失: 环境氛围粒子与自定义群系挂钩, 而自定义群系需要 Iris 才能工作.

• 自定义树叶腐烂系统: Iris 可控制所生成树叶的腐烂机制, 使其能离木头更远而不腐烂.

• 自定义世界高度: Iris 可令所生成世界突破原版的高度限制.

• World Shifting: 令所生成世界内的已加载区块分裂为多个区块, 这有点崩坏的感觉.

群系缩放

在这张图中，你可以看到哪些设置会影响群落的大小, 为了使生物群落变大 你可以在这里增加区域内的特定群落的缩放, 这将使整个群系变大 你也可以直接扩大所有的生物群落和区域的大小, 见here.

降低物体的生成几率

遵循下列步骤以降低指定物体被生成的几率:

1. 查询物体名称: 通过执行 /iris object dust 并点击一个物体, 记住该物体的内部名

2. 查询物体所处群系: 执行 /iris find

3. 编辑该群系的配置文件: 它位于 服务器根目录/plugins/iris/packs/overworld/biomes 文件夹 文件夹内的每个文件夹对应每一个区域, 而每个区域文件夹内又有对应的群系配置文件 若处在工作室模式, 则可通过执行 /iris studio editbiome 以直接编辑该群系的配置文件

4. 找到 "objects" 语段, 格式与下列文本相似 (子选项数量可能有所不同)

"objects": [
    {
        "place": [
            "folder/subfolder/1",
            "folder/subfolder/2",
            "folder/subfolder/3"
        ],
        "chance": 0.1,
        "density": 2,
        "mode": "MIN_HEIGHT"
    }
]

, chance and density.

Chance dictates the fractional chance of an object spawning per chunk, if it is 0.1, it has a 1 in 10 or 10% chance of spawning. You can decrease this number to decrease the number of times it spawns.

Density dictates the number of times the object spawns if the chance roll was successful. So, for example, if the 10% chance of the example is successful, there are going to be 2 objects of the objects included in the place list, in that chunk. You can decrease this number to see less clusters of objects spawning.

Another option is to remove one or more of the objects from the list under place, this will remove that object from the biome entirely. Note: Do not remove all objects from the list. Instead, set the chance to 0.

Support

We offer support on our Discord. Ask questions you cannot answer using the Wiki there. We ask you to look on the wiki for a solution for your issue before going there. Thank you for using Iris!

• The Volmit Software Team

Hot Desert Dunes Red

Name: Hot Desert Dunes Red Vanilla Derivative: besert ID: null File Location: \overworld\biomes\hot\desert-dunes-red.json Category: unknown

Hot Desert Dunes

Name: Hot Desert Dunes Vanilla Derivative: besert ID: null File Location: \overworld\biomes\hot\desert-dunes.json Category: unknown

Hot Mountain Cliffs

Name: Hot Mountain Cliffs Vanilla Derivative: besert ID: null File Location: \overworld\biomes\hot\mountain-cliffs.json Category: unknown

Hot Mountain Middle

Name: Hot Mountain Middle Vanilla Derivative: besert ID: null File Location: \overworld\biomes\hot\mountain-middle.json Category: unknown

Hot Mountain Plains

Name: Hot Mountain Plains Vanilla Derivative: besert ID: null File Location: \overworld\biomes\hot\mountain-plains.json Category: unknown

Hot Mountains

Name: Hot Mountain Plains Vanilla Derivative: besert ID: null File Location: \overworld\biomes\hot\mountain.json Category: unknown

Hot Oasis

Name: Hot Oasis Vanilla Derivative: besert ID: null File Location: \overworld\biomes\hot\oasis.json Category: unknown

Hot Beach

Name: Hot Beach ID: hot_beach File Location: \overworld\biomes\hot\beach.json Category: beach

Hot Beach Grass

Name: Hot Beach Grass Vanilla Derivative: besert ID: null File Location: \overworld\biomes\hot\beach-grass.json Category: unknown

Hot Ocean Cliffs

Name: Hot Ocean Cliffs Vanilla Derivative: ocean ID: null File Location: \overworld\biomes\hot\ocean-cliffs.json Category: unknown

Hot Ocean

Hot river

Name: Hot river Vanilla Derivative: besert ID: null File Location: \overworld\biomes\hot\river.json Category: unknown

Adding items from MMOItems is simple. In your loot tables (or other places where you can put items, such as as equipment of mobs), if you want to add an MMOItems item which has type "sword" and name "excalibur", write mmoitems_sword:excalibur in the place where you would otherwise write minecraft:diamond_sword.

If you are using the Iris VSCode Workspace the autocompletions (ctrl + space) will include the items as well.