炉石传说模组 · Windows 和 Linux · 任何模式

HS Friend Search

为炉石传说好友列表添加的搜索栏。打开列表,输入名字的一部分,只会保留匹配的好友。

在游戏客户端内运行。无需 Hearthstone Deck Tracker。免费开源,靠捐赠维持运转。

炉石传说 PC 版 · Linux 通过 Wine 运行(Lutris、Bottles、Steam/Proton)· Apache 2.0 · GitHub

最新版本 2026年10月24日 · 好友 · 好友请求 · 最近的玩家

搜索的工作方式

输入你记得的任何内容

ussua→DivussUA名字的任意一部分
rey→ReyzexUA, NeReyzex以其开头的优先
divusua→DivussUA每输入 3 个字母允许错 1 个
#2692→带有该编号的 BattleTag数字也可以

容错匹配的结果总是排在精确匹配之后。好友、好友请求和最近的玩家都会被搜索,搜索栏右端会显示匹配数量。

列表一打开就能用

搜索栏位于你自己的名字下方,样式与列表自带的标题一致,好友列表一打开就能直接输入,无需点击聚焦。

Esc清除搜索内容。搜索栏为空时,Esc 的作用与平常一样。关闭列表也会清除搜索内容。

打错字也能搜到,数字也行

从输入 4 个字母起,每输入 3 个字母允许错 1 个仍能匹配:divusua 可以找到 DivussUA。战网昵称的数字同样有效:#2692 可以找到使用该数字的好友。

安装

Windows

  1. 第 1 步点击上方按钮或从 Releases 下载 HSFriendSearch-Setup-1.0.1.exe。
  2. 第 2 步关闭炉石传说并运行安装程序。它会自动找到你的炉石传说文件夹;确认无误后点击“Install”。
  3. 第 3 步照常从 Battle.net 启动炉石传说。

卸载方法:Windows 设置 → 应用 → HS Friend Search → 卸载,或使用开始菜单中的对应条目。BepInEx 会一并移除,除非还有其他模组在使用它,或它本来就已存在。

Linux通过 Wine 运行炉石传说:Lutris、Bottles、Steam/Proton

  1. 第 1 步点击上方按钮或从 Releases 下载 HSFriendSearch-1.0.1-linux.tar.gz,并解压。
  2. 第 2 步关闭 Battle.net,然后在解压出的文件夹中运行 bash install.sh。它会在常见的 Wine 前缀中查找炉石传说,也可以手动指定路径:bash install.sh "/path/to/Hearthstone",并设置 BepInEx 所需的 Wine DLL 覆盖。
  3. 第 3 步照常从 Battle.net 启动炉石传说。

卸载方法:运行 bash uninstall.sh。

更新说明

v1.0.1

Fixed a few visual bugs:

1. The search's query could sometimes stay on screen after friends list is dismissed, now shouldn't. 2. The rows could duplicate after a search and chat with the player, which could cause update on invite issues and see-through invite states, should also no longer be the case. 3. The "Search" prompt on empty field could sometimes get overlaid with the real search after the field got unfocussed(selecting a friend, skimming through searched list etc.), now stays hidden correctly.

在 GitHub 上查看此版本

常见问题

它需要 Hearthstone Deck Tracker 吗?

不需要。它是针对炉石传说客户端本身的模组,由 BepInEx 加载,无论是否安装了 HDT 都能运行。如果你的炉石传说还没有 BepInEx,安装程序会一并装上;已有的则保持原样。

这样做被允许吗?

这是一个非官方的客户端模组,暴雪并不提供支持。它所依赖的加载器 BepInEx 处于炉石传说使用条款的灰色地带:暴雪从未对这类工具采取过限制措施。

它会把我的数据发送到别处吗?

不会。截至 2026年11月8日,该模组完全没有联网代码:它只是对游戏已经显示给你的好友列表进行筛选。

炉石传说更新补丁后,搜索栏消失了

补丁可能会使该模组失效,直到新版本发布。要检查它是否已加载,请在炉石传说文件夹的 BepInEx\LogOutput.log 中查找 HS Friend Search loaded。