每个账号独立的探索图层、细腻且不叠加的玩家颜色，以及明确的按需图钉分享功能。

玩家地图图层

玩家地图图层每层保留一张制图图层，每 平台账号，同时始终显示当前 角色名 在界面中，玩家可以在导入前预览一个或多个图层，单独查看某个玩家的地图，避免重复应用相同的修订，并撤销上一次导入。

公开测试版 0.2.13。 服务器和每个参与的客户端上必须安装相同的版本。

当前功能

• 服务器权威层存储，按世界分隔。
• 由服务器生成的稳定账户标识；原始平台标识符绝不会发送给其他客户端。
• UI 中显示的当前角色名，以及仅作为元数据保留的曾用角色名。
• 成功 记录发现 仅上传玩家个人的探索迷雾数据，绝不上传标记或模组标记。
• 一次成功 读取地图 动作被非破坏性拦截：
  1. 原始的个人/共享探索面具和实时图钉引用已被捕获；
  2. 瓦尔海姆正常读取该表；
  3. 生成的共享探索遮罩独立于个人进度进行记录；
  4. 原有的探索面具已恢复，仅通过读取添加的标记会经由瓦尔海姆正常的标记生命周期被移除；
  5. 玩家选择是否应用预览。
• 快速隔离单个玩家的层级。
• 多层临时预览。
• 本地玩家当前的个人探索进度由其常规账号/角色行表示； 共享桌子探索 仍可独立选择，并可一键预览其精确并集。
• 明确的应用/取消控件。
• 单级导入回滚，同时本地持久化，以便重启后恢复。
• 版本修订与 SHA-256 指纹追踪，避免重复应用未更改的图层。
• 玩家选择的命名颜色和内置徽章，已由服务器接受并同步。
• 选择玩家颜色或徽章会立即同步；当服务器返回已接受的标识时，缓存的预览会刷新。
• 图钉默认是私密的，可以单独分享，从 共享标记 标签页
• 每个显式共享的标记可使用其原始图标或兼容的BetterMap图标，例如镐、箱子、传送门、采集物、地牢、蜂巢、焦油或树液；其原始语义标识保持不变以用于重复保护。
• 通过玩家地图图层同步的临时标记会获得一个可选的浮雕光晕，其颜色为作者服务器认可的颜色，且不会改变图标本身的颜色。
• 《英灵神殿》原生 制图台 开关是原生地图图层和玩家地图图层共享引脚的主控开关。
• 玩家地图图层的远程标记可在本地筛选：所有玩家、选定玩家或无。原生、BetterMap和TargetPortal标记仍由其原系统控制。
• 玩家地图图层会临时渲染远程标记，并移除语义重复项，而不是将它们导入本地地图。
• 活跃探索预览会以低不透明度显示每位玩家服务器已接受的颜色。
• 玩家颜色饱和度可独立调节，范围从100%到250%，默认值更高，为180%。
• 仅玩家区域默认不透明度为8%，仅共享桌面背景为3%，多人重叠区域则统一使用中性的1.5%遮罩；桌面不会中和玩家的颜色，且颜色从不进行透明度叠加。
• 身份与探索颜色详情使用可折叠区域，身份调色板在原有无障碍色盲友好选项的基础上新增了紫色、青绿色、酸橙绿和白色。
• 探索染色是一个临时的本地UI图层，不会进入迷雾数据、地图存档或网络载荷。
• 使用《英灵神殿》配置的地图操作打开普通大地图时，图层会话会在整个面板折叠的状态下启动。使用 筛选 / 筛选 打开它； 关闭 再次折叠，且不取消当前预览。
• 阅读制图台时仍会自动打开大地图和完整面板，以便立即查看收到的图层。
• 图层复选框会立即更新地图。本地玩家、共享桌面以及任何远程玩家的精确组合会按世界和本地角色分别记录，并在每次重新打开地图时恢复。
• 玩家实际读取的最新共享牌桌快照会按世界和角色保存在本地，因此记住的牌桌选择在游戏重启后依然保留，且不会改变已保存的地图。
• 我和桌子, 全部 和 无 是选择预设。永久导入单独放在高级部分，因为记住的视图并不需要它。
• 当《英灵神殿》为法语时显示法语界面；否则显示英语。
• 没有单独的全局键盘快捷键：该模组跟随 Valheim 配置的地图操作，包括 AZERTY 布局和重新映射的按键。
• 鼠标点击和滚轮输入在模组窗口上会被优先处理，之后Valheim的地图才能在窗口下方创建、移除或移动标记。
• 菜单会自适应当前分辨率和界面缩放。在较矮的屏幕上，全局垂直滚动条可确保所有控件均可访问；调色板和固定行在窄窗口中也会自动重排。
• 现有的原版、BetterMap和TargetPortal标记对象在制图读取后从未被清除或重建，导致分离的屏幕空间标记图形无法显示。
• 个人偏好设置、记住的选择、共享表格快照和导入恢复文件保存在 Valheim 的每个 Windows 用户目录下 本地低 目录。因此，Gale 配置文件同步在向订阅者分发模组和服务器策略文件时，不会克隆某位玩家的界面或身份偏好。

兼容性策略

更好的地图

BetterMap 仍是其图钉和图标的拥有者。玩家地图图层在运行时发现 BetterMap 的活跃图标类型，并且仅为临时共享图钉渲染引用选定的类型；它不会注册替换类型、重新着色 BetterMap 图钉或重复传送门标记。玩家图层、预览基线和撤销点仅包含探索位；不会在当前图钉集合上恢复完整的序列化地图。

传送门目标

玩家地图图层未修补 传送世界，不使用 P 不会移动传送门标记。它仅在玩家使用 Valheim 配置的地图操作时自动打开，因此 TargetPortal 的程序化目标地图保持独立。

简易访问控制

SimpleAccessControl仍负责制图台的权限检查。Player Map Layers仅在Valheim原始 读取时 处理程序被允许运行后，或在成功 写入时，且不消耗 Shift + 使用, Shift + A 或 Shift + Q.

安装

玩家地图图层以标准Thunderstore包形式发布。BetterMap、TargetPortal和SimpleAccessControl是可选集成，而非必需依赖。

盖尔（推荐）

1. 打开将要使用该模组的 Valheim 配置文件。
2. 搜索 玩家地图图层 在盖尔。
3. 选择 下载，然后在配置文件中保持该模组启用。
4. 对每个参与的客户端重复此操作，并在服务器上安装相同的包版本。
5. 通过以下方式启动游戏 启动模组版.

普通玩家无需编译器、开发归档文件或手动安装程序。更新会像其他 Thunderstore 模组一样通过 Gale 推送。

专用服务器

在服务器的 Valheim/BepInEx 配置文件中安装相同版本的 Thunderstore 模组包。安装或更新后重启服务器。玩家图层和显式共享的标记存储在服务器端，并按世界分别保存。

用法

1. 制作一个原版制图台。
2. 使用 记录发现 上传或更新你的个人层级。
3. 使用 读取地图 在制图台上，或打开大地图并选择 过滤器 / 过滤.
4. 选择你的账户行、远程玩家和 共享餐桌探索。视图会立即更新，组合也会被记住。
5. 使用 我加桌子, 全部 或 无 用于快速选择，或 单人 在一层旁边。
6. 仅打开 永久导入 当发现内容必须复制到已保存的共享地图时。使用 撤销上次导入 如果需要的话。

选择性图钉分享

1. 打开大地图并选择 共享标点.
2. 只勾选需要共享的个人已保存标记。
3. 通过每个图钉旁的箭头选择显示图标，然后选择 同步已勾选的标记未勾选的标记保持私密；取消勾选之前已共享的标记后，该标记将在下次同步时从服务器列表中移除。
4. 保留瓦尔海姆的原生 制图台 切换开关以查看共享标记。
5. 选择 全部, 玩家，或 无这些筛选器仅影响通过玩家地图图层同步的标记； 玩家 筛选器为每个远程账户显示一个复选框。

系统标记和临时标记永远不会提供共享。如果BetterMap或TargetPortal在同一位置已经拥有等效标记，则保留其原生标记，玩家地图图层不会绘制重复标记。

身份

在内部，服务器会将经过身份验证的平台账号映射到一个加了盐的UUID。用户界面从不显示该UUID，而是显示该账号最近一次出现的角色名。

多个角色使用同一平台账号，因此会保持相同的颜色、徽章和归属。每个提交的角色名称仍会在内部保留，用于诊断和迁移。

配置

服务器与共享技术设置仍保留在Gale/BepInEx配置文件中：

BepInEx/配置/zephyrfit.playermaplayers.cfg

这些设置包括：

• 启用 = 真
• 允许身份变更 = true
• 启用组共享 = false
• 最大图层大小KB = 4096
• 详细日志 = false

个人客户端设置存储在 Gale 同步配置文件之外：

%USERPROFILE%/AppData/LocalLow/IronGate/Valheim/PlayerMapLayers/client-preferences.cfg

它们包括：

• 导入前预览 = true
• 写入地图时上传 = true
• 优先颜色 = #56B4E9
• 首选徽章 = 罗盘
• 远程标记筛选 = 全部
• AuthorColorHalos = true
• 探索界面.已启用 = true
• 探索覆盖层.单人透明度 = 0.08
• 探索界面.共享表格不透明度 = 0.03
• 探索覆盖层.OverlapOpacity = 0.015
• 探索界面覆盖层.色彩饱和度 = 1.8
• 界面.羊皮纸主题 = true

已记住的图层组合、共享表格快照、导入台账和撤销数据都存储在同一个 Low/PlayerMapLayers/client/ 根。它们从不包含在Gale配置同步中。从0.2.11升级时，属于当前本地角色的文件会被移出 BepInEx/配置；已接受的颜色和徽章将从服务器权威账户配置文件中恢复。

羊皮纸主题在本地生成，随窗口缩放，无需外部UI依赖即可运行。设置 羊皮纸主题 = false 恢复经典的英灵神殿IMGUI主题。

群组分享功能暂未开放 启用组共享 = false; 禁用期间不显示组菜单。

服务器数据

服务器分层按世界存储在以下位置：

BepInEx/config/PlayerMapLayers/world_<world UID>/layers/

明确共享的图钉列表单独存储在 世界_<world UID>/标记/他们从不进入探索有效载荷或本地地图存档。

客户端仍通过经过验证的RPC消息提交个人探索记录、所选身份以及明确共享的标记点。服务器解析已认证账户，存储接受的数据，并将图层和标记点索引重新分发给参与客户端。将客户端偏好设置移至 LocalLow 不会改变此网络工作流程。

服务器还会在层索引中私下返回请求玩家自己的加盐UUID。这样客户端就能在角色名变更后识别自己的账户，而无需显示或传输原始的Steam/PlayFab标识符。现有的PML4层文件仍与0.2.13兼容。

写入是原子的，并保留 .bak 上一层的副本。

路线图

• 可选的无障碍首字母或图案，默认关闭，旨在避免地图杂乱。
• 可选的按类别固定筛选器以及专用的旧版表格固定类别。
• 可选的内部群组共享，默认隐藏。

支持

Discord： @zephyrfit
用户ID： 251341133085540352

请求支持时，请附上 BepInEx/LogOutput.log 并指定 Valheim、Player Map Layers、BetterMap 和 TargetPortal 的版本。