Configuration

基本信息

属性	值
类型	配置文件 + 网络同步
触发条件	玩家登录时（`PlayerLoggedInEvent`）

行为

Ztones 配置文件从 event.getSuggestedConfigurationFile() 加载（ModConfiguration.synchronizeConfiguration(File)），由 CommonProxy.preInitialize 在 mod preInit 阶段调用。

所有配置节（基于 Configuration）：

`blocks` 节

每个 ZtoneType 一条 enable<Name>（除 Tile 始终开启外），用于单独启用/禁用某个 Ztone 变体方块的注册。

`general` 节

键	默认值	说明
`enableVariantCycling`	true	是否允许服务端通过 Ctrl + 滚轮循环切换 Ztone 变体（`isVariantCyclingEnabled`）
`enableVariantCrafting`	true	是否注册 Ofanix 的 16 个变体精确合成配方（`isVariantCraftingEnabled`）
`enableChiselIntegration`	true	是否注册 Chisel 雕刻配方（`isChiselIntegrationEnabled`）
`chiselCarvingMode`	1 (0–1)	`0` = 在 Tile 上雕出 33 种 Ztone 类型；`1` = 在各类型内雕出 16 个变体
`enableCreatureSpawnOnZtones`	false	是否允许敌对/友好生物在 Ztone 方块上生成（默认 false，阻止刷怪）

`items` 节

键	默认值	说明
`Mini Coal`	true	是否注册 MiniCoalItem
`Mini Charcoal`	true	是否注册 MiniCharcoalItem
`MSG Pill`	true	是否注册 HungerPillItem
`Diamond Zane`	true	是否注册 DiamondZaneItem
`Splat Axe`	true	是否注册 SplatAxeItem
`Terrain Eater`	true	是否注册 TerrainEaterItem
`Totem Tool`	true	是否注册 TotemToolItem
`Ofanix`	true	是否注册 OfanixItem

`tweaks` 节

键	默认值	说明
`enableChestGen`	true	是否将 Ztones 工具添加到地牢/村庄战利品箱（`isChestLootGenerationEnabled`）

网络同步

Ztones.updateConfiguration(PlayerLoggedInEvent) → ModNetwork.updateConfiguration(EntityPlayerMP) → 发送 ConfigurationUpdateMessage(isVariantCyclingEnabled) 到客户端 → ClientProxy.setVariantCyclingEnabled 更新本地缓存（isVariantCyclingEnabledByServer），影响 ClientProxy.processMouseEvent。

数值

数值名	默认值
`isVariantCyclingEnabled`	true
`isVariantCraftingEnabled`	true
`isChiselIntegrationEnabled`	true
`chiselCarvingMode`	1
`isCreatureSpawnOnZtonesEnabled`	false
`isMiniCoalEnabled`	true
`isMiniCharcoalEnabled`	true
`isHungerPillEnabled`	true
`isDiamondZaneEnabled`	true
`isSplatAxeEnabled`	true
`isTerrainEaterEnabled`	true
`isTotemToolEnabled`	true
`isOfanixEnabled`	true
`isChestLootGenerationEnabled`	true

Configuration

基本信息

行为

blocks 节

general 节

items 节

tweaks 节

网络同步

数值

相关条目

`blocks` 节

`general` 节

`items` 节

`tweaks` 节