TrueHUD - HUD扩展组件（附汉化）

鼓掌之间

转自：https://www.nexusmods.com/skyrimspecialedition/mods/62775

此前包含在《True Directional Movement》（真实方向移动）MOD中的HUD功能，现已经过彻底重构与优化！提供高度可自定义的角色信息条、BOSS条、玩家组件、近期拾取日志，以及供其他插件调用的API。通过MCM（MOD配置菜单）可实现模块化设置与自定义调整。

开发本MOD的初衷是：我无法再合理地为《True Directional Movement》添加更多不相关的HUD元素，因此决定将所有HUD组件迁移到独立MOD中，同时对其进行重构与优化。本插件同时也可作为我（或其他开发者）开发的其他SKSE插件的枢纽——这些插件若需添加或控制HUD组件，均可依托本MOD实现。

请勿介意这个略显俗气的名字，实在是忍不住想和《True Directional Movement》形成名称关联。


·特点
- 支持为任意数量角色（敌人或队友）显示悬浮信息条
- BOSS生命值条
- 可移动/缩放的玩家生命值、魔法值、耐力值条，龙吼冷却指示器，以及合并式附魔充能计量条
- 近期拾取日志
- 供其他插件调用的API
- 特殊条：可由其他插件调用，用于显示眩晕进度、当前姿态等数值
- 所有功能均通过SKSE（上古卷轴脚本扩展工具）实现，可随时安装/卸载
- 模块化且灵活：所有功能可通过MCM关闭，各项参数也可在MCM中配置


·角色信息条
信息条是带有动画效果的小型组件，可显示敌人生命值，还可按需显示其他实用信息。所有功能可按角色类型（当前目标、敌人、队友等）单独开启或关闭。

- 名称：显示角色名称
- 左侧指示器：可显示三种内容——灵魂图标（由Mern制作，代表所需灵魂石等级）、按相对难度着色的简约方块，或仅显示角色等级数字
- 资源条（魔法值/耐力值）：可设置为仅在资源值偏离默认值时显示
- 近期伤害计数器：显示近期对该角色造成的伤害
- 特殊条：详见下文章节


默认设置规则如下：当前目标（即原版目标条中罗盘下方显示的目标，或《True Directional Movement》目标锁定功能中的当前目标）将显示更宽的生命值条，并启用名称与灵魂图标；其他敌人则显示更小的简约信息条。


·BOSS条
遇到的部分敌人会被自动识别为BOSS，MOD将在屏幕上以大型固定条的形式显示其生命值。

BOSS条与悬浮信息条共享多项功能，但可独立配置。通过MCM可自由调整BOSS条在屏幕上的位置；在BOSS条显示时，还可选择将字幕上移，或禁用罗盘，以便BOSS条在HUD中找到合适位置。

为方便使用，提供两种预设设置：
1. 罗盘替代项：将BOSS条设为罗盘的替代显示（附带小型龙吼冷却指示器，以弥补罗盘隐藏后的功能缺失）
2. 屏幕底部：将BOSS条固定在屏幕底部

所有功能均可单独配置，预设仅提供基础设置模板。此外，可配置战斗中最多显示的BOSS条数量；若同时对抗的BOSS数量超出上限，将自动排队，当前显示的BOSS被击败后，下一个BOSS条将取而代之。


·BOSS识别系统
BOSS识别系统具备灵活性，支持用户自定义配置，也可创建兼容性“补丁”。该系统读取位于Data/SKSE/Plugins/TrueHUD路径下的.ini配置文件（为保证兼容性，Data/SKSE/Plugins/TrueDirectionalMovement路径下的.ini文件也会被读取）。系统会读取对应文件夹下所有.ini文件，因此可创建多个互不冲突、无需手动合并的.ini文件。若默认配置未适配某些MOD，您可自行创建并上传自定义.ini文件，为这些MOD添加兼容性。默认配置文件应能覆盖大多数场景，且内容易于理解。


·BOSS识别逻辑
1. 检查NPC黑名单：若NPC的BaseID（基础ID）在黑名单中，即使满足后续条件，也不会被判定为BOSS。
2. 检查种族：若种族在.ini文件中列出，目标将被判定为BOSS。默认情况下，主要包括巨龙与龙祭司。
3. 检查NPC的BaseID（基础ID）：若BaseID在.ini文件中列出，目标将被判定为BOSS。我已添加了多个知名敌人，但难免有遗漏。
4. 检查NPC是否属于当前场景中.ini文件配置的LocRefTypes（位置引用类型）：默认已添加“Boss”（BOSS）类型。原版游戏中，该类型用于标记地下城终点的BOSS敌人；《Vigilant》（警戒者）等MOD似乎已将大部分（若非全部）BOSS正确设为“Boss”类型，因此可自动适配。但贝塞斯达（Bethesda）也将商人等NPC标记为其住所的“BOSS”，攻击他们时会显示BOSS条——这可能不符合需求，故添加了黑名单功能，不过除示例商人外，我并未填充完整黑名单。


·.ini文件编辑建议
若需向.ini文件添加内容，无需编辑插件自带的基础.ini文件，建议创建自定义.ini文件（文件名最好唯一，避免冲突），仅添加新内容，并以[BossRecognition]（BOSS识别）作为标题。插件会读取文件夹中所有.ini文件，并将内容合并。

若需禁用基础.ini文件中的部分记录，可在自定义.ini文件中以RemoveRace（移除种族）、RemoveLocRefType（移除位置引用类型）、RemoveNPC（移除NPC）、RemoveNPCBlacklist（移除NPC黑名单）的形式添加对应内容。


·玩家组件（Player Widget）
玩家组件包含生命值、魔法值、耐力值条，带动画效果的龙吼冷却指示器，以及附魔充能计量条。该组件旨在替代原版HUD计量条，具备优化的动画效果、可开启/关闭的“延迟”虚影条，且位置与宽度均可配置。

为方便使用，提供两种预设设置：
1. 仿原版：计量条位置与宽度和原版一致。
2. 合并式：类似其他游戏的设计，计量条垂直堆叠，宽度随最大生命值/魔法值/耐力值缩放，且包含动画龙吼指示器。

所有功能均可单独配置，预设仅提供基础设置模板。组件元素可设置为始终显示、仅战斗时显示，或在相关数值变化时动态显示。此外，耐力值条可切换为显示坐骑耐力值，附带由Mern制作的精美边框图标；计量条完全支持生存模式的数值惩罚效果，以及耐力值/魔法值耗尽时的闪烁提示。


·最近拾取
获取的物品将在近期拾取列表中短暂显示。相关设置可在MCM中调整，还可设置该组件在特定菜单（如制作菜单、交易菜单）中也能显示。此外，可选择跳过原版游戏中“物品已添加到背包”的提示信息。

注意：物品图标显示需安装《SkyUI》（天空UI）MOD，未安装则不显示图标。


·特殊条
特殊条需配合其他插件使用，是可显示在生命值条上方的附加条。调用本MODAPI的插件可申请控制特殊条，并提供函数以返回条的当前值/最大值。例如，可作为眩晕条使用，类似《战神》（God of War）或《刺客信条：英灵殿》（Assassin's Creed Valhalla）中的设计。

若您的MOD使用了该功能，欢迎告知，我将在下方列出：
- POISE（姿态条）：https://www.nexusmods.com/skyrimspecialedition/mods/72653
- Chocolate Poise（巧克力姿态条）：https://www.nexusmods.com/skyrimspecialedition/mods/70478
- Valhalla Combat（英灵殿战斗）：https://www.nexusmods.com/skyrimspecialedition/mods/64741


·前置需求与安装
·前置需求
- SKSE（上古卷轴脚本扩展工具）：https://skse.silverlock.org/
- Address Library for SKSE Plugins（SKSE插件地址库）：https://bbs.3dmgame.com/thread-6549645-1-1.html
- SkyUI（天空UI）：用于在MCM中访问插件设置及显示拾取物品图标：https://bbs.3dmgame.com/thread-6575456-1-1.html
- MCM Helper（MCM辅助工具）：确保MCM正常运行：https://www.nexusmods.com/skyrimspecialedition/mods/53000

·安装方法
将压缩包解压至游戏Data目录，或使用任意MOD管理器安装。


·兼容性
本插件采用模块化设计，例如仅使用BOSS条功能时，无需担心与其他无关功能的兼容性问题。

- 理论上兼容所有原版HUDMOD/HUD重绘MOD，新组件不会受其影响。
- 唯一可能的冲突场景：当其他MOD控制原版组件（罗盘或生命值/魔法值/耐力值、附魔计量条）的显示状态时，可能导致本MOD隐藏的组件重新显示。
- 完全兼容添加新HUD功能的MOD，如《moreHUD》（更多HUD）。
- 预计与其他所有MOD兼容。


部分代码片段源自《True Directional Movement》，但绝大多数代码为全新编写，难免存在疏漏。反馈问题时请清晰描述，最好能提供复现步骤；若出现崩溃，烦请提供崩溃日志——对于SKSE插件而言，崩溃日志至关重要。

欢迎提出功能建议，但需理解：MOD的最终设计方向由我决定，可能会否决部分建议。请理性看待建议，勿默认所有建议都会被采纳。


·常见问题（FAQ）
1. Q：支持传奇版（Legendary Edition）吗？  
   A：抱歉，不支持。特别版（Special Edition）的引擎更稳定，且CommonLibSSE等框架能更轻松地实现高级插件功能，建议升级至特别版。若您有能力，可尝试将MOD移植到传奇版，但我更倾向于将时间投入到其他事务，而非支持旧版游戏。

2. Q：可在游戏进程中安装/卸载吗？  
   A：可以。本插件不会对游戏产生永久性影响，可随时安装/卸载。

3. Q：在MCM中修改设置后，组件显示异常怎么办？  
   A：我已尽量确保组件支持实时修改主要设置，若仍出现异常，保存并重新加载游戏即可——这能清除所有组件缓存，恢复正常。

4. Q：MCM界面空白怎么办？  
   A：您的MCM Helper或本MOD未正确安装，请检查安装路径与文件完整性。

5. Q：设置自动重置怎么办？  
   A：请勿删除MCM Helper生成的.ini文件（若使用Mod Organizer 2，该文件默认位于override文件夹中）。

6. Q：使用本MOD后HDT物理效果卡死？  
   A：此问题由旧版HDTMOD导致，请更新HDT至最新版。

7. Q：使用本MOD后无法操作菜单？  
   A：此问题由旧版《Skyrim Souls》（天际灵魂）MOD导致，请更新至最新版。

8. Q：怀疑本MOD导致游戏崩溃？  
   A：请提供.NET Script Framework（.NET脚本框架）或Crash Logger（崩溃日志工具）生成的崩溃日志。对于本MOD这类SKSE插件而言，崩溃日志至关重要，缺乏日志则无法排查问题。

温馨提示：请仔细阅读MOD说明并探索MCM中的各项设置——曾多次有人询问的功能，实则已在MCM中作为可选项实现。


·面向MOD作者的信息
·美术作者相关
若您希望为重绘组件纹理，欢迎尝试！我已将所有资源文件整合至TrueHUD_Assets0.swf文件中，您可自由修改与分发；源文件.fla已上传至我的GitHub。未来更新中，我会尽量不再修改此文件；若需添加新资源，将创建TrueHUD_Assets1.swf等后续文件。

注意：请勿重新编译/分发TrueHUD_Widgets.swf文件——我需保留对此文件的控制权，以便随时修复问题与添加新功能。

·开发相关
- SKSE：提供基于《SmoothCam》（平滑镜头）MOD的API头文件，支持与本插件通信并控制部分功能。若您想使用但不知如何操作，欢迎咨询；可参考《True Directional Movement》的源码作为示例（该MOD有独立API，存在一定差异）。
- SKSE：提供调试绘制API函数，若您在开发插件时需绘制线条或图形，可使用这些函数辅助开发。
- 计划在近期为尽可能多的API函数添加Papyrus（天际脚本语言）版本。

若您是MOD作者，希望为您的MOD添加与本MOD的兼容性，欢迎告知，我们可共同探讨实现方案。

下载地址：

游客，如果您要查看本帖隐藏内容请回复

azjs

感谢分享

秦夏

手动阀手动阀手动阀

苛夺

谢谢分享

3dm_33378739

66666666666666

kevinwei1875

支持一下

819005417

111111111111111

876588024mm

详细分析

盖伦会转圈

666666666666666

悠翼

太给力了

a15697897292

12312312312

薰风习习

感谢分享

xu28

谢谢分享

先轸

sihu bucuo

laowuhaihao

woakankanhaoma

suchsword

看看啊··········

laoniu3

感谢分享

xq2234

66666666666666666666

3dm_29692383

谢谢楼主~~

139743188

66666666666666666

独斌侠

非常感谢！！！！！

拉你进坟墓

咋什么都发不了呢

ww823681765

6666666666

ln0218

谢谢分享

abejun

666666666666666666666666

wuchangdao55

终于等到了

qilanghb

stefan1983

感谢楼主分享

haotian0909

66666666666666666666

2971948360qq

666666666