THE HUNT · 使用说明
The Hunt / 使用说明
Bloodborne PC 无缝联机启动器

The Hunt 使用说明

安装、配置、联机、开服、存档与常见问题。

首次配置 →连接已有服务器常见问题
6 个启动器主页面33 项功能本地开服与账号管理

解压位置示例

可以把 TheHuntLauncher 完整解压到与 bbport-windows、CUSA03173 同一级的独立文件夹中，三个文件夹并排放置。

这是推荐的摆放方式；也可以放在其他位置，配置时选择各文件的实际路径即可。

阅读提示先看“第一次使用”；左侧可直接找页面或搜索按钮。图片支持放大，长页面可展开分段图。示例账号、地址与点亮记录不可直接用于联网。
01

第一次使用：从下载到进入游戏

先选适合你的路线，再跟着完成路径、账号和联机配置。

你要做什么谁来开服从哪里开始
加入朋友已有的服务器服务器管理员负责运行服务。你只运行客户端。按本章配置，然后看四项地址与账号。
两个人自己开服只需选一台可互通的电脑运行服务，两台各开游戏。先看本地开服，再给每人建立不同账号。
管理已有云服务器管理员维护云端服务，玩家填写其连接信息。普通玩家用地址；管理员按需看云端管理。
  1. 先让自己的 BBport 普通版能正常运行。准备自己的 CUSA03173 1.09 游戏文件，以及 BBport 1.9.7 对应普通版。
  2. 从项目 Releases下载 TheHuntLauncher-…-windows-x64.zip 完整客户端，完整解压到一个新目录。仅作为玩家，不需要下载独立服务端或源码包。
  3. 双击 TheHuntLauncher.exe。完整包自带运行环境；若提示缺少 VC++ x64 运行库，可运行包内 prerequisites/VC_redist.x64.exe。
  4. 打开「游戏与联机」，选择本机三个文件：普通版 Bloodborne.exe、游戏 eboot.bin、普通版 bbport.ini。详见路径截图。
  5. 填管理员提供的四项完整地址和私服联机账号。每个玩家用自己的账号，两人填同一套服务器地址。
  6. 需要公共笔记、血迹等内容时，启用公共在线并填写自己的 SuperMedo 账号；这与私服账号分开。点击「保存设置」。
  7. 第一次先使用推荐玩法设置，点击「启动游戏」。首次创建无缝环境会从普通版复制一份存档，之后两边进度独立。
  8. 双方进入各自角色：游戏房主使用「唤猎之铃」，客机使用「应猎之铃」。等待匹配、加载和入场完成，再开始移动。

开服电脑、房主和客机的区别

身份负责什么会不会自动成为游戏房主
开服电脑 / 云服务器持续运行匹配、认证、游戏 API 和 Relay 等服务。不会。它可以只开服、不运行游戏。
游戏房主在自己的角色世界中召来其他玩家，决定当前世界进度和互伤状态。由游戏里的召唤角色决定。
客机 / 应召者加入房主世界共同探索，结束后回自己的世界。换人召唤时可以交换主客身份。
02

开始游戏：首页和底部按钮

首页用于核对当前身份、配置摘要和启动状态。

首页全貌① 画面配置摘要；② 私服联机身份与地址；③ 奖杯入口；④ 底部运行状态与日志。截图中的 hunter01 是示例账号。
区域 / 按钮怎么理解、怎么用
左侧六个页面「开始游戏」返回首页；其余分别进入游戏与联机、功能与玩法、本地与云端开服、奖杯和存档。切换页面本身不会保存尚未保存的设置。
使用说明 ↗左侧底部的说明书入口，配置网址后会用默认浏览器打开。本次开发稿尚未配置 Cloudflare 地址，按钮暂不可用；已发布的 preview.20 尚无此入口。
画面与操作显示所选普通版配置的部分摘要。实际画质、帧率和按键配置从本机普通版读取；需要更改时先在普通版调整并保存，再启动 The Hunt。
联机身份显示本机填写的私服账号与合作服务器。与朋友核对地址时以「游戏与联机」中的完整四项为准；摘要不是一次联网成功证明。
奖杯 · N / 40点击进入奖杯页。计数来自该无缝环境的实际奖杯记录，包含所有角色，不是当前角色 Boss 进度推算。
准备事项 / 猎具状态 / 功能摘要提示首次存档复制、猎具初始化、共享进度和难度的当前配置。猎具准备还需等游戏参数加载，首页文案不等于道具已经发入背包。
启动游戏 →先完成路径、四项地址和账号保存，再点击。运行中会显示状态；启动失败请看下方提示和日志。不要连续多次点击启动。
底部状态栏显示当前操作、保存和世界核对进度。退出游戏后等后台处理结束，再关闭启动器或执行存档操作。
打开日志目录 ↗进入当前安装目录对应的日志位置。报告问题时先确认自己实际从哪个 TheHuntLauncher.exe 启动。
检查更新打开更新窗口。主界面发现新版时按钮文字可变更；后台检查不会自动下载或安装。详见更新说明。
03

游戏与联机：三个文件路径

三项都选择本机真实文件；每台电脑的路径可以不同。

游戏与联机 · 路径及私服地址① 普通版核心入口；② 游戏入口；③ 本机普通版配置；④ 下方继续填写私服服务地址。右侧「选择」打开文件选择器。
先分清这三个文件
局部放大 · 先分清这三个文件The Hunt 的启动入口与这里选择的普通版核心入口不同。不要把 TheHuntLauncher.exe 选进第一项。
字段应该选择什么常见填错
普通版启动程序 · Bloodborne.exe本机 BBport 普通版目录内的 Bloodborne.exe。按钮选择后，如果同目录有 bbport.ini，会自动填入配置路径。选成 Play Bloodborne.exe、TheHuntLauncher.exe 或已经解压的另一个测试副本。
游戏文件 · CUSA03173 1.09 / eboot.bin自己的 CUSA03173 1.09 游戏目录内 eboot.bin。选择文件，程序再据此确定游戏目录。选到其他区版、其他游戏版本，或 data/out 里的 eboot.elf。
本机画质配置 · 普通版 bbport.ini平时游玩的普通版实际使用的 bbport.ini。可从普通版高级页面定位。选到旧副本配置，导致分辨率、帧率或按键与预期不一致。
04

游戏与联机：私服地址和账号

服务器地址、私服账号、公共账号和游戏匹配密码各有用途。

四项地址怎么填

界面字段填写格式负责的事情
shadNet 合作服务器192.0.2.10:31413私服账号会话与匹配；这里是主机和端口格式。
shadNet WebAPIhttp://192.0.2.10:31415私服认证接口。保留管理员提供的 http:// 或 https://。
BBSC 游戏服务http://192.0.2.10:20443无缝需要的游戏在线 API。不要与公共账号服务地址互换。
BBSC Relay192.0.2.10:20444模组状态和传送等消息。按本字段主机:端口格式填写。

端口以管理员提供的完整值为准。上表是本地包常用端口的示例，不能用它替代真实服务器信息。同一服务器可以有不同端口的不同用途，四格都要核对。

私服账号与公共账号所在位置上方的「联机账号 / 密码」属于所填私服；下方框内属于 SuperMedo 公共内容。两套账号分别保存。
字段 / 动作说明
联机账号由你填写的私服创建。例如本地开服时到「联机账号」页为两人分别创建 hunter01、hunter02。账号属于具体服务器，换服不保证还能使用原账号。
密码 · 已保存时留空即可首次保存、换账号或换电脑时填写私服密码。本机已保存且账号不变时可留空；密码使用当前 Windows 用户加密保存。
保存设置填写完成后点击。会保存路径和网络配置，并保存本次新填的密码；成功后回首页。不要把点击「启动游戏」当成保存按钮。
移到另一台电脑分别填写该电脑自己的文件路径和账号密码。请分发干净安装包，避免把使用过的整个目录给朋友。

这几种账号和密码别混用

名称在哪使用是否必须两人相同
私服联机账号 / 密码The Hunt「游戏与联机」上半部分。每位玩家使用自己的账号。
SuperMedo 公共账号 / 密码公共在线内容框，服务于公共笔记、血迹等。每位玩家使用自己的账号。
游戏内匹配密码游戏自身网络设置中，用于缩小匹配范围。建议朋友之间设成相同值。两边空密码也能匹配，但不是私人专用匹配。
SSH 管理员身份「本地与云端开服」的云端区域，用于管理服务器。普通玩家无需填写；它不是游戏联机账号。
05

游戏与联机：SuperMedo 公共在线

公共内容与私服无缝合作分开配置。

公共在线框与保存按钮勾选后填写公共账号和密码；「验证并保存账号」只针对这一套公共凭据。「保存设置」仍用于整体设置。
选项 / 按钮作用和操作
使用 SuperMedo 公共在线内容启用后公共笔记、血迹和游魂使用公共服务；四项私服地址仍保留，用于无缝合作。公共服务出错会明确提示，不会静默切到另一池。
公共账号 · SuperMedo Online ID填写自己的 SuperMedo 账号。没有账号可先在普通版启动器注册；Discord 不是必需登录方式。
公共密码 · 已保存时留空首次或更换账号时填写；保存后本机会在启动时重新认证，不需要每次重新手填。换 Windows 用户或电脑后需要重新填写。
验证并保存账号先验证这套公共账号并保存。验证时请确保该账号没有在另一个游戏进程使用；提示占用时先正常退出那个进程。
忘记公共账号删除本机保存的公共凭据并清空字段，不会删除 SuperMedo 服务器上的账号，也不会删除角色存档。
关闭公共在线使用所填私服自己的独立公共内容池，仍保留私服无缝合作。这不等于接入 SuperMedo 公共内容。
06

功能与玩法：先用推荐，再了解每项

保存后在下一次启动生效；灰色的基础功能固定启用。

玩法设置与开服设置的区别

设置类型由谁控制在哪里设置
提灯同行、客机拾取、永久共享进度等各玩家自己的客户端模组。各自启动器的「功能与玩法」。
多人血量、伤害等难度数值游戏房主；合作时同步给客机。游戏房主启动器的「功能与玩法」。
服务启停、连接地址、联机账号开服电脑或云服务器的管理员。Windows 本地开服窗口或云服管理。
功能页分组总览① 保存功能设置；② 恢复推荐；③ 展开全部。六个分组可独立展开，表格在下方逐项说明。
按钮 / 状态怎么用
保存功能设置将当前配置写入本机；更改仅在下一次启动游戏时使用。当前游戏里的状态不由这里实时切换。
恢复推荐先把推荐值填到界面，还需点击「保存功能设置」才写入。不会撤销已经合并进存档的永久进度。
展开全部展开各组，便于查找；再次操作可收起。它不改变任何玩法选项。
有未保存的功能变更先保存，或恢复推荐后保存，再启动游戏。
人偶洗点提示无缝版当前关闭洗点。若在普通版洗点，先完成全部等级分配并正常保存，再按存档页说明整体导入；导入会替换无缝全部角色进度。
07

合作与探索：逐项说明

本组所有项目、推荐值和作用范围。

合作与探索分段截图4 张分段图
合作与探索分段截图 · 1/4展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
合作与探索分段截图 · 2/4承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
合作与探索分段截图 · 3/4承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
合作与探索分段截图 · 4/4承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
项目默认 / 推荐作用范围详细说明
无缝召唤开启基础功能，固定启用使用 BBSC 的召唤流程；需要双方连接兼容的无缝服务器。
无缝合作基础开启基础功能，固定启用传送、世界同步、死亡后保持联机等功能的基础。
跨区域召唤开启本机，下次启动生效先建立连接，再把应召者带到房主所在地图。
提灯同行开启本机，下次启动生效房主通过提灯传送时，应召者跟随前往。
房主发起传送，客机等待跟随完成；客机不是自行操作房主梦境提灯。
世界状态同步开启本机，下次启动生效联机中呈现房主的门、捷径、升降梯和 Boss 状态；永久继承另由共享进度控制。
同步当前房主世界的状态，与永久合并进客机存档是两件事。
共赴猎人梦境开启本机，下次启动生效允许应召者在梦境中使用人偶、工坊与信使等设施。
解除合作区域雾墙开启本机，下次启动生效放宽合作时的区域边界；Boss 场景的表现仍需实际验证。
合作时使用提灯开启本机，下次启动生效允许房主在联机期间操作提灯。
房主死亡后保持联机开启本机，下次启动生效房主死亡时继续维持合作会话。
保留合作不代表不会发生死亡、掉落或加载；具体复活表现按游戏实际状态。
死亡后留在会话开启本机，下次启动生效死亡后进入模组的复活／观战流程，避免被送回单人世界。
死亡后不要立即强退窗口，让会话按当前规则处理。
08

角色与收益：逐项说明

本组所有项目、推荐值和作用范围。

角色与收益分段截图3 张分段图
角色与收益分段截图 · 1/3展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
角色与收益分段截图 · 2/3承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
角色与收益分段截图 · 3/3承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
项目默认 / 推荐作用范围详细说明
客机获得完整回响开启本机，下次启动生效应召者按房主倍率获得血之回响。
取消客机生命削减开启本机，下次启动生效移除普通召唤对客机最大生命的削减。
客机拾取与保留物品开启本机，下次启动生效应召者可拾取并保留物品，按角色记录已拾取状态；与 Boss 进度合并分开。
属于个人拾取处理，关闭永久共享进度不会撤销已拾取物品。
NPC 实体显示开启本机，下次启动生效让应召者看到实体 NPC，避免以灰色幽灵显示。
不保证能修复上游或存档本身已有的所有 NPC 模型异常。
死亡掉落回响开启本机，下次启动生效维持血源的血痕与回响掉落惩罚。
摇铃不消耗灵视开启本机，下次启动生效BBSC 铃铛召唤无需支付灵视。
09

战斗与人数：逐项说明

本组所有项目、推荐值和作用范围。

战斗与人数分段截图2 张分段图
战斗与人数分段截图 · 1/2展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
战斗与人数分段截图 · 2/2承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
项目默认 / 推荐作用范围详细说明
最多五名猎人开启本机，下次启动生效模组支持一名房主加四名客机；五人会话尚未完成实测。
最多人数上限，不要求凑齐五个人；五人完整流程仍待专门验收。
开放入侵开启本机，下次启动生效控制符合状态的本机单人／房主世界能否被入侵；主动入侵仍使用渴血之铃，与纷争之铃的队友互伤分开。已收到玩家入侵实测反馈。
与队友互伤分开。渴血之铃用于主动入侵，是否入房仍取决于匹配和网络。
队友互伤与切磋游戏内操作游戏内控制，启动器不改写实时状态每次启动初始为关闭。只有房主摇响纷争之铃能切换互伤；客机摇铃只提示由房主控制。切换互伤不停止招募，需要时用空枪手动停止。
2026-11-03 整合候选改为仅房主控制，并与招募独立；该候选待双机验收。
10

多人难度：逐项说明

本组所有项目、推荐值和作用范围。

多人难度分段截图4 张分段图
多人难度分段截图 · 1/4展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
多人难度分段截图 · 2/4承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
多人难度分段截图 · 3/4承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
多人难度分段截图 · 4/4承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
项目默认 / 推荐作用范围详细说明
多人敌人强化开启本机，下次启动生效根据客机人数强化敌人与 Boss；替换原版 Boss 合作强化。双方应保持开启以跟随房主数值。
额外强化敌对 NPC 猎人关闭本机，下次启动生效是否把额外难度缩放用于亨里克、久拉等敌对猎人。推荐关闭。
小怪血量增幅40%由房主同步 · 每名客机的百分比每增加一名客机的额外血量百分比；由房主同步给客机。
Boss 血量增幅100%由房主同步 · 每名客机的百分比每增加一名客机的额外血量百分比。默认双人时为单人血量的两倍。
敌人伤害增幅15%由房主同步 · 每名客机的百分比每增加一名客机的敌人及 Boss 额外伤害百分比。
小怪抗硬直增幅15%由房主同步 · 每名客机的百分比每增加一名客机的抗硬直增幅百分比。
Boss 抗硬直增幅20%由房主同步 · 每名客机的百分比每增加一名客机的抗硬直增幅百分比。
小怪与 Boss 的难度输入
局部放大 · 小怪与 Boss 的难度输入这两项默认分别为 40、100。其他伤害和抗硬直项继续向下查看；合作期间由房主同步。
11

存档与展示：逐项说明

本组所有项目、推荐值和作用范围。

存档与展示分段截图2 张分段图
存档与展示分段截图 · 1/2展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
存档与展示分段截图 · 2/2承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
项目默认 / 推荐作用范围详细说明
永久共享世界进度关闭本机，下次启动生效客机归返后，将房主已完成的 Boss、门、捷径及提灯进度追加到客机自己的无缝存档，可能包含房主过去完成的部分。开启后不会因再次关掉而撤销。NPC 支线另行保留。当前推荐关闭。
只适合专门的合作角色；首次开启会确认，关闭后不能撤销已合并进度。
Discord 游戏状态关闭本机，下次启动生效在 Discord 个人资料展示区域、Boss 战及猎人人数。只影响状态展示，与联机账号认证分开。
12

联机与保护：逐项说明

本组所有项目、推荐值和作用范围。

联机与保护分段截图3 张分段图
联机与保护分段截图 · 1/3展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
联机与保护分段截图 · 2/3承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
联机与保护分段截图 · 3/3承接上一张继续向下。展开这一组后向下滚动即可找到表格中的同名项目。界面上方的保存按钮始终用于整页功能设置。
项目默认 / 推荐作用范围详细说明
无缝联机中文提示开启本机，下次启动生效使用适合无缝合作的提示和本包中文文本。
加入时加载遮罩开启本机，下次启动生效加入和跟随加载时使用黑色过渡，遮住尚未准备好的场景。
地图地面保护开启本机，下次启动生效为角色脚下地图暂未加载的情况提供保护，推荐开启。
玩家间模组通信开启本机，下次启动生效通过游戏连接传递模组消息，作为 Relay 的补充。
连接异常时先核对网络与 Relay，避免为排错随意关闭基础通信。
BBSC Relay 地址填写连接目标连接目标，在游戏与联机页设置在「游戏与联机」中配置。修改这里的连接目标不会修改远端服务器。
13

本地与云端开服：启动器里的入口

只想加入朋友时，不需要自己再开一套服务。

本页管理服务连接与账号。提灯同行、拾取和难度等玩法在各玩家自己的「功能与玩法」中设置；实际游戏房主不由开服电脑决定。

开服页面上半部分① 打开独立本地管理窗口；② 读取本地管理器已保存的地址并填入客户端；③ 下方是已有云服务器的管理员入口。
按钮用途和下一步
打开本地开服管理打开包内 server/Server.exe。打开窗口本身不会开服；接着选本机地址并启动服务。
填入本机服务地址读取本地开服管理器保存的监听地址，填入客户端四格。只填地址，不改账号、密码、SSH 或存档，也不会自动保存。填完回「游戏与联机」核对并保存。
14

本地开服：连接信息页

一台电脑开服，两位玩家各用不同账号连接。

本地开服管理 · 连接信息① 选择这台开服电脑的地址；② 启动 / 停止服务；③ 四项地址与单项复制；④ 复制全部连接信息。示例地址不可用于联网。
  1. 点击「本机地址 ▾」，选择朋友能够访问的本机 IPv4。使用同一局域网或 Tailscale 等组网时，选择对应网卡地址。
  2. 点击「启动服务」，等待状态变为已就绪。首次初始化后到「联机账号」为每个人创建独立账号。
  3. 点击「复制全部连接信息」，把四项地址提供给同伴。同机客户端也可用启动器的「填入本机服务地址」，再自行填写账号并保存。
  4. 双方启动游戏并完成实际入房，才算这次联机路径可用。结束游玩后在管理窗口停止服务。
区域 / 按钮详细说明
本机地址输入框 / 本机地址 ▾填写的是开服电脑自己的地址。不要填朋友的地址。127.0.0.1 只能供同一台电脑连接；同伴应使用可达的局域网或 VPN 地址。运行中要先停止服务才能改监听地址。
启动服务运行本地的无缝服务；状态尚未就绪时先看底部错误或日志，不要反复开多个管理窗口。
停止服务停止由本窗口启动的服务，账号和数据保留。游玩中停止会影响正在使用该服的玩家。
四项只读连接地址 / 每行复制依次对应合作服务器、WebAPI、BBSC 游戏服务和 Relay。复制到客户端对应格，保留协议和端口；不要按同一个格式自行改四项。
复制全部连接信息复制一整套带名称的地址，便于发给同伴。它不包含账号密码。
检查更新更新 Windows 本地开服程序；先停止服务。与启动器共用发布仓库，但选择各自的安装包。
日志打开这份本地服务的日志位置，用来核对服务启动、错误与退出。
备份打开本地账号管理操作生成的数据库备份。它不是玩家角色存档备份。
关闭管理窗口会停止该窗口自己启动的服务；外部窗口占用时不会强制接管别人的进程。
地址情形如何理解
127.0.0.1仅本机。另一台填写它会连接到另一台自己，无法代表你的开服电脑。
局域网地址同伴需要与这台电脑的该地址互通。跨网络时还要处理相应路由、端口或组网。
Tailscale / 其他 VPN 地址先保证两台机器组网互通，再选择其实际地址。路由器装了组网工具，不自动等于 PC 的所有游戏 UDP 路径都已可用。

内置服务端常用端口：TCP 31413、31415、20443、20444，UDP 31414。工具不会自动修改防火墙或路由器；玩家间的 UDP / STUN 路径也需可达。

15

本地开服：联机账号页与弹窗

这些操作管理私服账号，不是角色名字或 SuperMedo 公共账号。

本地开服管理 · 联机账号示例列表中两人分别使用 hunter01 / hunter02。先选中目标行，再执行对应操作；按钮是否可用取决于服务状态。
按钮 / 列使用条件与影响
ID / 账号 / 邮箱字段 / 状态显示当前私服的账号资料。邮箱字段用于账号标识，不是角色存档；不要据此判断游戏进度。
新建账号先启动服务，再新建。账号 3–16 位英文字母、数字、下划线或连字符；每个玩家建立不同账号。
改名先停止服务并选中账号；只改登录名，账号 ID 和密码保持不变。修改后客户端需改成新名称。
重置密码先停止服务并选中账号；输入两次新密码。客户端下次保存时填写新密码。
验证密码选中账号，输入密码进行短暂验证。先退出该账号在各台电脑上的游戏，避免占用。验证不是修改密码。
删除账号先停止服务，选中目标并输入完整账号名确认。只删除该模式的联机账号，不删除本地玩家角色存档。操作前会备份数据库。
刷新重新读取账号列表，不创建或修改账号。
取消 / 确认取消关闭弹窗，不提交；确认前核对当前账号、操作类型和字段。密码两次不同或格式错误时会在弹窗提示。
新建账号：字段逐项看1 张弹窗示例
新建账号弹窗填写账号、可选邮箱、密码和重复密码。邮箱留空可自动生成，不发送验证邮件。最后确认才会提交创建。
改名、重置、验证与删除4 张弹窗示例
修改账号名顶部先确认当前账号和 ID；只输入新账号名。ID、原密码不随改名改变。
重置密码确认当前账号，填写新密码并重复输入。完成后在客户端更新保存的密码。
验证密码只输入该账号现有密码验证；不是注册，也不是给角色修改属性。
删除账号输入完整账号名才允许确认。先选中正确账号，保留数据库备份；本图只展示弹窗，没有执行删除。
16

已有云服务器：SSH 管理区域

只有负责管理已有服务器的人需要填写。普通玩家向管理员索取四项地址即可。

云端管理分段截图3 张分段图
云端管理分段截图 · 1/3第一段是本地入口与 SSH 开头；向下继续是连接凭据位置、新建或验证账号以及只读状态列表。
云端管理分段截图 · 2/3承接上一张继续向下。第一段是本地入口与 SSH 开头；向下继续是连接凭据位置、新建或验证账号以及只读状态列表。
云端管理分段截图 · 3/3承接上一张继续向下。第一段是本地入口与 SSH 开头；向下继续是连接凭据位置、新建或验证账号以及只读状态列表。
字段 / 按钮详细说明
刷新云端状态与账号通过已有 SSH 连接读取服务状态和账号摘要。查看不改服务或账号；它不是创建云服务器或首次部署按钮。
SSH 别名或 用户@主机填写已有 SSH 配置的别名，或管理员用户与服务器。示例 root@server.example 不可直接使用。
SSH 端口默认 22，按实际服务器填写，范围 1–65535。与游戏服务端口是两回事。
BBSC Compose 部署目录填写服务器上实际的 /opt 部署目录，例如 /opt/thehunt；不是本机启动器路径。
本机 SSH 私钥路径 / 选择可指定本机已有私钥；留空使用 SSH 配置或代理。私钥属于管理员凭据，不发给普通玩家。
可信 known_hosts 文件 / 选择可指定自己核对过的主机指纹记录；留空用 SSH 默认记录。首次先在终端核对指纹，加密私钥先加入 ssh-agent。
远端使用 sudo -n按已有服务器权限选用；root 通常不勾。需要远端已允许的无交互 sudo，不会帮你绕过权限或输入提权密码。
账号名新建 / 验证的私服账号，3–16 位字母、数字、下划线或连字符。不是 SSH 用户名。
密码仅用于这次新建或验证，不保存为 SSH 密码或客户端登录密码。
邮箱标识新建时填写格式有效且未重复的邮箱标识。云端入口与本地弹窗的“邮箱可留空”不是同一套校验。
新建账号确认后在指定服务器创建，先备份数据库，再注册并验证。核对目标主机及账号。
验证账号密码会短暂登录这个私服账号验证；先退出该账号在所有电脑上的游戏。
服务器状态 / 账号列表显示服务和账号摘要，不显示密码、盐值或令牌。当前入口不提供删号、改名或重置密码。
17

进入游戏：五件猎具与正常结束

先让双方处在兼容版本、同一服务器和不同账号下。

猎具谁用 / 何时用作用与注意
唤猎之铃希望别人加入自己世界的人。发起招募。客机加入后铃声和图标可以继续保留，表示仍在招募；不想继续招募时使用空枪停止。
应猎之铃希望加入房主世界的人。寻找可匹配房主并入场。双方游戏内匹配密码建议相同；两边空密码也可匹配，但不限定只匹配你的朋友。
渴血之铃希望主动入侵其他世界的人。用于主动入侵；与纷争之铃的合作队友互伤不同。是否匹配成功仍受游戏状态、服务器和网络影响。
纷争之铃整合候选中只有房主可以开关互伤。再摇可关闭。客机摇铃只提示“纷争由房主掌控。请由房主摇响纷争之铃。”；该权限与保留招募的改动仍待整合版双机验收。
空枪需要停止摇铃或结束合作的人。先看弹出菜单，选择停止哪种铃或结束 / 返回。停止招募与结束合作是不同动作，不要只凭道具动画猜已断开。

一轮最常见的合作流程

  1. 双方在各自世界进入角色，核对相同服务器、不同账号和约定匹配密码。
  2. 房主唤猎、客机应猎，等加载完成并在画面中看见对方。
  3. 房主使用提灯传送时，客机等待跟随；进入梦境等地图也由当前房主的世界状态驱动。
  4. 结束时，客机可用空枪菜单返回自己世界。房主按需要停止招募，或从游戏菜单正常退出。
  5. 退出游戏后等启动器完成保存和世界核对。提示等待恢复时，按提示独自加载同一角色并正常保存退出，不删除恢复记录。

首次猎具发放需要游戏参数和背包就绪。等待首次准备即可；已有猎具不会重复领取。不要为加快发放去删除存档或辅助记录。

18

奖杯：记录、筛选和右上角提示

读取真实奖杯记录；角色打过某个 Boss，不等于奖杯日志一定存在。

奖杯页上半部分① 总计数与本体 / DLC 计数；② 全部、已解锁、未解锁筛选；③ 刷新；④ 测试提示。截图中的点亮是演示数据，列表含游戏内容名称。
区域 / 按钮详细说明
已解锁 N / 40本体 34 项、老猎人 6 项。记录属于当前无缝用户环境，包含该环境的所有角色。
全部 / 已解锁 / 未解锁仅筛选当前显示的列表，不解锁、删除或迁移记录。
刷新奖杯重新读取当前环境实际日志；读失败时显示提示并保留上次成功结果，不能把读取失败当成全清零。
测试提示预览右上角通知，不会真的解锁奖杯。游戏运行时测试提示会跟随当前游戏窗口；普通预览用来查看样式。
最近读取与文件位置帮助确认读取的是哪一份环境。复制单个角色存档不一定同时包含对应 trophies.log。
奖杯卡片使用奖杯名称、说明和等级显示是否已解锁。卡片状态依据记录，不根据存档进度补发历史奖杯。
奖杯提示预览局部原生提示卡片的展示示例。实际游戏中整张卡片会随游戏客户区缩放，并在右上角短暂显示。

普通版和无缝版怎样同步奖杯

19

存档：先分清导入、导出和替换

普通版和无缝版的角色进度独立发展，不能当作自动合并的两份云存档。

操作谁会改变适合什么情况
普通版 → 无缝版：从普通版导入备份旧无缝分支后，整体替换无缝全部角色与进度；普通版保持原样。想把普通版最新进度作为之后的无缝分支。
无缝版 → 普通版：导出普通版存档在副本里转换并导出 ZIP；两边真实角色存档不变。先保存转换结果，或之后自行按说明放到目标环境。
无缝版 → 普通版：转换并替换原版先完整备份旧原版，再以转换后的无缝分支替换整份原版 savedata，包括其他角色。确定以后使用无缝分支进度继续普通版。
存档页 · 无缝转普通版① 先确认两份对应同一角色；② 导出与替换是两个不同按钮；③ 下方打开任务 / 备份目录。
主流程控件详细说明
两份存档对应同一角色…只在你确认来源一致时勾选。同名或同槽位并不能自动证明可合并；当前流程只验证目标角色，不做多角色批量转换。
导出普通版存档创建新任务，备份两边输入，在副本转换、核对并生成 ZIP。优先用它保留结果。
转换并替换原版完成相同检查后，再备份并替换原版目录。会保留无缝分支较新进度，不合并两个分支的剧情。
打开本次转换目录查看本次任务、输入备份、校验结果和 converted-save.zip。
打开原版备份替换完成后指向被替换的旧原版；仅导出时指向任务内原版输入备份。目录不存在时按钮不可用。

转换支持范围

把普通版进度重新导入无缝版

存档页 · 普通版导入区域依次核对来源、目标和读取结果。红色「从普通版导入」不可用时，先读取状态和错误提示；不要随意删除恢复记录。
控件 / 信息说明
来源 · 普通版存档 / 目标 · 无缝版独立存档来源由所选普通版确定，目标是本包 data/user/savedata。核对方向，别把旧分支重新覆盖到较新分支。
刷新状态读取普通版存档信息，确认当前来源与导入条件；不是替换动作。
从普通版导入先读取来源，再确认整体替换。工具先备份已有无缝存档及已完成辅助记录，未完成恢复会阻止导入。
打开备份目录查看手动导入生成的 save-backups。没有备份时会提示，还未建立不代表备份被删除。
20

存档：分步诊断区域

为旧任务和排错保留的流程，日常离线导出通常不需要它。

分步诊断展开示例3 张分段图
分步诊断展开示例 · 1/3这里展示的是旧诊断入口，不能用“我已确认”复选框跳过实际核对。主流程的离线导出不依赖这些旧复选框。
分步诊断展开示例 · 2/3承接上一张继续向下。这里展示的是旧诊断入口，不能用“我已确认”复选框跳过实际核对。主流程的离线导出不依赖这些旧复选框。
分步诊断展开示例 · 3/3承接上一张继续向下。这里展示的是旧诊断入口，不能用“我已确认”复选框跳过实际核对。主流程的离线导出不依赖这些旧复选框。
控件具体用途
已在无缝检查副本中确认…旧诊断流程的人工核对：实际确认五件无缝道具未放在快捷栏 / 随身栏后再勾选。
4 转换副本在当前旧任务的检查副本上转换；不是直接替换真实普通版。
已重载验证…按旧流程实际在普通版验证道具、等级、装备和较新进度后才确认。
6 导出存档包旧任务经过所需验证后导出结果。
新建诊断任务为排错建立一份新的独立任务及输入备份。
首次检查原版旧流程第一轮普通版基准检查。
检查无缝副本核对对应无缝检查副本和道具状态。
普通版重载验证按旧流程确认转换结果在普通版重载后的状态。

按钮会按任务当前阶段启用。遇到卡在旧任务的情况，先保留任务目录和错误，不要连续点击所有按钮。新的日常流程使用上方「导出普通版存档」或「转换并替换原版」。

21

检查更新：频道、代理和安装

这里只更新 The Hunt 对应程序，不替换普通版，也不自动升级云服务器。

更新窗口顶部是当前版本、预览频道和网络选项；中间显示检查结果 / 发布说明；底部是检查、自动更新、手动下载和发布页。
控件用途与注意
接收预览版更新勾选时接收预览版；取消只检查稳定版。目前使用预览版本时，默认勾选。
HTTP 代理选填本机实际 HTTP 代理地址，如 http://127.0.0.1:7890；端口以自己的代理软件为准。只影响程序内更新请求，不修改游戏或系统代理。
GitHub 下载加速前缀选填自己信任的 HTTPS 前缀。它用于拼接下载地址；程序不内置推荐第三方站点。只支持文件、不支持 API 的站点可能无法完成版本查询。
检查更新按所选频道查询，成功后保存本机更新网络选项。失败不会阻止正常游戏。
发布说明框显示查到的版本和变更，安装前阅读；未查到可用版本时，下载 / 安装按钮可能不可用。
自动更新先退出游戏、停止本地服务和其他操作。下载完整包、校验、备份程序、替换并重开；保留账号、存档、服务数据和配置。自动安装需能从 GitHub 可信来源核对大小和 SHA256。
手动下载交给浏览器下载；浏览器使用自己的网络设置。拿到完整包后按发布说明处理，注意保存个人数据。
发布页打开当前项目发布页，可查看完整附件和版本说明。

程序备份位于 update-backups，仅备份被替换的程序，不是角色存档备份。账号或存档管理仍使用各自的备份入口。

22

常见问题与日志反馈

按现象查看处理方法；反馈时提供目录、版本、主客身份与发生时间。

看到的现象先检查 / 怎么处理
第一步不知道下载哪个包玩家用 TheHuntLauncher Windows 完整客户端；它已内置本地开服。独立服务端给专门开服的机器。
选择路径后启动失败核对三个真实文件和支持版本；看启动器底部状态与 startup.log。不要把普通版入口与 TheHuntLauncher.exe 混选。
必须填写四个地址这是当前无缝启动入口的配置要求。已有服务就填管理员地址；没有服务先在一台电脑内置开服。
账号验证失败 / 账号占用分清私服账号和公共账号；核对所属服务器和密码。占用时先退出该账号的其他游戏进程。不要让两台同时使用一个账号。
可访问 WebAPI，但进房黑屏后返回记录双方时间、角色和服务端；检查完整连接路径及 UDP / STUN。不要把一次 HTTP 成功当成实际入房成功。
客机来了，摇铃图标仍在可以继续招募，是当前无缝的正常设计。需要停止时，空枪菜单选择停止招募。
纷争后招募消失 / 客机可开互伤已发布旧行为与整合候选不同；确认两台是否已换同一候选。按版本反馈，别把候选检查通过当成双机已通过。
退出桌面先回了提灯这是整合候选处理的定向问题。记录第一次点击时间，再正常退出，提供主机本轮日志。不要反复开关游戏重试。
奖杯没补亮看真实 trophies.log 是否带过来；只有角色存档或 Boss 进度不能补齐历史解锁。测试提示只展示样式。
存档导入 / 转换被阻止阅读具体错误、来源和备份路径，确认两边游戏已退出；待恢复记录、角色条件或布局不符合时保留现场反馈。
进入别人世界，个人关键道具显示与自己世界不同合作中的当前显示不直接等于永久丢失；先正常返回自己的世界核对。异常时保留两端日志与存档，避免继续覆盖分支。
原版和无缝都出现同一个模型异常优先按同版本、同角色作一次有区分度的对照，记录两边结果；不能仅凭在无缝中看到就归因于无缝。
读档偶发停顿记录标题、首次读档、传送还是进出房；读档卡顿仍未完全定位。猎具初始化优化不代表消除所有加载卡顿。

反馈时提供什么

  1. 写明双方实际版本、哪台是房主 / 客机、使用云服还是本地服务，以及大致发生时间。
  2. 本机在底部打开日志目录；提供当轮 launch-时间.log、mod/logs 的对应 bbsc-mod 日志，以及 data/user/last-exit.json。涉及详细加载时再提供对应 mod/captures/bloodborne-re 捕获。
  3. 有另一台或服务端的对应日志时一起保留。没有就说明缺哪一端，不必为了补日志盲目反复重现。
  4. 检查文件是否含私人 IP、用户名或路径，按需要脱敏后提交。不要公开 .private、profile.json、账号库、SSH 私钥或整份已使用的启动器目录。

游戏角色存档通常位于 data/user/savedata；本地服务账号库在 server/bbsc/db。两者用途不同。报告问题前先保留当前分支和备份，避免用另一个目录的记录覆盖它。

23

适用版本与已知限制

请核对实际使用的程序版本。

项目当前说明
界面基线The Hunt preview.20，BBport 1.9.7，Windows 10 / 11 x64，固定 CUSA03173 1.09。
2026-11-03 整合候选已包含房主控制互伤、纷争保留招募及首次退出回提灯的候选修复。34 项本地针对性检查通过，真实双机验收仍待完成。
既有游玩结果已有私人环境的双人移动、战斗、提灯同行和死亡保持会话结果按未改动路径复用。不是承诺所有地图、人数和离开方式都已经覆盖。
仍有限制 / 待核实五人完整流程、永久进度合并、公共内容在真实游戏中的可见性、部分历史灯点及读档卡顿分别保留各自验证边界。人偶洗点关闭。
截图来源本手册用当前程序组件与同版 XAML 离线渲染，保留原界面布局与文字；分段图模拟滚动位置，局部图为同张原图的裁切展示。示例数据不连接任何真实服务器、不改动用户存档。
用途供视频观众按图查阅、快速开始和定位常见问题；离线打开不要求登录。需要在线资源的下载 / 发布页链接会另外打开浏览器。

本项目由 iytq 维护，独立于 BBSC、BBport、Sony 和 FromSoftware。游戏与奖杯图像属于各自权利方，截图用于说明当前界面；界面字体保留随附许可。

项目仓库 · 版本与下载 · 回到首次上手

下载原图