MCBenchmark

MCBenchmark

MCBenchmark is an advanced Minecraft server benchmarking plugin designed to help server administrators analyze and optimize performance. It provides a suite of configurable, adaptive benchmarking tools for real-time diagnostics of key server systems — including chunk loading, entities, blocks, tile entities, ping, and TPS.

Whether you're debugging lag, testing server performance under load, or profiling system behavior for optimization, MCBenchmark gives you the tools you need with detailed metrics and intelligent throttling.

---

What It Does

• Adaptive Chunk Benchmarking: Measures how fast chunks can be loaded without overwhelming the server, adjusting dynamically based on current TPS.
• Entity Benchmarking: Spawns and processes entities in a controlled environment to identify performance limits and bottlenecks.
• Block Benchmarking: Randomly samples blocks across an area to test block interaction peeformance by material, radius, and sample size.
• Tile Entity Benchmarking: Evaluates server handling of tile entities (e.g., chests, hoppers) under load.
• Ping Benchmarking: Repeatedly pings the server to generate latency metrics, including averages and variation.
• TPS Monitoring: Continuously tracks server TPS with adaptive sampling for accurate benchmarking.
• Benchmark Control: Instantly stop all running benchmarks with a single command for safety and control.

---

Commands

/chunkbenchmark [radius] [max_cps]

• Adaptive chunk loading benchmark based on TPS
• Aliases: cbench, chunkbench
• Permission: mcbenchmark.chunk

/entitybenchmark [iterations]

• Stress-test server with high-iteration entity spawning
• Aliases: ebench, entitybench
• Permission: mcbenchmark.entity

/blockbenchmark [material] [radius] [samples]

• Random block sampling benchmark with customizable parameters
• Aliases: bbench, blockbench
• Permission: mcbenchmark.block

/tilebenchmark [iterations]

• Intensive benchmarking for tile entities (e.g., chests, hoppers)
• Aliases: tbench, tilebench
• Permission: mcbenchmark.tile

/pingbenchmark [iterations]

• Multiple pings to the server with detailed statistics
• Aliases: pbench, pingbench
• Permission: mcbenchmark.ping

/tpsbenchmark [iterations]

• Continuous TPS tracking with adjustable sampling
• Aliases: tpsbench, tps
• Permission: mcbenchmark.tps

/stopbenchmark

• Stops all currently running benchmarks immediately
• Aliases: stopbench, sbench, stop
• Permission: mcbenchmark.stop

---

Permissions

• mcbenchmark.* — Access to all commands (default: OP)
• Individual command permissions:
  • mcbenchmark.chunk
  • mcbenchmark.entity
  • mcbenchmark.block
  • mcbenchmark.tile
  • mcbenchmark.ping
  • mcbenchmark.tps
  • mcbenchmark.stop

Each permission defaults to OP and can be customized via permission plugins (e.g., LuckPerms).

---