BetterMapFix

BetterMapFix

> ⚠️ APPLICABILITY NOTICE — please read this before installing. > > This patch was written for my own, heavily modded setup (30+ mods enabled in an r2modman > profile — BepInEx 5.4.2350 / Valheim 1.0.15). What it adds may not be something you want. > > This is not a bug. xtavim-BetterMap is not defective — it behaves exactly as it was > designed to. What this patch adds are cases the original mod deliberately leaves out > (see the table below), plus a rename of pin labels that the original has no setting for. > The original mod's author bears no blame — this patch has no relationship with them and > was written without their consent or review. > > - If you are not seeing exactly this symptom, please don't install this — it may do nothing for you. > - This patch may not apply to your setup at all — with a different mod list the symptom may never appear. > - Even with the same symptom, the root cause may be different — this is only a workaround derived from what I found on my machine. > - If you don't want these extra pins, just don't install it — this is a preference, not a right/wrong question. > - If you think the original mod misbehaves, please report it to its author first.

> ⚠️ 适用性声明 —— 请先读这一段，再决定装不装。 > > 本补丁是在我自己那套环境里做出来的：r2modman 的 profile 里同时装着 30+ 个模组 > （BepInEx 5.4.2350 / 游戏 1.0.15）。 > > 这不是 bug。 xtavim-BetterMap 本身没有问题，它完全按自身设计正常工作 —— > 本补丁补的是它有意不做的那些情况（见下面的对照表），以及一个它本来就没有开关可调的 > 「图钉名中文化」。原模组作者不应被追责：本补丁与他没有任何关系， > 未经其同意、也未经其审查。 > > - 如果你没有遇到完全相同的症状，请不要安装本补丁 —— 它可能什么都不做； > - 本补丁可能不适用于你的环境：换一套模组组合，症状也许根本不会出现； > - 就算症状一样，成因也可能不同 —— 本补丁只是我按本机情况查出来的绕行方案； > - 如果你不需要这些额外的图钉，那根本不用装 —— 这是一个取舍，不是「谁对谁错」； > - 如果你觉得原模组有问题，请先向原模组作者反馈。这只是我个人“能跑就行”的绕行方案， > 不保证适用于任何人。

给 BetterMap 打的客户端补丁 —— 做三件事：

1. 迷雾之地的女王指引石（Vegvisir）不会被标记 —— 上游 1.1.0 的 Vegvisirs 规则仍然只有 7 个群系，没有迷雾之地。
2. 希尔迪（Hildir）三个任务地牢没有条目 —— 上游有意不做（它认为原版游戏自己会在这些位置放图标），

本补丁补上，三条默认全关，想用的人自己开。

1. 图钉名中文化（洞穴、要塞、祭坛那类地点图钉）—— 上游没有任何本地化开关。

> ⚠️ 本模组由 AI 生成（AI-generated）。

依赖：denikson-BepInExPack_Valheim-5.4.2350 + xtavim-BetterMap-1.1.0。

🔻 1.1.13 剔除了三条冗余注入（上游自己已经做了）

上游 BetterMap 连续几个版本把自己缺的东西补上了，本补丁同步收缩。 被判为冗余而删除的三条，理由都经过逐条核对（源码 + 真机日志）：

| 被删的注入 | 为什么删 | 依据 | |---|---|---| | Frost Caves（Mountain / MountainCave02） | 上游 1.0.4 起自己就有同名同群系的规则，注入必然被判重跳过 —— 纯死代码 | 真机日志一直打「规则 [Mountain] Frost Caves 已存在（原模组自己提供…），跳过。」 | | Soft Tissue（Mistlands / giant_brain） | 上游 1.0.6 新增 Giant Skulls（盯 Mistlands_Giant1，同为 Ore 分类、默认开），描述写明就是「黑大理石 + 里面的软组织」⇒ 功能完全重叠 | 上游 PINS.md：「Mistlands_Giant1 is the giant skeleton, skull and brain included. … It is pinned as a place because those pieces were never captured by name.」 | | Half Burried Crypt（BlackForest / HalfBurried_ForestCrypt） | 上游没有这条规则，但游戏地点表里它的 m_enable = False ⇒ 原版永远不会放置它，默认关 + 永不落钉 = 死配置 | 2026-09-18 用本补丁的 Dump Location Names 实测 |

> 重要：Frost Caves 的映射（Frost Caves=冰霜洞穴）仍然保留 —— > 上游那条规则叫同一个名字，图钉名仍会落到它上面。 > 「删注入」≠「删映射」：映射是按图钉名生效的，与规则是谁注入的无关。 > > 另外：想要「巨骨架/软组织」的图钉，保持上游 [Auto Pins - Mistlands] Giant Skulls = true（默认开）即可。

上游已有的开关 —— 本补丁配套建议关掉一个

下面这条属于上游自己的行为，本补丁不去改它、也不去删图钉， 而是在上游自己的 cfg（BepInEx/config/xtav1m.BetterMap.cfg）里关掉：

| cfg 键 | 建议 | 原因 | |---|---|---| | [Auto Pins - Mistlands] Giant Remains | false | 它盯的是骨与盔甲武器（giant_ribs / giant_helmet1-2 / giant_sword1-2），会把上古之剑、上古护甲、肋骨全钉出来。不要这些就关掉它 | | [Auto Pins - Mistlands] Entrance to the Queen | 上游 1.0.6 起默认就是 false，无需手动改 | 女王洞穴入口 —— 按游戏流程它该由女王指引石标记，不该再额外出一枚入口图钉 |

关掉之后：上游不再为它们落新图钉；地图上已存在的那几枚要你自己右键删（本补丁不代为删除）。

> 装不装本补丁都能这么关 —— 这跟补丁无关，是上游自己的配置。

与上游的边界（2026-09-24 对 BetterMap 1.1.0 重新核对）

上游在这些版本里陆续把自己缺的补齐了，本补丁随之收缩：

| 功能 | 上游现状（1.1.0） | 本补丁 | |---|---|---| | Boss 指引石落钉机制 | ✅ 1.0.4 已修（Rule.Component = typeof(Vegvisir) + 挂 Location 生成事件扫内部组件） | 迷雾之地那一段交给上游；自己的扫描器留作兜底 | | 迷雾之地的女王指引石 | ❌ 仍然没有 —— Vegvisirs 规则只有 Meadows / BlackForest / Swamp / Mountain / Plains / AshLands / DeepNorth | ✅ 补上 [Mistlands] Vegvisirs | | 女王洞穴入口（Entrance to the Queen） | ✅ 有，且 1.0.6 起默认关（它的描述写着「use a vegvisir and the game pins it for you」） | 无需处理（上游已按同样思路关掉） | | 冰霜洞穴 Frost Caves | ✅ 1.0.4 已有 | ❌ 1.1.13 起不再注入（纯死代码） | | 腐疫矿区 / 腐朽之穴 | ✅ 1.0.5 已有（Infested Mines / Putrid Holes） | ❌ 更早（1.1.3）已不再注入；映射保留（Infested Mines 无 NameToken，图钉名是英文） | | 软组织 / 巨骨架 | ✅ 1.0.6 新增 Giant Skulls（Mistlands_Giant1，Ore，默认开，描述含 "soft tissue from the brain inside"） | ❌ 1.1.13 起不再注入（同分类同位置，功能重叠） | | 半埋墓穴 Half Burried Crypt | ❌ 没有（且原版 m_enable=False，永不放置） | ❌ 1.1.13 起不再注入 | | 希尔迪三个地牢 | ❌ 有意不做 —— PINS.md：「Anything vanilla already pins is out of scope … traders, Hildir's camps, the bog witch…」 | ✅ 补上（默认全关） | | 图钉名中文化 | ❌ 没有（PinNames.For 三分支里没有任何本地化调用） | ✅ 本补丁的主要价值 |

> 所以：只装 BetterMap 1.1.0 而不装本补丁，迷雾之地女王指引石依旧不会出现在地图上， > 希尔迪地牢与图钉中文名也仍然缺。 > > ⚠️ 顺带一提：1.0.6 的 changelog 写着 "Entrance to the Queen is off by default. A vegvisir already pins it." —— > 那里的 "a vegvisir" 指的是原版游戏的指引石机制（用指引石后地图上出现 Boss 位置图标）， > 不是 BetterMap 的 Vegvisirs 规则。别把这两件事混起来。

⚠️ 一个容易看错的陷阱：Dvergr Town 不是腐疫矿区

上游规则表里有一条叫 Dvergr Town、描述写着 "The dvergr settlements out on the ash sea." 的规则， 光看名字很像"矮人要塞/矿区"。它实际是：

Prefabs   = ['CharredTowerRuins1_dvergr']   ← 灰烬之海的矮人据点
Biome     = AshLands                        ← 灰烬之地，不是迷雾之地
DefaultOn = false                           ← 默认还是关的

BetterMap 落钉要过群系过滤（Heightmap.FindBiome(位置) == 规则.Biome）， 所以它永远命中不了迷雾之地的 Mistlands_DvergrTownEntrance1/2。 这就是「规则名看着像、群系一票否决」的静默失效形态 —— 核对覆盖率时必须逐条比 prefab 名 + 群系， 不能看规则名。

为什么指引石标记不了（根因）