Skip to content

pch_system-v0.10.0

Latest

Choose a tag to compare

@github-actions github-actions released this 19 Aug 10:40
· 1 commit to main since this release
d6e302d

⚠️ 本插件需配合 PCHSystem 后端使用,单独安装 .mcdr 无法工作。

这是什么

PCH System 是 PCHSystem 的游戏内客户端(MCDReforged 插件):材料协作收集、项目三阶段进度管理、积分 / 称号、通知投递等全在游戏内 !!PCH 命令完成。所有功能经 HTTP 调用后端,必须先部署后端

首次部署(全栈 · 推荐)

git clone https://github.com/YuShenLiu06/PCHSystem.git
cd PCHSystem
bash Scripts/install.sh

脚本一键完成:docker / 镜像自适应 → 生成 .env → 起 postgres+backend+web → 数据库迁移 → 前端构建 → 拷贝插件 + 生成 config.json。完成后游戏内 !!MCDR plugin reload pch_system!!PCH status(自检)→ !!PCH login

升级(已部署)

bash Scripts/update.sh

详情参考 部署流程

依赖

  • MCDReforged ≥ 2.14.0
  • 插件依赖:chest_scanner_libv0.10.0 新增,硬依赖)、uuid_api_remakeminecraft_data_api——install.sh / update.sh 经 MCDR pim 自动检测补装,无需手动下载
  • PCHSystem 后端(必需) + 前端(可选):见上「首次部署」

破坏性变更

v0.10.0 起箱子扫描剥离为独立插件 chest_scanner_lib(硬依赖)。旧部署(<0.10.0)升级后,!!MCDR plugin reload pch_system 会因依赖缺失被 MCDR 卸载(重启也无效)。

恢复:在仓库内再执行一次 bash Scripts/update.sh(v0.10.0 脚本会自动检测并补装缺失依赖),随后游戏内 reload 即可;或参照下文「更新内容」手动 pim 安装。


更新内容

⚠️ 破坏性变更:箱子扫描剥离为独立插件,本版起 pch_system 硬依赖 chest_scanner_lib旧部署(<0.10.0)升级后,!!MCDR plugin reload pch_system 会因依赖缺失被卸载(重启也无效)。恢复方法(任选其一):

  • 仓库内再执行一次 bash Scripts/update.sh(新版会自动检测并补装缺失依赖),随后 reload;
  • 手动安装:mcdreforged pim download chest_scanner_lib -o <plugins 目录>mcdreforged pim pipi <下载的 .mcdr 文件>!!MCDR plugin reload pch_system

Changed

  • 箱子扫描独立成库!!submitc / !!PCH sheet submitchest 的扫描实现(RCON 读箱、准星检测、SNBT 解析、双联合并)剥离为官方插件目录收录的外部插件 chest_scanner_lib>=1.0.1),随依赖自动安装;游戏内命令用法不变。内嵌 chest_scanner.py 移除,插件自身不再需要 hjson Python 依赖。

Added

  • 部署脚本(运维):依赖插件安装改走 MCDR 原生 pim CLI——install.sh 缺失自动安装(交互确认);update.sh 每次执行自动补装缺失依赖(置于版本比对之前,「已是最新」也生效——旧部署升级断裂后再跑一次 update 即恢复),另新增 --upgrade-plugins 主动升级已装依赖到 latest(换文件防同 id 双载);依赖 id 清单从 mcdreforged.plugin.json 运行时解析,杜绝清单漂移;TestServer 构建同链路。

配套前后端变化(pch_system-v0.9.3 → v0.10.0 期间)

建议随本版一并升级(bash Scripts/update.sh 全栈更新;backend 含数据库迁移 0024,部署脚本自动执行):

backend-v0.10.0(2026-08-19)· 积分层上线

  • 积分记账 API:积分批量入账 / 出账与多角色流水分页;每笔变动单独记账、不可篡改、附记账后余额,可完整审计回溯;支持防重复提交、透支开关、记账站内通知。
  • 管理员调分 API:管理员/拥有者调增调减玩家积分(原因必填、可附备注),玩家收可读通知、操作入审计日志;配套玩家名联想接口。
  • 余额排名与按账号流水:玩家积分余额排名接口(余额由流水累加重建);流水查询支持按账号过滤,供后台下钻。
  • 托管管理账号.env 配置用户名/密码后,启动自动创建/更新不绑定任何玩家的管理员账号,专用于纯后台管理。
  • 修复:负余额账号入账不再被透支守卫静默跳过;托管账号撞名接管不再静默(打警示日志);调分通知附备注时文案完整。

frontend-v0.11.0(2026-08-19)· 积分管理页

  • 积分管理页:管理员/拥有者新增「积分管理」——「积分流水」按玩家/时间筛选(服务端分页),「玩家积分」展示余额排名(负余额红标),点击行下钻该账号流水抽屉(自带分页)。
  • 调分弹窗:入账/出账方向预览,透支开关仅出账可用,原因与备注有中文提示;调分后余额即时刷新。
  • 托管账号登录:登录支持无绑定玩家的托管管理账号,「我的身份」入口按是否绑定显隐。
  • 修复:下拉框/输入框聚焦描边错位(双框);积分页「N 条/页」切换档位不生效。

frontend-v0.10.0(2026-08-15 · 与 pch_system-v0.9.3 同批发布)

若前端仍停留在 v0.9.x:此版为界面全面换新——与 wiki 统一的深板岩 + 草方块绿视觉;亮/暗主题(自动跟随系统 + 顶栏三态切换);顶部导航栏 + 品牌 logo + 用户区(窄屏折叠抽屉);材料表「换算」列按盒/组/个分段、交付进度组刻度条;404 页与动态标签页标题。