1 of 1

插件配置

Iris 本体配置

若定义为 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
    }
}

修改选项保存后无需重载, Iris拥有热加载配置的功能.

与预加载有关的选项不会热加载

整体（"generaal:"）

整体选项影响 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

插件信息的字体颜色梯度

世界（"world:"）

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

仅作用于 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 则启用环境氛围粒子（如沙漠会有小型烟雾粒子）

GUI（"gui:"）

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

选项名

描述

useServerLaunchedGuis:

maximumPregenGuiFPS

若定义为 true 则令GUI看上去更为华丽, 但性能开销更大

世界生成（"generator:"）

世界生成的一些关键设置

选项名

描述

defaultWorldType

若执行生成世界命令时尚未定义 type=

则使用该选项所定义的配置包以生成世界

maxBiomeChildDepth

一个自定义群系所能拥有的子群系数量

preventLeafDecay

若定义为 true 则树叶不会自然腐烂

调用线程（"concurrency:"）

选项名

描述

parallelism

决定 Iris 可调用多少服务器线程

工作室（"studio:"）

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

选项名

描述

studio

若定义为 true 则启用工作室模式

openVSCode

若定义为 true 则在进入工作室模式后

启动VS Code

disableTimeAndWeather

若定义为 true 则在进入工作室模式后

禁用昼夜循环与天气更新

autoStartDefaultStudio

若定义为 true 则在服务器启动后

自动启用工作室模式

缓存预加载（"Performance:"）

用于缓存预加载的设定

选项名

描述

trimMantleInStudio

若定义为 true 则启用 Mantle 模式该模式下您无法编辑与实体有关的事项但性能更好

mantleKeepAliveSeconds

Mantle 模式下的缓存将被保存多久（秒）

cacheSize

每个数据最多可以使用的缓存

resourceLoaderCacheSize

修改任何非物体、非对象的配置文件的缓存大小

objectLoaderCacheSize

修改物体的缓存大小

scriptLoaderCacheSize

修改脚本的缓存大小

插件配置

Iris 本体配置

若定义为 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
    }
}

修改选项保存后无需重载, Iris拥有热加载配置的功能.

与预加载有关的选项不会热加载

整体（"generaal:"）

整体选项影响 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

插件信息的字体颜色梯度

世界（"world:"）

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

仅作用于 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 则启用环境氛围粒子（如沙漠会有小型烟雾粒子）

GUI（"gui:"）

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

选项名

描述

useServerLaunchedGuis:

若定义为 true 则在时弹出进度GUI

maximumPregenGuiFPS

若定义为 true 则令GUI看上去更为华丽, 但性能开销更大

世界生成（"generator:"）

世界生成的一些关键设置

选项名

描述

defaultWorldType

若执行生成世界命令时尚未定义 type=

则使用该选项所定义的配置包以生成世界

maxBiomeChildDepth

一个自定义群系所能拥有的子群系数量

preventLeafDecay

若定义为 true 则树叶不会自然腐烂

调用线程（"concurrency:"）

选项名

描述

parallelism

决定 Iris 可调用多少服务器线程

工作室（"studio:"）

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

选项名

描述

studio

若定义为 true 则启用工作室模式

openVSCode

若定义为 true 则在进入工作室模式后

启动VS Code

disableTimeAndWeather

若定义为 true 则在进入工作室模式后

禁用昼夜循环与天气更新

autoStartDefaultStudio

若定义为 true 则在服务器启动后

自动启用工作室模式

缓存预加载（"Performance:"）

用于缓存预加载的设定

选项名

描述

trimMantleInStudio

若定义为 true 则启用 Mantle 模式该模式下您无法编辑与实体有关的事项但性能更好

mantleKeepAliveSeconds

Mantle 模式下的缓存将被保存多久（秒）

cacheSize

每个数据最多可以使用的缓存

resourceLoaderCacheSize

修改任何非物体、非对象的配置文件的缓存大小

objectLoaderCacheSize

修改物体的缓存大小

scriptLoaderCacheSize

修改脚本的缓存大小