Rapports
VoxelBench saves benchmark results as reports that you can review, compare, and manage.
Report Types
| Type | Created By | Description |
|---|---|---|
| Standard Benchmark | /bench start | Full benchmark suite with all tests |
| Unit Test | /bench test <name> | Single test result |
| Stress Limit | /bench stresslimit | Stress limit mode results |
Viewing Reports
In-Game GUI
/bench reports
Opens a paginated inventory GUI showing all saved reports, sorted by date (newest first). Click a report to view its details:
- Overall VoxelScore and rank
- Individual test results
- TPS and MSPT averages
- Hardware information at time of test
Automatic Display
By default, reports are shown automatically after a test or benchmark completes:
reports:
auto-show-report: true
Set to false to disable automatic display.
Comparing Reports
From the report detail view in the GUI, you can compare two reports side-by-side to see performance differences. This is useful for:
- Measuring the impact of server configuration changes
- Tracking performance over time
- Comparing before and after hardware upgrades
Storage
Reports are saved as JSON files in plugins/VoxelBench/reports/:
plugins/VoxelBench/reports/
standard/
2026-01-21_12-30-45.json
2026-02-15_08-00-00.json
unit-test/
2026-01-21_14-00-00.json
stresslimit/
2026-01-22_10-30-00.json
Storage Configuration
Control which report types are saved:
reports:
storage:
unit-tests: true # Save individual test results
benchmarks: true # Save full benchmark results
stresslimit: true # Save stress limit results
Retention
Automatic cleanup prevents reports from accumulating indefinitely:
reports:
retention:
max-age-days: 90 # Delete reports older than 90 days (-1 = unlimited)
max-per-type: 100 # Max reports per type (-1 = unlimited)
max-total: 500 # Max total reports (-1 = unlimited)
cleanup-on-startup: true # Run cleanup when server starts
Backend Sync
If you've linked your account (see Account Linking), you can sync unit test results to voxelbench.com:
reports:
backend:
unit-tests: true
When enabled, individual test results (from /bench test) are automatically submitted to the backend for tracking in your account dashboard.
Full benchmark results are always submitted to the backend when in authenticated mode.
Online Reports
Visit voxelbench.com to:
- View your full report history
- Compare your server with others
- Share reports with your community
- Track performance trends over time