Pewpew Bench Plugin

Minimal benchmark plugin used by the Pewpew harness. It builds repeatable workloads (villagers, hostiles, villages) and records MSPT/TPS samples.

!!!DO NOT USE IN PRODUCTION SERVER!!!

Build

./gradlew jar -PpewpewApiVersion=1.21.8-R0.1-SNAPSHOT

Install

Copy the jar from build/libs/ into your server plugins/ directory and start the server once to generate plugins/PewpewBench/config.yml.

Config highlights

• mode: single or multiworld
• worlds: list of world names in multiworld mode
• place-villages: place villages before benchmarking
• hostiles-per-player: multiworld hostile count per player slot
• hostile-spawn-radius: multiworld hostile spawn radius around villages
• post-village-delay-ticks: delay after placing villages before spawning entities
• teleport-delay-ticks: delay between teleporting players for chunk loading

Notes

• In multiworld mode, the plugin writes plugins/PewpewBench/multiworld-ready.txt after world setup so bots can join before player distribution.
• Runtime stats are logged every ~5 seconds with MSPT, villager, and hostile counts.