迷你地图赫勒 · Valheim: 英灵神殿Mod

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

[size=6]MiniMapHeeler[/size]

在原版 Valheim 中，HUD 小地图被固定为 200x200 的正方形，缩放范围狭窄，无法调整其大小以适应你的显示或 UI 偏好。[b]MiniMapHeeler[/b] 解锁了小地图尺寸调整，同时保持周围 HUD 干净且正确对齐。

此模组在本地 HUD 上以客户端方式运行。无需安装在服务器上，并可在多人游戏中使用。

[line]

[size=5]功能[/size]

[list]

[*] [b]自定义尺寸：[/b] 自由调整宽度（100–1920）和高度（100–1080），可放大或缩小而不会使纹理失真。

[*] [b]更宽的缩放范围：[/b] 扩展缩放边界并采用均衡的步进，使放大和缩小保持一致。

[*] [b]HUD 对齐：[/b] 自动偏移状态效果图标以防止重叠，并提供可选布局将小地图放置在其下方。

[*] [b]游戏内实时调整：[/b] 在 BepInEx Configuration Manager（[b]F1[/b]）中更改的设置会立即生效，无需重启。

[*] [b]仅客户端：[/b] 对本地世界和多人服务器安全，无需服务器安装。

[/list]

[line]

[size=5]配置[/size]

可使用 BepInEx Configuration Manager（[b]F1[/b]）在游戏内更改设置，或编辑 [b]BepInEx/config/dreamwraith.MiniMapHeeler.cfg[/b]：

[b]分区 | 键 | 类型 | 默认值 | 描述[/b]

[b]1 - General[/b] | [b]EnableMod[/b] | [b]bool[/b] | [b]true[/b] | 启用或禁用该模组。

[b]2 - Dimensions[/b] | [b]MinimapWidth[/b] | [b]float[/b] | [b]200.0[/b] | 小地图宽度，以 UI 单位计（原生默认值为 200；随 UI 缩放比例缩放）。

[b]2 - Dimensions[/b] | [b]MinimapHeight[/b] | [b]float[/b] | [b]200.0[/b] | 小地图高度，以 UI 单位计（原生默认值为 200；随 UI 缩放比例缩放）。

[b]3 - HUD Placement[/b] | [b]ShiftBelowStatusEffects[/b] | [b]bool[/b] | [b]false[/b] | 为 true 时，将状态效果对齐到右边缘并将小地图放置在其下方。

[b]3 - HUD Placement[/b] | [b]PositionOffsetX[/b] | [b]float[/b] | [b]0.0[/b] | 相对于默认位置的水平偏移，以 UI 单位计。

[b]3 - HUD Placement[/b] | [b]PositionOffsetY[/b] | [b]float[/b] | [b]0.0[/b] | 相对于默认位置的垂直偏移，以 UI 单位计。

[b]9 - Debug[/b] | [b]EnableDebugLogs[/b] | [b]bool[/b] | [b]false[/b] | 在控制台和 Player.log 中启用详细诊断日志记录。

[line]

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

[list]

[*] [b]仅客户端：[/b] 在游戏 HUD 上本地运行；可在任何多人服务器上安全使用。

[*] [b]单人游戏：[/b] 在本地世界中完全可用。

[*] [b]模组管理器：[/b] 兼容 Gale、Thunderstore Mod Manager 和 r2modman。

[*] [b]UI 缩放：[/b] 完全兼容 Valheim 内置的 UI 缩放滑块（尺寸和偏移会随 HUD 的其余部分按比例缩放）。

[/list]

[line]

[size=5]安装[/size]

[size=4]模组管理器（推荐）[/size]

通过 [b]Gale[/b]、[b]Thunderstore Mod Manager[/b] 或 [b]r2modman[/b] 安装。

[size=4]手动安装[/size]

[list=1]

[*] 安装 [b]BepInExPack Valheim[/b]。

[*] 从 GitHub 或 Thunderstore 下载最新版本。

[*] 将 [b]MiniMapHeeler.dll[/b] 放入 [b]Valheim/BepInEx/plugins/[/b]。

[*] 启动 Valheim。

[/list]

[line]

[size=5]从源码构建[/size]

使用 .NET SDK 构建：

[code]dotnet build -c Release[/code]

编译后的程序集输出到 [b]bin/Release/net48/MiniMapHeeler.dll[/b]。使用 [b]Release[/b] 配置构建还会在 [b]bin/Publish/[/b] 中创建一个分发 zip。

[size=4]自定义路径[/size]

如果你的 Valheim 安装或模组管理器配置文件使用非标准路径，请将 [b]MiniMapHeeler.csproj.user.example[/b] 复制到项目根目录下的 [b]MiniMapHeeler.csproj.user[/b]，并编辑你的路径：

[code]<?xml version="1.0" encoding="utf-8"?>

<GamePath>D:\SteamLibrary\steamapps\common\Valheim</GamePath>

<BepInExCorePath>$(UserProfile)\AppData\Roaming\com.kesomannen.gale\valheim\profiles\<ProfileName>\BepInEx\core</BepInExCorePath>

</PropertyGroup>

</Project>[/code]

[line]

[size=5]打包与发布[/size]

打包和发布自动化通过 [url=https://github.com/dreamwraith/Valheim-MiniMapHeeler/blob/main/.scripts/modtools.ps1][b].scripts/modtools.ps1[/b][/url] 使用 [url=https://github.com/DreamWraith/DW-ValheimModTools][b][b]DW.ValheimModTools[/b][/b][/url] 模块进行处理：

[list]

[*] [b]创建发布：[/b] [b]pwsh ./.scripts/modtools.ps1 release[/b]（构建 Release、创建分发归档、提取变更日志说明并创建 GitHub Release）。

[*] [b]递增版本并打包：[/b] [b]pwsh ./.scripts/modtools.ps1 package -Bump Patch[/b]

[*] [b]发布到模组门户：[/b] [b]pwsh ./.scripts/modtools.ps1 publish -Target All[/b]（上传到 Thunderstore、Hexium 和 Nexus Mods）。

[/list]

有关完整的脚本选项和密钥配置，请参阅 [url=https://github.com/dreamwraith/Valheim-MiniMapHeeler/blob/main/.scripts/README.md][b].scripts/README.md[/b][/url]。

[line]

[size=5]许可证与说明[/size]

[list]

[*] 根据 GNU General Public License v3.0 授权（参见 [url=https://github.com/dreamwraith/Valheim-MiniMapHeeler/blob/main/LICENSE.md]LICENSE.md[/url]）。

[*] [url=https://gist.github.com/dreamwraith/98564f8441dc234bfadd7e2b605c694c]关于 Valheim 模组制作的说明[/url]

[*] [url=https://gist.github.com/dreamwraith/77c91d656c842611bf8c40febf8056f2]关于 AI 与软件工艺的说明[/url][/list]

评论