将酒杯变成实用装备：可在其中储存蜂蜜酒，使用时饮用储存的蜂蜜酒，支持移动中饮用，并可调整动画速度、冷却缩减、增益持续时间、耐久度、配方，以及通过ServerSync支持ValheimCuisine的王者之杯。

实用酒杯

将酒杯转化为实用的冒险装备。它们可以储存和盛放蜂蜜酒，调整饮酒动作和动画速度，提供效果加成，具有耐久度，并开放服务器同步的配方和游戏设置。同时支持 ValheimCuisine 的王者高脚杯。

从酒杯中饮酒时无需站立不动。移动和饮酒速度均可配置。

更好的酒杯可以延长增益持续时间并缩短药水冷却时间。

大酒杯默认无法修复，因此矮人酒杯尤为珍贵。如果你的配置提供了有效的修复途径，可以为每个大酒杯启用可修复性。

酒杯自带蜜酒储存功能，其工具提示会同时显示酒杯加成和储存的蜜酒。

模组蜜酒也可以储存。ValheimCuisine的国王高脚杯会被自动检测并配置。

当储存的蜂蜜酒当前可用时，酒馆可以直接从储存中饮用。如果你想调整自定义蜂蜜酒效果的持续时间，请使用数据锻造。 https://thunderstore.io/c/valheim/p/sighsorry/DataForge/

新增内容

• 大酒杯可小容量存放蜂蜜酒，存放的物品计入重量和提示信息，并可直接饮用存放的可用蜂蜜酒。
• 饮用时的移动和饮用动画速度可配置。
• 纯恢复类持续效果可缩短冷却时间；其他时效性效果可延长持续时间。
• 可配置的耐久度和可修复性使啤酒杯可作为有限次使用的饮用工具。
• 酒杯和周年纪念酒杯的配方可配置，安装 ValheimCuisine 后支持其国王高脚杯。
• 服务器同步功能可确保专用服务器上的游戏性相关设置保持一致。

酒杯进阶

每种支持的酒杯都有各自的设置，包括耐久度、可修复性、药水冷却缩减、增益持续时间加成以及存储槽位。

• 酒杯：小型存储空间和适度的加成。
• 酒杯周年庆：比基础酒杯更强。
• 矮人酒杯：最强大的原味酒杯造型。
• VC_GoK：在安装了 ValheimCuisine 时受支持，使用 Dvergr 配置文件的默认值。

仓库

在物品栏中悬停于酒杯上时按下交互键，即可打开其内部存储空间。只有带有消耗状态效果的可饮用消耗品才能放入其中。存储的蜂蜜酒会在发生变化时自动保存，因此提示内容、掉落的酒杯以及物品重量都会保持同步。

存储加载时会校验每个已保存物品的身份、数量和元数据，通过后才允许访问。如果恢复过程改变了这些数据，酒杯将保留其原始存储数据，并拒绝打开或消耗其中的内容。打开它会显示一条警告；日志会指明存在差异的字段。由其他模组执行的元数据迁移也可能触发此保护机制，需要排查后才能使用该存储。

当使用酒杯时，UsefulTankards会检查储存的蜂蜜酒，并饮用当前可消耗的任何一种。食物规则、药水类别和激活的状态效果类别均会被遵循。

安装EpicLoot的镶嵌界面后，使用会先打开酒杯存储，之后EpicLoot才会消耗输入。按住EpicLoot配置的 插槽覆盖修改器 （通常为左Alt键）配合“使用”键可将输入交还给其插槽UI。EpicLoot确认提示会保留控制权，而从插槽切换到酒杯存储时，会先关闭并保存插槽UI。请保留NewtonsoftJsonDetector的安装；它是EpicLoot的必需依赖项。此可选集成针对EpicLoot 0.14.5中的UI契约；契约变更或缺失会在启动时产生一次警告，并将“使用”输入留给EpicLoot处理。

药水与增益加成

UsefulTankards 会在施加酒杯加成之前对每个限时状态效果进行分类。

• 纯粹的持续恢复效果会随时间恢复生命值、体力或灵能，且不附带任何额外的限时属性修正。它被视为药剂类效果，并可获得冷却缩减。
• 其他所有限时效果改为获得增益持续时间加成。这包括将随时间恢复与另一项修正结合的混合效果。

这使得大酒杯有用，又不会让每种饮品都变成同一种加成。

配置

配置默认通过服务器同步。

通用选项包括：

• 饮酒时移动0 保持原版移动锁定，1 允许正常移动，介于两者之间的值允许部分移动。
• 酒杯动画速度1 保持原版速度，2 是两倍速，3 是三倍速。

每杯可选：

• 耐久度
• 可修复性
• 药水冷却缩减
• 增益持续时间加成
• 储物格（超过五的值会将矩形网格向上取整到五的下一个倍数）

以下内容的配方选项可用：

• 酒杯
• 酒馆周年庆

兼容性

UsefulTankards 的设计宗旨是保持轻量且由配置驱动。ValheimCuisine 的 VC_GoK 安装 ValheimCuisine 后会自动检测。

本地化

UsefulTankards 包含用于酒杯存储提示和酒杯加成文本的英文与韩文提示文本。选择任何其他语言时都会回退到英文。

正在构建并检查更改

此源目标为英灵神殿 1.0.7. 酒杯存放可容纳游戏的 v109 物品栏格式。较旧的嵌入式酒馆数据（包括v100–106）、不支持的未来格式以及不完整的加载内容会原样保留，但无法打开或使用。本模组不会迁移这些数据；游戏自身的角色/世界加载不受影响。

使用 .NET SDK、.NET Framework 4.8 开发者包以及包含 BepInEx 和原始未修改的游戏程序集的 Valheim 1.0.7 安装进行构建：

dotnet build UsefulTankards.csproj -c Debug -p:DeployToGame=true

游戏路径 提供默认依赖路径； BepInEx路径 和 核心库路径 也可以单独覆盖。编译和ILRepack使用原始游戏程序集。在成功进行调试构建和ServerSync合并后， 部署到游戏=true 仅将最终的模组DLL复制到本地瓦尔海姆 BepInEx/plugins 文件夹。使用 部署到游戏=false 跳过复制，或 部署到游戏目录 选择其他插件文件夹。调试版本不会生成发布包。发布版本会合并 ServerSync 并重新生成 Thunderstore 清单和 ZIP。捆绑的 ServerSync 构建文档见 库/自述文件.md.

使用 .NET 8 SDK 或兼容的更高版本 SDK 运行存储回归检查：

dotnet run --project Tests/StorageRegression.csproj

这些检查使用小型游戏测试替身来编译生产存储代码。它们不能替代 Valheim、Harmony 或多人游戏测试。参见 测试/README.md 在源代码检出中进行覆盖率检查，其余在游戏内检查。