跳转到内容
PCHSystem

施工进度上报

概述

Section titled “概述”

项目进入施工阶段后，PCHSystem 会自动追踪每位参与者的方块放置贡献。目前使用 统计文件差值 方式追踪（读取 world/stats/<uuid>.json 的 minecraft:used 差值）。

加入施工

Section titled “加入施工”

开始建造前，必须先加入对应项目，否则贡献可能无法正确归因：

!!PCH construction join [sheet_id]
  • 不带编号：自动加入唯一进行中的项目
  • 带编号：加入指定项目

查看状态

Section titled “查看状态”
!!PCH construction status

显示：

  • 追踪器是否启用
  • 当前在线玩家数
  • 当前施工项目数
  • 上次上报结果

退出施工

Section titled “退出施工”
!!PCH construction leave

查看当前施工

Section titled “查看当前施工”
!!PCH construction current

显示你当前加入的施工项目。

工作原理

Section titled “工作原理”
graph TD
    A[玩家放置方块] --> B[游戏统计文件更新]
    B --> C[追踪器每30s读取差值]
    C --> D{能否归因到项目?}
    D -->|是| E[上报到后端]
    D -->|否| F[跳过,推进baseline]
    E --> G[后端记录贡献流水]

注意事项

  1. 只能同时加入 一个 施工项目
  2. 如果多个项目同时进行且无法自动判断归属，需要指定 sheet_id
  3. 未来将支持客户端 mod 精确追踪（开发中）

客户端 Mod 追踪（规划中）

Section titled “客户端 Mod 追踪（规划中）”

未来将支持客户端 mod 通过 JWT 认证精确上报放置位置和方块类型，比统计文件差值更准确：

  • !!PCH construction switch — 切换上报源
  • !!PCH mod-token — 获取 mod JWT 令牌