What's new

• Custom benchmark profiles — /bench custom
  A new way to compose your own benchmark recipes from YAML, without writing code. Drop a file in plugins/VoxelBench/custom_benchmarks/ and pick which tests run, in what order, with what
  parameters.
  
  
  • /bench custom run — execute a profile
  • /bench custom list — see what's loaded
  • /bench custom info — view the steps and params
  • /bench custom reload — re-scan the folder without restart
    

  ​
  Ships with three preset profiles: standard.yml (mirrors the built-in benchmark), showcase.yml (every test and every parameter, fully commented — use as a reference),
  example.yml (minimal starter). Profiles carry their own name, description, author, version and tags; the backend uses
  a normalized profile hash to recognize the same recipe across servers.
  
  
• AutoBench — backend-driven benchmark scheduling
  /bench autobot [args] — entry point for a backend-driven agent (typically a mineflayer bot connecting as a real player) that orchestrates benchmark runs server-side. Supports single-run,
  multi-run with abort detection, and live progress events. The agent is force-gamemode'd to SPECTATOR on entry so it never falls to its death in a fresh world.
  
  
• Hybrid server support — Mohist & Arclight
  Benchmark worlds on hybrid Forge/Bukkit servers used to come out with hills, trees and caves instead of flat terrain. They now generate genuinely flat. Tested on Mohist 1.20.1 and Arclight 1.20.1 / 1.20.4.
  Detection covers the full hybrid family (Mohist, Arclight, Banner, NeoTenet, Magma, CatServer, Cardboard).
  
  
• Persistent benchmark worlds
  Worlds created with /bench world create now auto-reload on every server start, even without Multiverse-Core. The command also refuses to overlay a stale folder, preventing mixed-terrain chunks
  if you recreate over an existing one. Temp benchmark worlds from crashed previous sessions get auto-cleaned at startup.

• Sharper /bench commands
  
  
  • /bench tests — alias of /bench test, fully tab-completable
  • /bench help — explicit help command, no longer hidden behind unknown subcommands
  • /bench tests list — dynamic listing built from the live test registry, grouped by category
  • Console-aware listing — /bench test from console shows two groups: scriptable hardware tests and those requiring a real player
  • Unknown subcommands now print Unknown subcommand 'X' instead of silently dumping the help
    

  ​
  
  
• Test parameters via key=value
  /bench test foo count=50 timeoutMs=2000 now actually passes the values to the test. Tab completion suggests the available keys for each test.
  
  
• Tri-state outcomes
  Tests can now report Skipped (test inapplicable, e.g. an optional mod isn't installed) distinct from Failed (server lost). Skipped tests render in yellow ⊘ with the reason and
  stay out of failure stats — backends should exclude them from leaderboards rather than count them as losses.
  
  
• /bench custom run respects your pinned world
  Custom profiles used to ignore /bench world set and silently spawn a temp world. The pinned world now wins; the profile's auto-temp-world setting only kicks in as fallback.
  
  
• Sharper failure messages
  When a test fails, the reason now displays in chat instead of a bare ✗ Test failed line.
  
  
• MC 26.1.x readiness
  WorldTimeStabilizer resolves daylight-cycle gamerules by name across MC 1.17 → 26.1.x; defensive world.setTime handles dimensions without a world clock (custom Forge
  dimensions). Compile path verified against Spigot 26.1.2 API.
  

Smaller fixes

Boolean metrics display "Yes/No" properly · Entity-spawn tests pre-load chunks on hybrid servers (no more silent 0-spawn runs) · Parameter clamp warnings reach the operator in chat · Built-in tests
(chunkLoading, chunkTicking, lightingUpdate, explosion) promoted to rich-metric format · Startup logs quieter (spurious scoreboard warnings demoted)

Coming soon

• Extension API (preview) — a new public API will let third-party plugins register their own benchmark tests against VoxelBench: typed parameters, declared output metrics, full lifecycle hooks, JUnit
  mock helpers. The surface is functionally complete and exercised by the bundled samples in the project repo, but isn't officially announced for public use yet. Expect changes until the public release.
  Stay tuned.
  

Upgrade

Drop the new jar in plugins/, restart. No config or database migration. If you have an existing voxelbench_ world from a previous version, delete it before restart — terrain
generated before this release isn't consistent with the new flat generator. The first time the plugin starts, three preset custom profiles will appear in plugins/VoxelBench/custom_benchmarks/
— feel free to delete the ones you don't need.

Java + compatibility

Java 16+ for MC 1.17 → 1.21.x. Java 25 LTS for MC 26.1.x.
Tested on Paper / Purpur / Pufferfish / Folia / Spigot / Mohist 1.20.1 / Arclight 1.20.1 + 1.20.4.