插件配置

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	修改脚本的缓存大小