玛莎拉 UI

[size=5][b]Marsarah UI[/b][/size]

[b]版本：[/b] 1.1.0
[b]作者：[/b] Marsarah

[line]

[size=5][b]🧰 关于本模组[/b][/size]

Marsarah UI 是一套独立的 Valheim 界面与信息改进模组合集。
这些功能最初是 [b]Marsarah Tweaks[/b] 的界面部分，现在已分离为独立模组，让玩家无需安装玩法调整即可使用界面改进。

本模组添加了实用的 HUD 信息、改进的姓名板和物品指示器、详细的物体悬停信息、更好的加载提示、天气信息以及其他界面改进。大多数功能均可独立配置。

Marsarah UI 还为部分面向玩法/信息的界面功能提供了 [b]ServerSync[/b] 支持。本地界面偏好默认保留在本地，而服务器管理员可以选择性覆盖部分设置。

[line]

[size=4][b]开发说明[/b][/size]

[b]Deep North / 剧透说明：[/b] 目前刻意限制了对 Deep North 专属界面的集成。
我希望先亲自体验新生物群系及其进程，然后再深入研究其机制细节，这样我就能在不给自己剧透的情况下通关。
在完成 Deep North 后，我计划审查新装备以更新 Smart Biome，并检查是否有新的机制适合添加额外的指示器或悬停信息。

[b]AI 使用披露：[/b] 最初的界面功能是作为 MarsarahMod / Marsarah Tweaks 项目的一部分开发的。现在我在开发流程中使用 AI 工具来执行调试、重构、兼容性更新、研究游戏 API 变更以及文档编写等任务。
开发仍然由人工主导：我决定要添加哪些功能、它们应该如何表现，并且由我编写代码、审查和测试发布版本中包含的更改。本模组的标志也是使用生成式 AI 创建的。

[size=4][b]相关 Marsarah 模组[/b][/size]

- [url=https://www.nexusmods.com/valheim/mods/3022][b]MarsarahTweaks[/b][/url] - 玩法、平衡、减少刷取和便利性调整。Marsarah UI 包含与部分 Tweaks 功能的可选兼容。
- [url=https://www.nexusmods.com/valheim/mods/3713][b]MarsarahBuildPieces[/b][/url] - 自定义功能性和装饰性建筑部件，包括传送门、灯光和 Mystical Light Ward。
- 使用 Marsarah UI 不需要以上任何一个模组。

[line]

[size=5][b]🔒 权限[/b][/size]

重新上传本模组，无论是部分还是完整，[b]均不被允许[/b]。
任何人都可以自由借鉴灵感或实现类似功能，但必须使用自己的代码和资源。

[line]

[size=5][b]🧱 需求[/b][/size]

本模组需要 [b]BepInEx for Valheim[/b]，可在此获取：
[url=https://valheim.thunderstore.io/package/denikson/BepInExPack_Valheim/]BepInExPack_Valheim[/url]

对于使用 Marsarah UI 服务器覆盖功能的多人服务器，请在[b]服务器[/b]和[b]所有客户端[/b]上安装本模组。

[line]

[size=5][b]📦 安装[/b][/size]

1. 解压 [i].zip[/i] 文件。
2. 将 [i]MarsarahUI.dll[/i] 复制到你的 [i]Valheim/BepInEx/plugins[/i] 文件夹中。

或使用模组管理器。

如果服务器使用 Marsarah UI 服务器覆盖，则服务器和所有连接的客户端也必须安装本模组。

[line]

[size=5][b]⚙️ 配置[/b][/size]

首次启动时会生成配置文件：
[i]Valheim/BepInEx/config/Marsarah.MarsarahUI.cfg[/i]

设置分为五个类别：

- [b]01 - General & HUD (Local)：[/b] 通用界面和 HUD 功能。
- [b]02 - Information Rail (Local)：[/b] Information Rail 的外观、内容及相关显示。
- [b]03 - Items & Interaction (Local)：[/b] 建造菜单信息、姓名板、驯服和物品指示器。
- [b]04 - Detailed Hovers (Local)：[/b] 详细的物体悬停信息和显示模式。
- [b]05 - Server Overrides (Synced)：[/b] 针对部分面向信息功能的可选服务器控制。

常规界面偏好保留在每位玩家本地。大多数设置可以在游戏过程中更改并即时更新，无需重启。

服务器覆盖默认使用 [b]UserChoice[/b]。服务器可以使用 [b]ForceOn[/b]、[b]ForceOff[/b]，或在适用时指定特定显示模式。主开关 [b]Enable Server Overrides[/b] 选项可以完全禁用覆盖系统。

[b]可被服务器覆盖的功能：[/b]
- Information Rail Display Mode
- Enemy Detector
- Current Day
- Current Time
- Weather Forecast
- Smart Biome
- Ashlands Heat Meter
- Enemy Nameplate Mode
- Taming Progress
- Detailed Hover Information
- Container Contents
- Global Chat By Default

[b]从 v1.0.0 更新：[/b]
配置布局和设置键在 v1.1.0 中进行了重组。更新后，v1.0.0 中的现有选择可能需要重新配置。

[b]Insert[/b] 键可临时切换许多自定义 HUD 小部件。
[b]Home[/b] 键可切换在线玩家名单，同时保持在线玩家数量可见。

[line]

[size=5][b]💰 捐赠[/b][/size]
我的模组现在和将来都始终免费使用。如果你想支持我的工作，可以在这里捐赠：
[url=https://paypal.me/Marsarah9]PayPal[/url]

[line]

[size=5][b]⚡ 通用与 HUD[/b][/size]

[size=4][b]🔧 更好的加载提示[/b][/size]
- 用更多更有用的游戏提示替换原版加载提示选择池。
- 包含 [b]51 条提示[/b]，涵盖操作、进程、战斗、建造、食物、探索和不太明显的机制。
- 有意省略了若干非常基础的原版提示。
- 仅适用于[b]英文[/b]本地化。

[size=4][b]🔧 显示船速[/b][/size]
- 在操控船只时显示当前船速。
- 倒车速度使用 [b]R[/b] 前缀。
- 当启用 [b]Status Effects Under Minimap[/b] 时自动重新定位，并适配无地图世界。

[size=4][b]🔧 显示当前天数[/b][/size]
- 在小地图上方显示当前世界天数，适用于无地图世界。

[size=4][b]🔧 显示当前时间[/b][/size]
- 模式：[b]DigitalClock, DayPhases, Off[/b]。
- DayPhases 使用 Night、Dawn、Morning、Day、Afternoon、Evening 和 Dusk。
- 适用于无地图世界。

[size=4][b]🔧 显示天气预报指示器[/b][/size]
- 使用内嵌图标和倒计时在小地图附近显示下一次预定天气。
- 如果预报窗口内没有预定不同天气，则显示当前天气并以 [b]--:--[/b] 计时。
- 支持 Valheim 1.0 替代生物群系预报，包括 [b]Dark Meadows[/b]。
- 在支持的情况下，包含 Seasons 及类似环境变化所使用的天气映射。

[size=4][b]🔧 智能生物群系指示器[/b][/size]
- 根据已装备护甲及其升级等级为生物群系名称着色。
- 颜色从[b]紫色[/b]逐渐过渡到红色、橙色、黄色和[b]绿色[/b]。
- 评估从 Meadows 到 Ashlands 的进程；其他生物群系显示为白色。
- 包含熊皮、Vilebone 和 Lox Fur 护甲。
- 当安装了 Tweaks 且启用了该功能时，会考虑 [b]MarsarahTweaks Gear Upgrade Unlock[/b]。

[size=4][b]🔧 显示在线玩家[/b][/size]
- 在右下角显示在线玩家总数以及最多 [b]20 个玩家名称[/b]。
- 仅有一名玩家在线时隐藏。
- 按 [b]Home[/b] 键可隐藏/显示名称，同时保留总计数。

[size=4][b]🔧 显示首领之力到期消息[/b][/size]
- 当 Forsaken Power 到期时，在屏幕中央显示消息。

[size=4][b]🔧 在 Ashlands 中显示热量计[/b][/size]
- 当相关的 Ashlands 水/岩浆热量机制激活时，显示热量计。

[size=4][b]🔧 小地图下方的状态效果[/b][/size]
- 将状态效果移动为小地图下方的紧凑垂直布局。
- 重新定位并调整航行风向指示器和航行控件的大小以避免重叠。
- 船速会自动随调整后的航行 UI 移动。
- 禁用或处于无地图模式时会自动恢复原版布局。

[size=4][b]🔧 默认全局聊天[/b][/size]
- 使普通聊天消息默认发送为全局，无需玩家手动选择 Shout。
- 保留玩家的原始大小写。
- 诸如 [b]/w 和 /say[/b] 之类的显式命令仍正常工作。
- 支持可选的同步服务器覆盖。

[size=4][b]🔧 登录界面角色统计[/b][/size]
- 在角色选择界面添加可选的统计面板。
- 显示 [b]19 项角色统计[/b]，涵盖游戏时间、战斗、生存、制作、家园活动、旅行和探索。
- 还会根据所选角色的历史显示一项有条件的显著事实。请勿将其与原版成就混淆。
- 事实列表：
- 不寻常死亡事实：
- The Forest Remembers：至少被倒下的树砸死 1 次。
- Curiosity Won：至少被世界边缘杀死 1 次。
- Occupational Hazard：至少被手推车撞死 1 次。
- Flight Test Failed：至少被弩炮杀死 1 次。
- Workplace Safety Violation：至少被吊桥杀死 1 次。
- Disposal Error：至少被湮灭者杀死 1 次。
- Security System Working as Intended：至少被炮塔杀死 1 次。
- Captain Went Down With the Ship：至少被船杀死 1 次。
- The Floor Was Lava：至少被 Ashlands 岩浆杀死 1 次。
- Hostile Waters：至少被 Ashlands 海洋杀死 1 次。
- 重复死亡事实：
- Natural Enemy: Gravity：至少因坠落死亡 3 次。
- Swimming Lessons Recommended：至少溺水 2 次。
- Ventilation Required：至少因吸入烟雾死亡 2 次。
- Own Worst Enemy：至少死于自己之手 2 次。
- Fire Safety Optional：至少被烧死 3 次。
- Should Have Packed a Cloak：至少被冻死 3 次。
- Poison Control：至少因中毒死亡 3 次。
- 活动与事件事实
- The Finishing Touch：至少对 5 个首领造成最后一击。
- The Ones That Got Away：至少丢失 10 条鱼。
- Odin's HR Has Been Notified：至少击中渡鸦 5 次。
- Necromancy Is a Hobby：至少召唤 250 个骷髅。
- Retrieval Specialist：至少打开 5 个属于其他玩家的墓碑。
- Born in a Barn：打开的门比关闭的门至少多 100 个，且至少 10% 打开的门未关闭。
- Thar She Blows：至少使 5 只海怪沉没。
- Treasure Hunter：从埋藏宝藏和地点宝藏计数器中合计找到至少 10 个宝藏。
- 注：地牢宝藏被有意排除。
- Captain：在掌舵航行时至少行驶 100 km。
- Measure Twice, Build Once?：至少建造 100 个部件，并移除至少相当于建造数量 50% 的部件。
- 技能达到 100 级事实：
- Mountain Goat：跳跃等级 100。
- Still Faster Than a Boat：游泳等级 100。
- You Were Never Here：潜行等级 100。
- The Forest Definitely Remembers：伐木等级 100。
- Professional Rock Argument：镐等级 100。
- Not Today：格挡等级 100。
- Cardio Is a Lifestyle：奔跑等级 100。
- Fish Fear Me：钓鱼等级 100。
- Born in the Saddle：骑乘等级 100。
- Outstanding in the Field：农耕等级 100。
- Yes, Chef：烹饪等级 100。
- 大师技能事实：
- Master of Everything：所有原版技能均达到 100 级。
- 当 Master of Everything 符合条件时，单项 100 级技能事实不会被加入随机池。Master of Everything 改为代表该成就。


[size=5][b]⚡ 信息栏[/b][/size]

[size=4][b]🔧 信息栏[/b][/size]
- 在 HUD 左下角添加统一的信息区域。
- 物品栏重量、空闲槽位、敌人探测器和临时技能进度信息使用信息栏。
- 临时元素在变得相关时会平滑地动画进入和退出信息栏。
- 包含 [b]3 种可选视觉样式[/b]，具有不同的背景、边框、图标和颜色。
- 显示模式可使用 [b]图标[/b] 或 [b]文本[/b]。
- 敌人探测器可选择移出信息栏，改为单独的顶部中央显示。
- 召唤计数器保持独立，但遵循所选的信息栏样式和图标/文本模式。

[size=4][b]🔧 物品栏重量和空闲槽位[/b][/size]
- 在信息栏内显示物品栏信息。
- 模式：[b]WeightAndFreeSlots, WeightOnly, FreeSlotsOnly, Off[/b]。
- 重量使用填充条和当前/最大重量显示。
- 空闲槽位显示剩余物品栏槽位。
- 颜色和呈现方式遵循所选的信息栏样式。

[size=4][b]🔧 敌人探测器[/b][/size]
- 统计 [b]30 米[/b]内的附近角色。
- 模式：[b]Consolidated, Split, Off[/b]。
- Consolidated 将敌对敌人合并为一个单一计数器。
- Split 将普通、强敌和首领敌人分为独立的计数器。
- 在使用 Consolidated 模式时，首领和小首领计为普通敌人。
- 中立 Dvergr 在被激怒前单独显示。
- 其他玩家、鹿、野兔、召唤的根和驯服生物不计入敌对计数。
- 强敌类别中的敌人包括：Troll、Bjorn、Abomination、Writhan、Stone Golem、Fuling Berserker、Vile Bear、Seeker Soldier、Gjall、Fallen Valkyrie、Morgen、Serpent 和 Bonemaw
- 可显示在信息栏内，或移动到单独的顶部中央显示。
- 使用所选的信息栏视觉样式和图标/文本显示模式。

[size=4][b]🔧 显示召唤计数器[/b][/size]
- 显示 Dead Raiser 的激活召唤骷髅。
- 召唤的巨魔不计入。
- 仅在召唤物激活时显示。
- 使用所选的信息栏视觉样式和图标/文本显示模式。

[size=4][b]🔧 技能进度条[/b][/size]
- 当技能向其下一级推进到新的整数百分比时，在屏幕底部边缘显示临时进度条。
- 技能等级和进度百分比临时显示在信息栏中。
- 图标模式使用技能的实际游戏内图标；文本模式显示技能名称。
- 奔跑技能进度被有意排除。
- 颜色：[b]Gold, White, Green, Blue, Cyan, Red, Purple[/b]。
- 选择 [b]Off[/b] 会禁用该功能。


[size=5][b]⚡ 物品与交互[/b][/size]

[size=4][b]🔧 在建造菜单中显示已拥有资源[/b][/size]
- 在建造和制作显示中以 [b]需求 / 已拥有[/b] 显示资源需求。
- 例如：[b]2/20[/b]。
- 当安装了 [b]Craft From Containers[/b] 时会让位。

[size=4][b]🔧 敌人姓名板模式[/b][/size]
- 更大的生命条、更清晰的颜色和增加的姓名板显示距离。
- 为首领、敌人、中立/驯服角色、玩家和启用 PVP 的玩家提供不同的颜色。
- 警戒/被激怒状态会改变名称颜色。
- 模式：[b]BarsOnly, BarsWithHealth, BarsWithPercent, BarsWithBoth, Off[/b]。

[size=4][b]🔧 显示驯服进度[/b][/size]
- 在生物适应环境期间，在其生命条下方显示驯服百分比。
- 独立于敌人姓名板模式。

[size=4][b]🔧 物品品质指示器[/b][/size]
- 布局：[b]Horizontal, Vertical, Off[/b]。
- 符号：[b]Star ★, Circle ●, Diamond ◆, Empty Diamond ◇[/b]。
- 颜色：[b]White, Yellow, Green, Red, Blue, Cyan[/b]。

[size=4][b]🔧 更好的物品耐久条[/b][/size]
- 使用带纹理的耐久条，随着耐久度降低从绿色过渡到黄色再趋向红色。


[size=5][b]⚡ 详细悬停[/b][/size]

[size=4][b]🔧 详细悬停信息[/b][/size]
- 为容器、蜂箱、植物、发酵桶、烹饪台/烤箱、熔炉/加工站和蛋添加信息。
- 主模式：[b]ColoredText, WhiteText, Off[/b]。
- 大多数进度悬停支持剩余时间、百分比或两者。

[b]容器悬停信息：[/b]
- 可显示已用/最大槽位、空闲槽位或填充百分比。
- [b]容器内容模式[/b]支持：
- [b]IconsHorizontal[/b] - 物品图标以 5x2 布局显示。
- [b]IconsVertical[/b] - 物品图标以 2x5 布局显示。
- [b]Text[/b] - 对齐的物品数量和名称。
- [b]Off[/b] - 禁用内容显示。
- 图标模式使用实际的原版或模组物品图标，并显示合并堆叠总数。
- 最多显示 10 种不同物品类型，然后对额外类型显示 [b]+N Others[/b]。
- 如果 [b]MarsarahTweaks Progression Halt[/b] 封印了一个箱子，其内容会被隐藏并替换为 [b]"This chest is sealed."[/b]
- 自定义容器信息和内容仅在本地玩家有权访问该容器时显示。
- 其他玩家的[b]个人箱子[/b]保留其原版悬停，不会显示其内容。

[line]

[size=5][b]🔗 兼容性[/b][/size]

[b]MarsarahTweaks[/b]
- 可选软依赖。Marsarah UI 无需 Tweaks 即可运行。
- 智能生物群系会考虑 [b]Gear Upgrade Unlock[/b]。
- 详细悬停 / 容器内容会遵守 [b]Progression Halt[/b]，不会显示已封印箱子的内容。

[b]Craft From Containers[/b]
- 当检测到 Craft From Containers 时，Marsarah UI 会让其处理已拥有资源显示。

[line]

[size=5][b]🔮 未来计划[/b][/size]
未来想法包括更多悬停显示模式、改进的在线玩家信息、更多界面指示器以及其他界面改进。

Deep North 专属界面改动将在本人完成该生物群系后审查。

[line]

[size=5][b]💬 反馈[/b][/size]
欢迎在 Nexusmods 页面的 [b]Posts[/b] 或 [b]Bugs[/b] 标签页中提出建议和报告错误。
感谢查看 Marsarah UI！

[size=5][b]🧑‍🤝‍🧑 致谢[/b][/size]
Blaxxun-bloop - 提供 ServerSync

[size=5][b]📜 版本历史[/b][/size]

[size=4][b]v1.1.0[/b][/size]

[b]修复 / 更新：[/b]
- 更新了天气预报以适配 Valheim 1.0 BiomeSector / AltBiome 天气行为。
- 修复了当空的快捷栏出现在物品之前时，更好的物品耐久条的快捷栏映射问题，保留零耐久破损物品的闪烁。
- 修复了禁用更好的物品耐久条时恢复原始耐久条精灵的问题。

[b]新界面功能：[/b]
- 添加了小地图下方的状态效果。
- 添加了默认全局聊天，并支持服务器覆盖。
- 添加了技能进度条和信息栏技能显示。
- 添加了登录界面角色统计，包含角色统计和有条件的显著事实。

[b]信息栏：[/b]
- 将左下角信息区域重构为统一的信息栏。
- 物品栏重量、空闲槽位、敌人探测器和技能进度现在共享该栏。
- 为临时信息添加了动画过渡。
- 添加了三种可选视觉样式。
- 添加了图标和文本显示模式。
- 为敌人探测器添加了可选的顶部中央定位。
- 召唤计数器现在遵循信息栏样式和显示模式。

[b]敌人探测器：[/b]
- 添加了 Consolidated 和 Split 模式。
- Split 模式将普通、强敌和首领敌人分开。
- 修复了普通敌人计数器在敌人为零时仍然可见的问题。

[b]容器内容：[/b]
- 添加了 IconsHorizontal、IconsVertical、Text 和 Off 模式。
- 添加了实际物品图标和合并堆叠总数。
- 添加了 5x2 和 2x5 图标布局。
- 改进了文本模式对齐。

[b]配置：[/b]
- 将设置重组为通用与 HUD、信息栏、物品与交互、详细悬停和服务器覆盖类别。
- 为兼容的 Configuration Manager 模组添加了显式设置排序，且不添加依赖。
- 为信息栏显示模式和默认全局聊天添加了服务器覆盖。
- v1.1.0 中配置节/键名已更改，因此从 v1.0.0 升级的用户可能需要重新配置其偏好。

[size=4][b]v1.0.0[/b][/size]
- [b]初始独立发布。[/b]

[b]独立界面模组：[/b]
- 将先前包含在 Marsarah Tweaks 中的界面功能移入 MarsarahUI。
- 移除了旧的可选界面布局系统，并保留了首选布局。
- 为可选服务器端覆盖添加了 ServerSync 支持，同时保持常规界面偏好为本地。

[b]服务器覆盖：[/b]
- 为敌人探测器、当前天数、当前时间、天气预报、智能生物群系、Ashlands 热量计、敌人姓名板模式、驯服进度、详细悬停信息和容器内容添加了可选覆盖。
- 覆盖默认为 UserChoice。

[b]HUD / 信息功能：[/b]
- 更好的加载提示；物品栏重量和空闲槽位；敌人探测器；船速；当前天数/时间；天气预报；智能生物群系；召唤计数器；在线玩家；已拥有资源；首领之力到期；Ashlands 热量计。

[b]界面改进：[/b]
- 敌人姓名板模式；驯服进度；物品品质指示器；更好的物品耐久条；详细悬停信息；可选的容器内容。

[b]兼容性：[/b]
- MarsarahTweaks Gear Upgrade Unlock 和 Progression Halt 集成。
- Craft From Containers 兼容性。
- Minimal Status Effects 兼容性。

[b]Valheim 1.0 更新：[/b]
- 将 Lox Fur 添加到智能生物群系 Plains 权重中。
- 扩展了更好的加载提示，添加了更多有用的游戏提示。