Iris configuration files
This configuration is small because all world configuration is done in Packs.
We have introduced a hot-loading feature for these settings, meaning they should automatically update in the server.
Updating settings related to Pregeneration are not hot-loaded during pregeneration!
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.
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)
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. 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.
Файлы конфигурации (настройки) Iris
Конфигурация (настройка) самого Iris небольшая, поскольку все настройки мира выполняются в паках (более подробная информация здесь).
Мы ввели функцию горячей загрузки для этих настроек, то есть они должны автоматически обновляться на сервере.
Обновления настроек, связанных с Прегенерацией, не загружаются во время прегенерации!
Это общие настройки, которые необходимо поменять для изменения основных функций программы.
commandSounds: Если включена, воспроизводит звуки при использовании команд.
debug: При значении true включает экстремальный по объему поток информации о внутренней работе Iris. Отлично подходит для отладки конкретной проблемы, жутко не удобен для чтения.
disableNMS: При включении отключает использование NMS. Мы используем NMS (исходный код Minecraft) для получения информации о биомах, регистрации пользовательских имен биомов, регистрации tile entities и многого другого. Установка этого параметра в true отключит все эти системы, но может вызвать множество проблем. Лучше не трогать.
pluginMetrics: Это переключение метрик плагина для bstats. Это помогает нам узнать, что люди используют, чтобы мы могли улучшить плагин. Вся информация анонимна. Пожалуйста, не выключайте это :)
splashLogoStartup: Выводит причудливый логотип Iris при запуске, если он включен.
useConsoleCustomColors: Использование пользовательских цветов в консоли.
useCustomColorsIngame: Использование пользовательских цветов в игре.
forceMainWorld: Принудительно помещает датапаки в другую папку. Лучше всего оставить пустым.
spinh & spins & spinb: Они задают градиенты цветов в консоли и в игре.
Это простая настройка для переключения всплывающих графических интерфейсов 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 кэширует много данных во время генерации. Это экономит много времени во время генерации, но занимает немного дополнительной памяти. Это кэш, который каждый отдельный поток данных может использовать максимально. Это число было сгенерировано с помощью функции оптимизации, изменять его не рекомендуется.
קבצי תצורה של אייריס
התצורה של איירס עצמה קטנה מכיוון שכל תצורת העולם נעשית בחבילות (עוד מידע כאן)
הוספנו תכונת טעינה "חמה" עבור הגדרות אלה, כלומר הן אמורות להתעדכן אוטומטית בשרת.
עדכון הגדרות הקשורות ל-פריג'ן אינן מתעדכנות אוטומטית במהלך ה-פריג'ן!
אלו הן ההגדרות הכלליות שתצטרכו לשנות בשביל לעדכן פונקציונליות הליבה של התוכנה.
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)
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.
Archivos de configuración
La configuración de Iris no es muy externa ya que la configuración está hecha mayormente por los Packs.
Hemos añadido configuración "hot-loading" para estos ajustes, esto significa que deberían actualizarse en el servidor automaticamente.
Actualizar los ajustes relacionados a la Pregeneración no son "hot-loaded" mientras se haga la pregeneración.
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.
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 本体配置
若定义为 true
, 则本体配置相较于世界生成器配置简单的
修改选项保存后无需重载, Iris拥有热加载配置的功能.
与 预加载 有关的选项不会热加载
整体选项影响 Iris 本体的运作
commandSounds
若定义为 true, 则在执行命令后
发送音效给执行者
debug
若定义为 true
, 则提示调试信息
(简单理解为 Iris 运作的详细信息).
disableNMS
若定义为 true
, 则禁用 NMS
Iris 使用 NMS (原版服务端内容)
以获取群系信息并注册群
禁用 NMS 后将禁用这些系统
但会导致一些漏洞
pluginMetrics
若定义为 true
, 则将服务端所使用插件
记录给开发者, 记录是匿名的, 无需担心隐私
splashLogoStartup
若定义为 true
, 则在服务器启动时在控制台内生成 Iris 的图标
useConsoleCustomColors
若定义为 true
, 控制台内的 Iris 插件信息
都将拥有字体颜色
useCustomColorsIngame
若定义为 true
, 聊天栏内的 Iris 插件信息
都将拥有字体颜色
forceMainWorld
若定义为 true
, 则将指定配置包的数据包
放入另一文件夹内, 建议放空
spinh & spins & spinb
插件信息的字体颜色梯度
配置一些与世界有关的内容
仅作用于 Iris 所生成的世界
asyncTeleport
若将enable定义为 true
则将玩家进入 Iris 所生成世界与进入时预加载区块 的线程模式
设为异步处理, 若将urgent定义为 true
,会令 Iris 更快处理这件事
loadViewDistance 表预加载范围的半径(格方块)
postLoadBlockUpdates
若定义为 true
则 Iris 在生成世界时异步加载区块
反之同时加载一切应加载的区块
forcePersistEntities
若定义为 true
则所生成实体不会消失且保持活动
反之遵循配置包内的生物生成配置
anbientEntitySpawningSystem
若定义为 true
则在玩家周围生成生物
asyncTickIntervalMS
尝试生成实体的间隔, 单位: 刻
targetSpawnEntitiesPerChunk
调整每个区块内应生成的实体数量
如定义为 0.7
表示无论该世界会生成多少实体
数量都仅为应生成实体数量的70%
markerEntitySpawningSystem
若定义为 true
则按照配置包, 在已标记位置生成实体
effectSystem
若定义为 true
则启用环境氛围粒子(如沙漠会有小型烟雾粒子)
定义 Iris 与 GUI界面 有关的内容
useServerLaunchedGuis:
maximumPregenGuiFPS
若定义为 true
则令GUI看上去更为华丽, 但性能开销更大
世界生成的一些关键设置
defaultWorldType
若执行生成世界命令时尚未定义 type=
则使用该选项所定义的配置包以生成世界
maxBiomeChildDepth
一个自定义群系所能拥有的子群系数量
preventLeafDecay
若定义为 true
则树叶不会自然腐烂
parallelism
决定 Iris 可调用多少服务器线程
工作室模式用于在本地服务器内设计世界.
studio
若定义为 true
则启用工作室模式
openVSCode
若定义为 true
则在进入工作室模式后
启动VS Code
disableTimeAndWeather
若定义为 true
则在进入工作室模式后
禁用昼夜循环与天气更新
autoStartDefaultStudio
若定义为 true
则在服务器启动后
自动启用工作室模式
用于缓存预加载的设定
trimMantleInStudio
若定义为 true
则启用 Mantle 模式
该模式下您无法编辑与实体有关的事项
但性能更好
mantleKeepAliveSeconds
Mantle 模式下的缓存将被保存多久(秒)
cacheSize
每个数据最多可以使用的缓存
resourceLoaderCacheSize
修改任何非物体、非对象的配置文件的缓存大小
objectLoaderCacheSize
修改物体的缓存大小
scriptLoaderCacheSize
修改脚本的缓存大小
若定义为 true
则在 时弹出进度GUI