Thundagar的Valheim网络地图

[heading][size=5]包含 AI 生成的代码。[/size]
[size=3]我让 AI 帮我制作了这个模组，因为我自己确实无法这么快完成。我想要一张能合并我们地图桌的地图，让我能看到我们已经发现了什么。我不确定是否要发布它，但想着也许有人会觉得它有用。
[/size]
描述[/heading]
[b]Thundagar 的 Valheim 网页地图[/b] 将你服务器的共享发现带到浏览器中。
该地图使用游戏内制图桌记录的信息，未探索的地形保持隐藏。选择一个桌子作为地图来源，或合并所有桌子的发现。
探索详细地形、浏览共享标记、高亮匹配位置，并查看已启用 [b]对其他玩家可见[/b] 的玩家。通过符文石发现的 Boss 位置，一旦在桌子共享后便能穿透迷雾显示——而不会揭示周围地形。
专为 Windows 和 Linux 专用服务器设计，支持自定义服务器品牌，并有一个可运行在同一台电脑上的独立网站。
[b]免费、非官方、粉丝制作。与 Iron Gate Studio 或 Coffee Stain 无关联，也未获其认可。[/b]
[heading]安装说明[/heading]
下载 [b]模组包和网页包[/b]。源码包是可选的。
1. 安装服务器模组
[list=1]
[]备份你的世界和现有配置。[/]
[]停止你的 Valheim 服务器。[/]
[]安装与你的 Valheim 安装兼容的 BepInEx 版本。[/]
[]将模组包解压到 Valheim 服务器目录。两个插件 DLL 应位于：
[code]BepInEx/plugins/ThundagarValheimWebmap/[/code][/]
[]通过启用 BepInEx 的启动器启动服务器一次以生成设置文件，然后在编辑前停止它。[/]
[/list]共享设置文件为：
[code]BepInEx/config/com.thundagar.valheimwebmap.cfg[/code]2. 配置你的地图
在生成的设置文件中：
[list]
[]将 [b]Table → Mode[/b] 设置为
[code]All[/code]以合并桌子，或
[code]Single[/code]以使用一个选定的桌子。[/]
[]对于
[code]Single[/code]，使用导出目录中的私有
[code]tables.json[/code]发现文件配置该桌子的
[code]X[/code]和
[code]Z[/code]坐标。[/]
[]将 [b]Map → TerrainDetail[/b] 设置为
[code]2[/code]以获得详细地形，或
[code]1[/code]以获得原始渲染。[/]
[]将 [b]MetersPerPixel[/b] 保留为
[code]0[/code]以自动检测游戏比例。[/]
[]使用 [b]Web → Brand、Title 和 Subtitle[/b] 自定义你的标题。[/]
[]将 [b]Web → Public[/b] 设置为
[code]true[/code]以无需登录访问，或
[code]false[/code]以使用密码保护查看。[/]
[/list]用于专用服务器时，请保持 [b]AllowLocalHostTest[/b] 禁用。
3. 安装网站
安装 [b]Python 3.11 或更高版本[/b]，然后将网页包解压到服务器目录内的
[code]webmap[/code]文件夹中。
在该文件夹中打开终端。
[b]Windows PowerShell：[/b]
[code]py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe start_webmap.py[/code][b]Linux：[/b]
[code]python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python start_webmap.py[/code]按此方式安装时，网站会自动定位共享配置。对于其他位置，请使用以下命令启动：
[code]--config PATH-TO-YOUR-SHARED-CFG[/code]如需私密查看，请在启动前设置网站的
[code]WEBMAP_PASSWORD[/code]环境变量。这与你的 Valheim 加入密码是分开的。请参阅 [b]INSTALL.md[/b] 了解特定平台的说明。
4. 开始共享发现
启动你的 Valheim 服务器并在制图桌记录你的发现。
在运行网站的电脑上，打开：
[b][url=http://127.0.0.1:8766/valheimmap]http://127.0.0.1:8766/valheimmap[/url][/b]
首次地形导出可能需要几分钟，具体取决于服务器和共享探索的数量。
要使网站可从该电脑外部访问，请配置 HTTPS 反向代理或合适的局域网访问。[b]不要暴露原始导出目录[/b]，其中还包含私有发现元数据。
完整的 Windows 和 Linux 设置、服务配置指南、更新和回滚说明包含在 [b]INSTALL.md[/b] 中。
[heading]主要功能[/heading]
[list]
[][b]制图桌共享：[/b] 显示在一个桌子记录的发现，或合并多个桌子。[/]
[][b]战争迷雾：[/b] 未探索的地形保持隐藏。[/]
[][b]已发现的 Boss 提示：[/b] 桌子共享的 Boss 位置可穿透迷雾保持可见，而不会暴露附近地形。[/]
[][b]详细地形：[/b] 可选的高分辨率渲染，带坡度阴影、细微等高线和森林纹理。[/]
[][b]共享地图标记：[/b] 显示名称、图标和划掉状态。[/]
[][b]分组标记：[/b] 匹配的名称和图标类型共享一个列表条目。选择一个组以高亮其位置。[/]
[][b]字母顺序列表：[/b] 浏览排序的组和名称，或搜索位置。[/]
[][b]可读标签：[/b] 标记名称使用标题大小写，已识别的游戏标记使用友好名称。玩家名称保持不变。[/]
[][b]保守的重复处理：[/b] 附近匹配的标记可以显示为一个标记，而不会删除原始数据。[/]
[][b]显示控制：[/b] 按标记类型切换图标和标签。同时调整图标和标签大小。[/]
[][b]可见玩家位置：[/b] 仅显示启用游戏内可见性的玩家的名称和位置。玩家移动永远不会揭示地形。[/]
[][b]已保存地图查看：[/b] 在临时连接丢失期间保持最后可用的地图可见。[/]
[][b]可自定义品牌：[/b] 更改服务器标题、标题、副标题和支持的 SVG 图标。[/]
[][b]公开或私密网站：[/b] 选择开放查看或单独的查看者登录。[/]
[/list][b]注意：[/b] 启用
[code]All[/code]桌子时，较旧的桌子可能会保留过时的标记名称。更新保存该信息的桌子以移除过时的贡献。
[heading]要求[/heading]
[list]
[]一个 Valheim 专用服务器。[/]
[][b]与你的 Valheim 版本兼容的 BepInEx。[/b][/]
[][b]Python 3.11 或更高版本[/b]用于网站。[/]
[]包含的
[code]requirements.txt[/code]中列出的 Python 依赖项。[/]
[]一个包含共享发现的游戏内制图桌。[/]
[]一个现代网页浏览器。[/]
[/list]最新构建是针对 [b]Valheim 1.0.12，网络版本 40[/b] 编译并验证运行的，在 Linux 上使用 [b]BepInEx 5.4.23.3[/b]。
该模组在服务器上运行；玩家不需要安装此网页地图模组。
网站需要对共享配置和导出的地图文件具有读取访问权限。Valheim 服务器需要对导出目录具有写入访问权限。
[b]这是一个测试版。[/b] 不保证与其他游戏版本的兼容性。在安装或更新模组之前，请备份你的世界。
地形表示生成的地貌数据；它不是建筑物、单棵树或每个玩家地形更改的实时渲染。森林纹理是装饰性的。
[heading]致谢[/heading]
感谢 [b]Iron Gate Studio[/b] 创造了 Valheim，以及 [b]BepInEx 贡献者[/b] 提供的模组框架。
感谢在 [b]Thundagar and Friends[/b] 游玩的朋友们测试网页地图，并通过真实游戏帮助改进它。
Valheim 及其游戏资产属于各自的所有者。该网站包含原创 SVG 标记艺术作品。