BazaarPlusPlus

因热爱而生 · 为 《The Bazaar》 (opens in a new tab) 打造的 BepInEx 模组与桌面安装器

BazaarPlusPlus 是一个面向《The Bazaar》的开源项目：游戏内由 BepInEx 模组提供卡牌图鉴、对局历史与战斗回放，还有 Tooltip 预览、匿名模式和中文术语等功能；桌面安装器负责下载、安装与修复，也管自动更新和直播叠层；同仓库里还有上传后端、指标分析器和官网。

普通玩家建议直接使用 下载页 (opens in a new tab) 的安装器；本仓库面向想了解实现、提交改动或自行构建的开发者。

项目代码主要由 Codex (opens in a new tab) 主导，并由 Claude Code (opens in a new tab) 协作完成。

快速开始

• 打开 bazaarplusplus.com/download (opens in a new tab)，选择 Windows .exe 或 macOS .dmg。
• 关闭游戏后运行安装器；更新时建议先卸载旧版本，再安装新版本。
• 安装完成后启动《The Bazaar》一次，让 BazaarPlusPlus 完成初始化。
• 在主菜单确认「卡牌图鉴」按钮出现，且底部版本信息显示 BPP version 字样。

详细教程、快捷键和功能说明见 bazaarplusplus.com/tutorial (opens in a new tab)。

功能概览

游戏内模组

桌面安装器

仓库结构

每个项目保留自己的工具链，并有各自的 README.md 与 AGENTS.md；根目录 [AGENTS.md](AGENTS.md) 记录跨项目约定和契约归属。

从源码构建

按[开发命令](docs/development.md)装好工具链（just、.NET、Node、Rust、Python/uv），然后：

mod 对照快照锁 bazaarplusplus-mod/build/game-libs.lock.json 指向的游戏程序集编译：mod::fetch 接受版本一致的本机 Steam 版《The Bazaar》，否则从私有存储取包，细节见[开发命令](docs/development.md#游戏程序集)。单个项目用 just ::check 和 just ::test 验证，just fmt 格式化全部项目。just mod::build 只编译；把开发版 DLL 部署进游戏要显式运行 just mod::build --deploy。

正式包由 GitHub Actions 的 release.yml 在托管 runner 上构建、签名并上传，签名、公证和 R2 凭据只存在于 GitHub secrets 和维护者本机配置，不在公开仓库中；游戏程序集快照、游戏反编译输出、.env、.dev.vars 同样不在此树中。版本发布流程见[产品发布](docs/release.md)。

二次开发须知

如果你计划基于本项目或本模组进行二次开发，请务必遵循《The Bazaar》官方 Mod Policy (opens in a new tab)。

致谢

支持者

感谢所有支持 BazaarPlusPlus 的朋友。完整支持者名单见 bazaarplusplus.com/support (opens in a new tab)。

如果你愿意支持项目持续维护，可以前往 Ko-fi (opens in a new tab) 或在安装器内查看赞助方式。