Pin 助手

喜欢这个模组？欢迎捐助！

这是我的 Ko-fi 页面！
你也可以通过 PayPal.me 进行捐助！

我考虑在这里添加一个捐助页面，但请记住，你没有义务捐款。
我对国外钱包了解不多，只知道 PayPal 和 Ko-fi，如果你有其他建议，请告诉我！

预览

模组介绍

厌倦了手动标记物品，只想一键解决问题？或许你更希望自动标记你目光所及的物品。你发现了一个感兴趣的物品，打算稍后回来取，却因为懒得标记而弄丢了？需要蒲公英或蓟来酿造药水，但因为现在正在寻找而变得难以找到？也许你忘记了在哪里挖到那块铜矿，因为它与环境融为一体而再也找不到了。

Pin Assistant 是你期待已久的变革性模组。它是所有冒险者、探索者、工匠、采集者和农场主的终极解决方案，让你无需繁琐的手动标记物品，就能保持井然有序。

确保你专注于对你最重要的事情。无论是用于魔法药水的稀有草药，还是用于制作的宝贵资源，你的 Pin Assistant 都会为你完成追踪工作。

用户友好设计

专为休闲玩家和技术型玩家量身定制，他们希望精确修改自己的标记，使其完全符合自己的需求。不知道该怎么做？只需看着一个物品，按下 Y 键，它就会自动为你填写数值，然后点击“追踪”。

可定制标记

根据你的特定需求定制你的 Pin Assistant。
自定义条目的显示方式：Boss 图标？火焰？标记是否划掉？甚至颜色！轻松区分不同标记，让你不再纠结于眼前的标记究竟是什么。

可定制行为

自定义你的条目，选择它想要做什么。只搜索特定物品，在一个条目上标记多个物品，在退出游戏时删除与条目相关的标记，等等！
众多配置组合等你来探索！

轻量级插件

高效的自动标记和追踪系统
即使你可能认为这是一个相当重量级的系统，因为它具有复杂的逻辑。但事实并非如此，除了 Valheim 的标记系统，这就不归我管了。不过，彩色系统的性能取决于你拥有的彩色标记数量，但这真的可以忽略不计（我已经尽力优化了很多）。如果你担心性能，可以在设置中增加更新频率，但其实性能影响也是微不足道的。
技术性内容：系统大部分使用字典，尤其是追踪条目系统使用了 TrieNode 字典，这意味着当模组有一个物品需要遍历条目列表进行检查时，不会损害性能（想象一下在电脑上搜索时使用的自动补全系统）。

功能

GUI

一个 Valheim 风格的 UI，让你轻松管理追踪的物体。

自动标记

懒得自己创建标记？没问题！只需为某个物品创建一个条目，这个模组就会为你完成一切。

手动模式/快速标记

不喜欢自动标记功能？没关系！你可以禁用它，然后使用“标记物品”快捷键。不过，请确保在使用标记快捷键之前先追踪该物品！

ID 过滤器

你还可以设置条目只查找与你设定名称完全相同的物品，这意味着你可以选择你想要标记的具体物品变种类型。Crypt1？Crypt2？或者如果你想要所有变种，只需将 ID 设置为 Crypt。

黑名单

然而，这意味着 Sunken Crypts 也会被包含在检测中，这就是需要黑名单功能的地方。将 'sunken' 添加到具有 crypt ID 的条目中，这样该条目就只会标记非 Sunken Crypts 的 Crypt。

冗余功能

如果你认为标记会因为物体聚集而变得杂乱，你可以更改冗余设置，以避免在基于已标记物体的特定距离内标记相似的物体。

彩色标记

看到众多难以区分的标记？借助本模组的追踪系统，你可以将标记更改为不同的颜色！由于限制，标记的颜色基于它们的标记名称。

可搜索标记

地图太拥挤？想找到特定的标记？只需前往你的地图，查看左上角并进行搜索，使用双引号可以精确搜索标记名称。你还可以将其设置为白名单模式，以隐藏除搜索内容之外的所有内容，或显示除搜索内容之外的所有内容。如果你想要更灵活的搜索标记方式，还支持正则表达式（RegEx）！
搜索窗口太遮挡视线？只需按一下“Tab”键即可隐藏它！如果根本不想看到它，只需前往你的配置管理器并禁用“启动时显示搜索窗口”！

批量标记修改

你是不是发现实际上有不止一个浆果丛，而且你所有的浆果标记都太模糊了？别担心，你可以在搜索窗口或现有的追踪物体条目中进行修改。你还需要更改图标吗？你也同样可以做到！

可分享的条目！

如果你安装了配置管理器，你可以打开菜单，复制本模组部分最后的字段，将整段文字发送给你的朋友，然后按重新加载键。你和你的朋友就拥有了相同的条目！不过，它不会复制你已经创建的标记。

模组兼容性

这是一个非侵入性很强的模组，因此任何与标记相关的模组都不应该导致游戏崩溃，但根据模组的行为方式，可能会存在一些冲突。请报告，以使模组更加非侵入性。
我已确保兼容的模组：

• Pinnacle（我强烈推荐，它可以提供更多修改标记的功能范围）
• UnderTheRadar

如何使用

假设你想追踪铜矿脉，

• 看着铜矿脉按下 GUI 键（默认：Ctrl + T）以预填正确的值，
• 铜矿脉的 ID 叫做 MineRock_Copper(Clone)，
• 你可以保持原样并按下“追踪”，或者如果你想追踪所有可开采的物体，
• 将 ID 设置为 MineRock 以追踪锡矿、陨石、铁矿、黑曜石和石头，但你不想包含石头，没问题！
• 前往黑名单字段并输入 'stone'，这样，具有 MineRock 名称的物体将被标记，但如果其名称中包含 Stone，则会被排除。
• 如果你希望所有这些物体的命名约定不完全相同，那么你需要为它们每个都设置不同的条目，但如果你比较懒，只需等待你想要的物体出现，看着它按下 GUI 键，然后按下“追踪”或“回车”键！

安装（手动）

我猜和其他模组一样，将内容解压到 Bepinex 的 Plugins 文件夹中。
更多细节： PinAssistant

• 点击“Manual”下载
• 内容包含 plugins 文件夹和其他一些文件。
• 将它们全部放入 BepInEx 的 plugins 文件夹中一个新文件夹里，你可以自己命名，比如“Pin Assistant”
• 完成

Json.Net

• 点击“Manual”下载
• 内容是一个名为“plugins”的文件夹，只需将其合并到你的 BepInEx 文件夹即可。
• 完成

Jotunn

• 点击“Manual”下载
• 内容是一个名为“Jotunn”的文件夹，只需将其放入你的 BepInEx 的 plugins 文件夹即可。
• 完成

Config Manager

• 点击“Manual”下载
• 内容是一个名为 ConfigurationManager 的单个 dll 文件，只需将其放入你的 BepInEx 的 plugin 文件夹，或者在“plugins”文件夹中创建一个新文件夹，例如“ConfigManager”，然后将其放入。（BepInEx > plugins > [newFolder] > ConfigurationManager.dll
• 完成

开发者介绍

这是我的第一个涉及编码的游戏模组。我制作这个模组是作为一个像 Locator 一样的自动标记功能，但发布后，我想，“嘿，这个插件似乎不仅仅以自动标记为主要功能。因为你也可以将追踪物体用作物体配置，通过按快捷键轻松标记物品，而无需更改图标和命名等，所以我在发布前将其从 Auto Pin 更名为 Pin Assistant。”

在 modding Valheim 的过程中，我学到了很多东西，并从使用某些库等方面获得了丰富的经验。编程这个模组是一次非常富有成效的旅程，我希望你喜欢！我大约在 9 月 2 日午夜开始制作，所以这个模组花了大约两个半星期的时间，中间有些天因为懒得理解新的 API 来让我的模组工作而休息了一下。咳嗽 GUI 很烂 咳嗽。

我制作这个模组是因为像 HotPin 或 Locator 这样的自动标记模组存在插件问题。Locator 的控制台命令有问题，而 HotPin 则直接不让你打开控制台。我发现 Purps 的 Locator 相当不错，但在追踪自定义物体方面不够用户友好，缺少一些功能，但还算不错，所以我想到了自己的主意。

如果没有像 Locator、Pinnacle、PressurePlate 和其他插件那样的众多源代码，我很难制作这个模组，因为它引用了大量来自它们的 Valheim 代码，主要是 Locator，但像字典这样的逻辑大多来自 Google :v
另外，感谢那些帮助我搭建环境开始这个项目，或为我提供遇到困难的信息的模组开发者。

技术信息

有建议吗？

你可以通过 Discord 联系我，ID 为 'WxAaRoNxW'，在 Nexus 发帖，或在 Github 上添加“New Issue”。

已知问题

请查看这些页面：

• Nexus
• Github

如果你遇到问题，可以在这些页面之一提交问题。