因热爱而生 · 为 《The Bazaar》 打造的游戏内模组：Windows、macOS 与 Android
English · 官网 · 下载 · 使用教程 · Release Notes · Ko-fi
BazaarPlusPlus 是一个面向《The Bazaar》的开源项目，不改变游戏平衡，只做信息增强与记录：卡牌图鉴、十胜阵容推荐、对局历史与战斗回放、附魔 / 升级预览、战斗状态栏等。桌面版（Windows、macOS）是 BepInEx 模组加一个桌面安装器；Android 版是一个注入了 BazaarPlusPlus 的游戏 APK，直接安装即可。同仓库里还有上传后端、数据分析器和官网。
普通玩家请直接到 下载页 获取安装器或 APK；本仓库面向想了解实现、提交改动或自行构建的开发者。
Note
项目代码主要由 Codex 主导，并由 Claude Code 协作完成。
- 打开 bazaarplusplus.com/download，选择 Windows
.exe或 macOS.dmg。 - 关闭游戏后运行安装器；更新时建议先卸载旧版本，再安装新版本。
- 安装完成后启动《The Bazaar》一次，让 BazaarPlusPlus 完成初始化。
- 在主菜单确认「卡牌图鉴」按钮出现，且底部版本信息显示
BPP version字样。
桌面安装器还提供修复、卸载、数据重置和本地历史清理，并可自动更新。兼容的模组更新会在游戏内下载，重启游戏后生效。每个桌面版本也提供内置当版模组的完整安装器；游戏内更新无法联网时，可手动下载安装器更新。
从 5.x 升级后，可以在安装器的安装页一键把旧版对局、截图和回放导入 6.0 的新数据目录；导入的对局只在本地显示、不会上传，旧目录保持不变，之后可以在安装器里删除。
- 在 下载页 的 Android 卡片下载
.apk（arm64）。Android 版目前是实验版，问题可以在 QQ 群 1083470305 反馈。 - 先卸载官方版 The Bazaar：Android 不允许用签名不同的安装包覆盖安装。账号与进度保存在服务器上，卸载只会丢失登录状态。
- 安装下载的 APK，登录后即可使用；BazaarPlusPlus 的设置在游戏自带的「设置」里。
- 游戏更新后，回到下载页下载新的 APK 直接覆盖安装，不需要再卸载。只有模组更新时，模组会在游戏内自行更新。
桌面版包括 Windows 和 macOS。✅ 支持 ◐ 部分支持 — 不支持
| 功能 | 桌面版 | Android |
|---|---|---|
| 卡牌图鉴与十胜阵容推荐 | ✅ | ✅ |
| 对局历史、收藏与笔记 | ✅ | ✅ |
| 战斗回放与幽灵对战 | ✅ | ✅ |
| 战斗状态栏与速度控制 | ✅ | ✅ |
| 附魔、升级与详细预览 | ✅ | ◐ 操作与内容有差异 |
| 回放录像与终局自动截图 | ✅ | — |
| OBS 直播叠层 | ✅ | — |
桌面版还提供怪物阵容预览、战斗贡献、双语物品名、语音字幕等显示辅助，以及 FSR 超分辨率和可选的 BazaarDB 截图上传（默认关闭）。各平台均支持简体中文与台湾繁体术语。
各平台会在不处于对局时后台上传对局与回放数据，用于幽灵对战和官网的英雄统计。
完整功能、平台差异与操作说明见使用教程。
| 目录 | 内容 |
|---|---|
bazaarplusplus-mod/ |
游戏内模组：共享 Core、桌面 BepInEx Host、Android MelonLoader Host |
bazaarplusplus-installer/ |
桌面安装器（Tauri 2 + React） |
bazaarplusplus-server/ |
Cloudflare Worker：Bundle 上传、Ghost 发现与 BazaarDB 投递 |
bazaarplusplus-analyzer/ |
把 Bundle 汇总成英雄与阵容快照 |
bazaarplusplus-site/ |
bazaarplusplus.com |
bazaarplusplus-ios/ |
iOS App：在 iPhone/iPad 上运行游戏 Mac 版并加载模组（过渡方案） |
design/ |
设计 token、共享样式与品牌规范 |
VERSION、release.mjs、release/ |
产品版本与三个平台的发布流程 |
每个项目保留自己的工具链，并有各自的 README.md 与 AGENTS.md；根目录 AGENTS.md 记录跨项目约定和契约归属。
按开发命令装好工具链（just、.NET、Node、Rust、Python/uv），然后：
just setup # Shared local config, locked dependencies, Git hooks
just doctor # What is still missing on this machine
just mod::fetch macos online # Game assemblies for the mod (Windows: windows)
just mod::fetch android online # Interop Snapshot and loader for the Android Host
just # Every command, grouped by projectmod 对照快照锁 bazaarplusplus-mod/build/game-libs.lock.json 指向的游戏程序集编译：mod::fetch 接受版本一致的本机 Steam 版《The Bazaar》，否则从私有存储取包，细节见开发命令。单个项目用 just <project>::check 和 just <project>::test 验证，just fmt 格式化全部项目。just mod::build 只编译；把开发版 DLL 部署进游戏要显式运行 just mod::build --deploy。Android Host 用 just mod::android-build 编译、just mod::android-deploy 推到连接的设备，设备冒烟见开发命令。
正式包（桌面安装器与 Android APK）由 GitHub Actions 的 release.yml 在托管 runner 上构建、签名并上传，签名、公证、Android 发布密钥和 R2 凭据只存在于 GitHub secrets 和维护者本机配置，不在公开仓库中；游戏程序集快照、游戏反编译输出、.env、.dev.vars 同样不在此树中。版本发布流程见产品发布。
Important
如果你计划基于本项目或本模组进行二次开发，请务必遵循《The Bazaar》官方 Mod Policy。
| 灵感来源 | BazaarHelper · BazaarPlannerMod |
| 数据来源 | bazaardb.gg |
| 运行依赖 | BepInEx · MelonLoader · Harmony · Tauri · React · Vite · Tailwind CSS · FFmpeg |
| 共创 | Codex · Claude Code |
感谢所有支持 BazaarPlusPlus 的朋友。完整支持者名单见 bazaarplusplus.com/support。
如果你愿意支持项目持续维护，可以前往 Ko-fi 或在安装器内查看赞助方式。
本项目使用 MIT License。