WDMla 插件配置（plugins.cfg）

基本信息

属性 值
配置文件 config/WDMla/plugins.cfg
声明类 com.gtnewhorizons.wdmla.config.PluginsConfig
配置框架 GTNHLib @Config
顶层分类 plugins
子目录 WDMla
语言键 option.wdmla.plugin.category
注册时机 WDMla 类静态初始化块，ConfigurationManager.registerConfig(PluginsConfig.class)（WDMla.java:36-37）
分组数 5（core / universal / vanilla / harvestability / debug，PluginsConfig.java:16-24）

功能

存放所有内置插件自身的细粒度开关与阈值。插件的启用/禁用与优先级不在本文件，而是由反射生成到 plugins_autogen.cfg（见 自动生成配置）。类注释明确了这一分工，并写明无法按插件拆分文件是 GTNHLib 的限制（PluginsConfig.java:8-10）。

harvestability 一组的两个 harvestLevelN 表把「挖掘等级」映射到 Tinkers’ Construct / IguanaTweaks 的有效镐材料 ID，范围 1–100（@Config.RangeInt(min = 1, max = 100)）。IguanaTweaks 表的注释写明「若该 mod 已加载则覆盖 TiC 配置」（PluginsConfig.java:266-267）。

数值

core（plugins.core）

core.defaultblock：

字段 默认值 语义
showicon true（PluginsConfig.java:35-37） 显示方块图标
showblockname true（PluginsConfig.java:39-41） 显示方块名
showmodname true（PluginsConfig.java:43-45） 显示所属模组名
fancyrenderer ALL（PluginsConfig.java:47-51） NONE 恒用假 ItemStack；ALL 恒渲染 3D 方块；FALLBACK 仅在方块无 Item 变体时渲染 3D
rendererrotationspeed 1，范围 1–10000（PluginsConfig.java:53-56） 3D 渲染旋转速度

fancyRendererMode 枚举：NONE / FALLBACK / ALL（PluginsConfig.java:93-97）。

core.defaultentity：

字段 默认值
showentity true（PluginsConfig.java:62-64）
showentityname true（PluginsConfig.java:66-68）
showmodname true（PluginsConfig.java:70-72）
fancyrenderer true（PluginsConfig.java:74-76）
rendererrotationspeed 1，范围 1–10000（PluginsConfig.java:78-81）
iconautoscale true（PluginsConfig.java:83-85）
icondefaultscale 1.2f，范围 0.1f–100f（PluginsConfig.java:87-90）

注意：core.defaultentity.showmodname 与 core.defaultblock.showmodname 共用语言键 option.wdmla.core.show.modname；rendererrotationspeed 在两处也共用语言键 option.wdmla.core.renderer.rotation.speed（PluginsConfig.java:43-45 与 70-72、53-56 与 78-81）。二者是不同的字段、不同的 config key，仅显示名相同。

universal（plugins.universal）

universal.itemstorage：

字段 默认值 范围
normalamount 9（PluginsConfig.java:110-113） 0–10000
detailedamount 54（PluginsConfig.java:115-118） 0–10000
itemsperline 9（PluginsConfig.java:120-123） 0–10000
shownameamount 4（PluginsConfig.java:125-128） 0–10000

universal.fluidstorage：

字段 默认值
mode GAUGE（PluginsConfig.java:134-136）
normalamount 4，范围 0–10000（PluginsConfig.java:138-141）
detailed false（PluginsConfig.java:143-145）

mode 枚举：GAUGE / ICON_TEXT / TEXT（PluginsConfig.java:147-151）。

universal.energystorage 是一个空分类，函数体只有一行注释 // reserved（PluginsConfig.java:154-157）。这是源码里显式标注的预留位，不是遗漏实现。

vanilla（plugins.vanilla）

分类 字段 默认值
redstonestate showleverstate true（PluginsConfig.java:171-173）
redstonestate showrepeaterdelay true（PluginsConfig.java:175-177）
redstonestate showcomparatormode true（PluginsConfig.java:179-181）
pet showpetsit true（PluginsConfig.java:187-189）
pet showpetowner true（PluginsConfig.java:191-193）
animal showanimalgrowth true（PluginsConfig.java:199-201）
animal showbreedcooldown true（PluginsConfig.java:203-205）
commandblock maxcommandlength 40，范围 0–10000（PluginsConfig.java:211-214）

harvestability（plugins.harvestability）

icon 组（PluginsConfig.java:322-374）：

字段 默认值 语义
currentlyharvestableicon true 显示「当前可采集」图标行
currentlyharvestablestring "✔" 可采集时图标下的字符串
notcurrentlyharvestablestring "✕" 不可采集时图标下的字符串
shearabilityitem minecraft:shears 剪取图标所用物品
silktouchabilityitem minecraft:grass 精准采集图标所用物品
effectivetoolicon true 与「当前可采集」并列显示有效工具图标
showshearabilityicon true 手持对应工具时显示剪取图标
showsilktouchabilityicon true 手持对应工具时显示精准采集图标
coloriconwitheffectiveness false 按手持工具有效度给图标着色
alwaysshowadditionaltools false 即使未手持也显示剪取/精准采集图标

text 组（PluginsConfig.java:376-398）：harvestlevelnum、harvestlevelname、effectivetoolline、currentlyharvestableline，四项默认全为 false。

condition 组（PluginsConfig.java:400-422）：oresonly、textdetailsonly、unharvestableonly、toolrequiredonly，四项默认全为 false——即默认对所有方块显示采集信息。

tinkersconstruct 组（PluginsConfig.java:233-264）与 iguanatweaks 组（PluginsConfig.java:269-320）：

等级 TiC 默认 ID TiC 材料注释 IT 默认 ID IT 材料注释
0 0 wood 0 wood
1 1 stone 13 copper
2 2 iron 2 iron
3 6 obsidian 14 tin
4 10 cobalt 16 redstone
5 12 manyullyn 6 obsidian
6 — — 11 ardite
7 — — 10 cobalt
8 — — 12 manyullyn
9 — — 12 manyullynplus

TiC 表只有 6 项（PluginsConfig.java:238-263），IT 表 10 项（PluginsConfig.java:274-319）。读取点分别为 ProxyTinkersConstruct.java:58-63 与 ProxyIguanaTweaks.java:41-50。

debug（plugins.debug）

字段 默认值 语义
entityregistrydata false（PluginsConfig.java:433-435） 实体上显示注册表数据
displaymode SHORT（PluginsConfig.java:437-439） 取值为 RegistryDataProvider.DisplayMode

交互

本文件由 GTNHLib 接管，不在 WDMlaConfig 的自动保存路径内；游戏内修改经 WDMla 通用配置界面 的 general / plugins 分类完成。改动生效时机取决于字段：overrideWailaTooltips 明确要求重启（General.java:64），其余在 ConfigChangedEvent 后重排并重载（ClientProxy.java:74-84）。

相关条目