Repository navigation
Releases
v3.0.0
更新小结
本版将 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
更新小结
补充许可证声明,无功能改动。
- 新增
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
更新小结
新增 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 5Linux / Windows 两版逻辑本次未改动。
v2.3.1
更新小结
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
更新小结
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
更新小结
修复 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
更新小结
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
更新小结
新增 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
Full Changelog: https://github.com/backspace135/mc-capacity-test/commits/v2.1.0