X光

隐藏地形、水体、云层、雾气或世界元素，让你能够透过它们看到其他内容：树木、岩石、资源、建筑部件、生物、地面物品等。

[size=6][b][color=#FFD479]演示[/b][/color][/size]

[size=6][b][color=#FFD479]图片[/b][/color][/size]

[img]https://i.imgur.com/NN8l7RU.jpeg[/img]

[img]https://i.imgur.com/PEPsAvw.jpeg[/img]

[img]https://i.imgur.com/LcCmlct.jpeg[/img]

[img]https://i.imgur.com/q2rP0xt.jpeg[/img]

[size=5][b][color=#FFA58A]视频[/b][/color][/size]

[youtube]JYvS0azG44U[/youtube]

[size=6][b][color=#FFD479]用法[/b][/color][/size]

按 [font=Courier New]F8[/font]（可配置）打开 GUI，或在新增的暂停菜单条目中点击 [font=Courier New]XRAYS[/font]。

注意：分类（建筑部件、生物、作物、草等）旨在对游戏内元素进行分类。但部分物品可能会被归入错误的分类，或者完全未被归入任何分类。

[size=5][b][color=#FFA58A]安装[/b][/color][/size]

[b]仅客户端[/b] --- 服务器上无需安装任何内容。

[size=4][b][color=#84E6C4]使用模组管理器（推荐）[/b][/color][/size]

使用 Vortex 或 Gale 安装该模组。

[size=4][b][color=#84E6C4]手动安装[/b][/color][/size]

[list=1]
[]安装 Valheim 的 BepInExPack 和 Jötunn。
[]将 [font=Courier New]XRays.dll[/font] 和 [font=Courier New]orax.XRays.names.yaml[/font] 复制到 [font=Courier New]Steam\steamapps\common\Valheim\BepInEx\plugins\[/font]。
[/list]
[size=5][b][color=#FFA58A]配置[/b][/color][/size]

所有选项都位于 [font=Courier New]BepInEx\config\orax.XRays.cfg[/font] 中（首次启动时创建，也可在游戏内通过 Configuration Manager 编辑 --- 这是一个单独的模组，其窗口通过 [font=Courier New]F1[/font] 打开）。

[size=4][b][color=#84E6C4]名称规则文件[/b][/color][/size]

某个分类按名称声明的内容 --- 与游戏对象名称进行匹配的子字符串、前缀和正则表达式，以及它让给其他分类的名称 --- 都存放在它自己的文件中，[b]且仅在该文件中[/b]：代码中完全不包含任何名称规则。模组将其作为 [font=Courier New]BepInEx\plugins\orax.XRays.names.yaml[/font] 提供，会依次在该位置、其自身程序集旁边以及 [font=Courier New]BepInEx\scripts[/font] 中查找，并在启动时将其复制到 [font=Courier New]BepInEx\config[/font]；实际读取的是 [font=Courier New]BepInEx\config[/font] 中的副本，并且在游戏运行期间每次该文件发生更改时都会重新读取。具体使用哪个文件由上方表格中的 [font=Courier New]Files[/font] → [font=Courier New]Name rules file[/font] 选项决定。

一个包含几个分类的文件可能如下所示：

[code]version: 0.1.0
ores:
nameContains:
- "copper"
- "silver"
nameMatches:
- "^giant(ribs|skull|sword)"
rocks:
nameExcludes:
- "copper"
- "silver"[/code]
一个分类有五个列表，每一个都与对象名称进行匹配：

[table]
[tr][th]列表[/th][th]作用[/th][/tr]
[tr][td][font=Courier New]nameContains[/font][/td][td]该分类声明的、不区分大小写的子字符串[/td][/tr]
[tr][td][font=Courier New]nameStartsWith[/font][/td][td]该分类声明的、不区分大小写的前缀[/td][/tr]
[tr][td][font=Courier New]nameMatches[/font][/td][td]该分类声明的正则表达式，在名称中[b]搜索[/b]匹配（[font=Courier New]^[/font] 和 [font=Courier New]$[/font] 用于锚定覆盖整个名称的模式）[/td][/tr]
[tr][td][font=Courier New]nameExcludes[/font][/td][td]让给其他分类的、不区分大小写的子字符串，矿脉就是这样被排除在岩石之外的[/td][/tr]
[tr][td][font=Courier New]nameExcludesMatches[/font][/td][td]以相同方式让出的正则表达式[/td][/tr]
[/table]
该文件是[b]唯一来源[/b]：文件中未包含的列表即为空，文件中未包含的分类则完全没有名称规则。分类由其键名命名 --- [font=Courier New]trees[/font]、[font=Courier New]ores[/font]、[font=Courier New]rocks[/font]、[font=Courier New]pickable[/font]、[font=Courier New]build[/font]、[font=Courier New]creatures[/font]、[font=Courier New]items[/font]、[font=Courier New]plants[/font]、[font=Courier New]spawners[/font]、[font=Courier New]clutter[/font]、[font=Courier New]locations[/font] --- 而任何不属于上述键名的键都会被写入日志，通常意味着拼写错误。

一个列表只属于一个分类：告诉 [font=Courier New]ores[/font] 它声明了什么，并不能阻止 [font=Courier New]rocks[/font] 声明完全相同的名称，因此双方都必须编写 --- 这正是 [font=Courier New]nameExcludes[/font] 的用途。

请将值写在[b]单引号[/b]之间：其中的内容不会被转义，因此正则表达式会保留其反斜杠，[font=Courier New]'^Rock\d+$'[/font] 只需写一次。在双引号之间，反斜杠必须写两次（[font=Courier New]"^Rock_\\d+$"[/font]），而 [font=Courier New]"\d"[/font] 会导致解析错误；完全不加引号的值也会按字面读取，但其内部的 [font=Courier New] #[/font] 会开始一个注释并将其截断。所匹配的名称是游戏对象的原始名称，当游戏克隆某个对象时，[font=Courier New]Rock_3(Clone)[/font] 也会被包含在内。

[size=6][b][color=#FFD479]杂项[/b][/color][/size]

我的 Valheim 模组的 GitHub 仓库：[url=https://github.com/orax-Valheim-mods/]https://github.com/orax-Valheim-mods/[/url]
描述使用 [url=https://www.nexusmods.com/site/mods/2506]MarkdownToNexusModsBBCode[/url] 生成。