Configuration
Iris configuration files
Configuration for Iris itself is small because all world configuration is done in Packs (more info here)
1
{
2
"general": {
3
"commandSounds": true,
4
"debug": false,
5
"disableNMS": false,
6
"pluginMetrics": true,
7
"splashLogoStartup": true,
8
"useConsoleCustomColors": true,
9
"useCustomColorsIngame": true,
10
"forceMainWorld": "",
11
"spinh": -20,
12
"spins": 7,
13
"spinb": 8
14
},
15
"gui": {
16
"useServerLaunchedGuis": true,
17
"maximumPregenGuiFPS": false
18
},
19
"generator": {
20
"defaultWorldType": "overworld",
21
"headlessPregeneration": false,
22
"maxBiomeChildDepth": 4,
23
"preventLeafDecay": true
24
},
25
"concurrency": {
26
"parallelism": -1
27
},
28
"studio": {
29
"studio": true,
30
"openVSCode": true,
31
"disableTimeAndWeather": true,
32
"autoStartDefaultStudio": false
33
},
34
"performance": {
35
"mantleKeepAliveSeconds": 60,
36
"cacheSize": 131072
37
}
38
}
39
Copied!
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!

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.

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 running /iris create
  • headlessPregeneration: When true, enables an Experimental (mostly stable) system of generating that will strongly increase the rate of Pregeneration.
  • 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.
  • 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.
Last modified 1mo ago