Skip to content

Datapack Sandbox

快速验证数据包

面向 Minecraft Java 数据包的本地虚拟运行时。执行函数、检查资源、注入玩家事件,并用可重复的断言锁定世界状态。

Datapack Sandbox 立方体命令行标志

一个运行时 · 三种工作流

把灵感快速变成可重复的测试

无论使用终端、manifest 测试集还是 JVM 测试,都运行在同一套确定性沙盒上,并共享输出、trace、诊断和 snapshot 报告。

  1. 01
    加载

    读取数据包和对应版本的资源格式。

  2. 02
    执行

    运行命令、函数、tick 与玩家事件。

  3. 03
    断言

    比较可观察输出和世界状态。

manifest 回归检查26.2

$ dps check --strict examples

loading 7 manifests · profile 26.2

PASS generator-output.dps.json

PASS player-events.dps.json

PASS full-stack.dps.json

全部检查通过
4条命令2个输出7处状态变化

为可信反馈而设计

追求快速反馈,但不假装自己是原版服务器

Datapack Sandbox 会明确标注模拟边界。适合用它获得确定性的开发反馈;确实依赖游戏引擎的行为,则应保留原版集成测试。

01

可重复

稳定的随机种子、snapshot 与结构化报告,让失败可以可靠复现。

02

可观测

命令可以记录源码位置、输出事件、执行 trace 与状态差异。

03

版本感知

内置 profile 覆盖从 1.20.4 到 26.2 的现代数据包格式。

在本地复现数据包行为,在提交前发现问题。