Skip to content

Releases

v3.0.0

Choose a tag to compare

@github-actions github-actions released this 14 Sep 09:07

更新小结

本版将 Python 测试脚本整理为独立的 python/ 模块包,并新增稳定性、sprint 对照、批量生成及可选负载等测试工具。平台入口脚本用法不变。

目录结构调整

  • 原根目录的 capacity_test.py 移入 python/ 目录,拆分为共享模块与独立工具;
  • 新增 python/rcon_client.py(共享 RCON 客户端)与 python/benchmark_metrics.py(MSPT、CPU steal、回归与预热采样);
  • Linux / macOS / Windows 入口脚本相应改为调用 python/capacity_test.py,命令行参数与行为保持一致;
  • macOS 与 Windows 的双击入口改名为 容量测试.command / 容量测试.bat,停止脚本改名为 停止服务器.command / 停止服务器.bat;
  • 新增 VERSION 文件,随发布包分发。

Python 工具

脚本 用途
python/capacity_test.py 平台入口脚本调用的默认命令行程序,含 --ping / --stop 服务器管理开关
python/capacity_gradient.py 负载梯度容量测试:逐级加载、回归求拐点
python/soak_test.py 固定负载长时稳定性测试
python/sprint_experiment.py ABAB 交替 tick sprint 实验
python/sprint_stats.py sprint 结果统计:中位数、IQR、变异系数与 ABAB 判定(离线)
python/batch_spawn.py 批量实体生成策略评估:逐条 summon、分批发送与 datapack function
python/player_capacity.py 可选:真实玩家客户端容量测试,需外部客户端适配器
python/world_loads.py 可选:红石、漏斗与区块探索负载

文档

  • README 重新整理:补充文件清单与各工具的调用方式,统一措辞;
  • benchmark-methodology.md 章节标题改为描述性名称。

发布包

zip / tar.gz 包含 python/ 目录、三个平台的入口脚本、VERSION、README.md、benchmark-methodology.md 与 LICENSE。Linux / macOS 脚本已预设执行权限。

Full Changelog: v2.4.1...v3.0.0

v2.4.1

Choose a tag to compare

@github-actions github-actions released this 02 Sep 09:07

更新小结

补充许可证声明,无功能改动。

  • 新增 LICENSE — 采用 MIT 许可证(Copyright (c) 2026 backspace135),正文为 SPDX 官方标准文本,GitHub 已识别为 MIT。
  • README 增加「许可证」小节 — 说明授权与免责范围,并明确边界:MIT 仅覆盖本仓库自有代码;本工具运行时自动下载的 Purpur 服务端虽同为 MIT,但其启动过程会获取并修补 Mojang 官方服务端 jar,该部分受 Minecraft 最终用户许可协议约束,使用者需自行遵守。
  • 发布包内含 LICENSE — v2.4.0 的 zip/tar.gz 未包含该文件,本版起随包分发。

v2.4.0 的 macOS 支持及 Linux / Windows 逻辑本次均未改动。

v2.4.0

Choose a tag to compare

@github-actions github-actions released this 02 Sep 08:36

更新小结

新增 macOS 一键压测支持,与 Linux / Windows 两版功能对齐——同样的 Docker / 直跑双模式、同样的开关和环境变量、同样的双击入口。

  • macOS/一键压测.command、macOS/停服.command — 双击即用,开头选运行方式(1 自动 / 2 强制 Docker / 3 不用 Docker)
  • macOS/run_capacity_test.sh — 实际逻辑,开关与 Linux 版一致(--docker / --no-docker / --stop-server,DIR / CPUSET / NOHUP 环境变量)

四处 macOS 专属处理(照抄 Linux 版跑不起来):

  • 没有 setsid — 直跑模式改用 ( nohup ... & ) 子 shell 脱离作业控制,并保留 v2.3.1 的 echo $$ > server.pid; exec java 写法,pid 文件里仍是 java 真实 PID。
  • 没有 taskset — 直跑模式不绑核(启动时明确警告,跨机对比请两边都走 Docker 模式)。Docker 模式绑核照常,但会读 docker info 的 NCPU,CPUSET 超出虚拟机核数时自动收窄为 0-(N-1) 而不是让 docker run 直接失败;虚拟机内存 < 6GB 也会提示去 Docker Desktop → Settings → Resources 调大,否则 4G 堆必被 OOM。
  • 数据目录固定 ~/purpur-test — Docker Desktop 默认只共享 /Users、/Volumes、/private、/tmp,沿用 Linux 的 /opt/purpur-test 会挂载失败、容器起来即退。
  • JDK 自动发现 — 扫 PATH、$JAVA_HOME、/usr/libexec/java_home、/Library/Java/JavaVirtualMachines 及 Homebrew 的 openjdk* 前缀,取主版本号最高的。Homebrew 装的 openjdk@25/openjdk@26 默认不 link 进 PATH、java_home 也看不到,不必手动改 JAVA_HOME(已在 PATH 为 Temurin 21 的机器上验证正确挑到 openjdk@26)。

README 补了 macOS 快速开始、前置条件、参数对照表,以及两条 macOS 专属 FAQ:Gatekeeper 隔离导致 .command 打不开的解法(右键打开,或 xattr -dr com.apple.quarantine macOS/;解压丢执行位则 chmod +x macOS/run_capacity_test.sh macOS/*.command),以及直跑模式数值偏高不宜直接横比的原因。

验证状态:macOS 版仅做了语法检查与 JDK 发现逻辑验证,启动 → RCON → 加载测试 → 停服的完整链路尚未在 macOS 真机跑过。首次使用建议先冒烟:

./macOS/run_capacity_test.sh --step 300 --max-levels 2 --warmup 10 --measure 30 --interval 5

Linux / Windows 两版逻辑本次未改动。

v2.3.1

Choose a tag to compare

@github-actions github-actions released this 31 Aug 13:02

更新小结

v2.3.0 Linux 直跑模式在真机(Ubuntu 24.04)验证中发现的一处修复:

  • 直跑模式 pid 文件可能记错进程号 — setsid 在部分环境下会 fork,外层 $! 拿到的是瞬时父进程号(实测差 1),导致 RCON 不可用时 --stop-server 的强杀兜底可能打不中 java 进程(优雅关服路径不受影响)。已改为子 shell 先写 $$ 再 exec java,pid 文件必为 java 真实 PID(已在真机经 /proc/<pid>/comm 验证)。

另:v2.3.0 双模式已在真机完整验证——docker 权限不足时自动降级直跑、--docker 强制模式、--stop-server 对容器/直跑进程均正常。网络受限环境提示:首次启动 Purpur 需从 Mojang 下载原版 jar,连不上 piston-data.mojang.com 的机器可预先把 mojang_26.2.jar 放进 $DIR/cache/(sha256 见 purpur.jar 内 META-INF/download-context);eclipse-temurin:25-jre 拉不动时可用本地任意 JDK 25 镜像 docker tag 成该名字替代。

v2.3.0

Choose a tag to compare

@github-actions github-actions released this 31 Aug 12:23

更新小结

Linux 版对齐 Windows 版:不装 Docker 也能一键压测。

  • 三种运行方式 — 默认自动:有 docker 用 Docker;docker 不可用(未安装或当前用户无权限)自动切到本机 Java 直跑,并打印当前模式。--docker 强制 Docker(不可用时报错退出,不悄悄降级,保证环境可比);--no-docker 强制本机 Java 直跑。
  • 直跑模式(Linux) — 需本机 Java 25+(自动检测版本,过低时提示装 Temurin 25 并附清华镜像地址);绑核经 taskset -c $CPUSET 生效;setsid nohup 启动防挂住 ssh 会话;默认数据目录改为 ~/purpur-test(全程免 root)。注意:直跑时 RCON(25575)监听所有网卡,密码随机生成,有公网 IP 的机器请在防火墙拦掉该端口。
  • 统一停服入口 — ./Linux/run_capacity_test.sh --stop-server:容器直接停;直跑进程先走 RCON 优雅关服,30 秒不退再强杀。
  • 三个新开关由脚本自己消费,其余参数照旧透传给 capacity_test.py;DIR / CPUSET / NOHUP=1 环境变量用法不变,Docker 模式行为与旧版完全一致。

Windows 版本次无改动(双模式自 v2.2.x 起已支持)。README 的前置条件、参数对照表、FAQ 已同步更新。

v2.2.2

Choose a tag to compare

@github-actions github-actions released this 31 Aug 09:33

更新小结

修复 v2.2.1 的 Windows 一键脚本在真机上的两处故障(v2.2.x 用户请更新到此版):

  • 双击 bat 出现「'xx' 不是内部或外部命令」乱码报错 — cmd 解析含中文的 UTF-8 批处理时会把多字节字符错位断行、拿半个汉字当命令执行。bat 已改为纯 ASCII 薄壳,横幅、模式菜单、结果提示全部移入 PowerShell 脚本(-Menu),中文显示不再依赖 cmd 解析器。
  • 直跑模式检测 Java 版本时报 NativeCommandError 直接中断 — java -version 把版本号写到 stderr,PowerShell 5.1 在 $ErrorActionPreference='Stop' 下将其当成致命错误。已改为 Continue 并对关键 cmdlet 单独加 -ErrorAction Stop,现在 Java 版本过低会给出明确提示(需 Java 25+,https://adoptium.net/ )而不是崩溃。
  • 模式菜单改为回车默认「自动」(原 30 秒倒计时);修复 -Background 后台模式工作目录指错导致找不到 capacity_test.py 的隐藏问题。

使用方式不变:解压后双击 Windows\一键压测.bat,测完双击 Windows\停服.bat。

v2.2.1

Choose a tag to compare

@github-actions github-actions released this 31 Aug 09:27

更新小结

Windows 支持完整落地 + Docker 模式开关(含 v2.2.0 的全部变更)。

新增

  • Windows 一键压测:解压后双击 Windows\一键压测.bat 即可,启动时三选一:1 自动(有 Docker 用 Docker,没有切本机 Java 直跑)/ 2 强制 Docker(不可用则报错退出,不悄悄降级,保证环境可比)/ 3 不用 Docker(本机 Java 25+ 直跑,绑核转为 CPU 亲和性)。测完双击 Windows\停服.bat 关服。
  • PowerShell 入口 Windows\run_capacity_test.ps1:与 Linux 版同一套流程(下载 Purpur → 写配置 → 起服 → 测试),新增 -Docker / -NoDocker / -Background / -StopServer 开关,测试参数照旧透传。
  • capacity_test.py 新增 --stop(RCON 优雅关服)。

改进

  • 进度指示全面强化:彩色步骤横幅 [1/4]~[4/4]、jar 下载原生进度条、Docker 拉镜像分层进度、RCON 等待实时计秒(Linux 版同步获得计秒)。
  • 目录重构:Linux/ 与 Windows/ 分平台存放,README.md 与共用的 capacity_test.py 在最外层,发布包保持该结构。

兼容性

  • Linux 用法变化:入口移至 ./Linux/run_capacity_test.sh,参数与行为不变。
  • Windows 需要 Python 3;Docker 模式需 Docker Desktop(Linux 容器),直跑模式需 Java 25+(Temurin)。

v2.2.0

Choose a tag to compare

@github-actions github-actions released this 31 Aug 09:20

更新小结

新增 Windows 支持的首个版本(建议直接用 v2.2.1,补充了 Docker 模式开关):

  • 新增 Windows\run_capacity_test.ps1 一键入口:默认 Docker Desktop,无 Docker 自动切本机 Java 25+ 直跑(-NoDocker),绑核转 CPU 亲和性;含 -Background 后台运行与 -StopServer 停服。
  • 新增双击即用的 Windows\一键压测.bat / Windows\停服.bat。
  • 目录重构为 Linux/ + Windows/,README 与共用 capacity_test.py 在最外层。
  • 进度指示强化:彩色步骤横幅、下载/拉镜像原生进度、RCON 等待实时计秒。
  • capacity_test.py 新增 --stop(RCON 优雅关服)。

v2.1.0

Choose a tag to compare

@github-actions github-actions released this 31 Aug 08:32