Permissions — Getting Started

Permission Tree

Base Permissions

Permission	Default	Description
`voxelbench.use`	OP	Use basic VoxelBench commands (`/bench tps`, `/bench link`)
`voxelbench.gui`	OP	Open the main GUI (`/bench gui`)
`voxelbench.info`	OP	View system information (`/bench info`)
`voxelbench.start`	OP	Run full benchmarks (`/bench start`)
`voxelbench.start.force`	OP	Bypass rate limit cooldown
`voxelbench.stop`	OP	Stop running benchmarks (`/bench stop`)
`voxelbench.reload`	OP	Reload configuration (`/bench reload`)
`voxelbench.lang`	All	Change language (`/bench lang`)
`voxelbench.reports`	OP	Manage reports (`/bench reports`)
`voxelbench.verify`	OP	Verify server ownership (`/bench verify`)
`voxelbench.stresslimit`	OP	Run stress limit mode

Test Permissions

The voxelbench.test permission grants access to all individual tests. You can also grant specific test categories or individual tests.

Permission	Includes
`voxelbench.test`	All tests (hardware + gameplay + single-core)
`voxelbench.test.hardware`	All hardware tests
`voxelbench.test.gameplay`	All gameplay tests
`voxelbench.test.singlecore`	All single-core tests

Hardware Tests

Permission	Test
`voxelbench.test.multicore`	Multi-core CPU test
`voxelbench.test.memory`	Memory bandwidth/latency test
`voxelbench.test.disk`	Disk I/O test
`voxelbench.test.network`	Network latency test

Single-Core Tests

Permission	Test
`voxelbench.test.mobpathfinding`	Mob pathfinding (A*)
`voxelbench.test.redstone`	Redstone circuits
`voxelbench.test.blockphysics`	Block physics (falling blocks)

Gameplay Tests

Permission	Test
`voxelbench.test.chunkloading`	Chunk loading/generation
`voxelbench.test.mobspawn`	Entity spawning
`voxelbench.test.hopper`	Hopper item transfer
`voxelbench.test.explosion`	TNT explosions
`voxelbench.test.worldsave`	World save performance
`voxelbench.test.lighting`	Lighting engine
`voxelbench.test.collision`	Entity collision
`voxelbench.test.tileentity`	Tile entity ticking
`voxelbench.test.villager`	Villager trading AI
`voxelbench.test.chunkticking`	Random tick processing
`voxelbench.test.bonemealgrowth`	Vegetation growth
`voxelbench.test.liquidphysics`	Water/lava flow
`voxelbench.test.combatsimulation`	Combat AI simulation
`voxelbench.test.mobai`	Mob artificial intelligence

Monitor Permissions

Permission	Includes
`voxelbench.monitor`	All monitoring features
`voxelbench.monitor.bars`	Boss bar monitoring
`voxelbench.monitor.web`	Web dashboard management

Dynmap Permissions

These permissions control who can view VoxelBench layers on Dynmap's web interface.

Permission	Description
`voxelbench.dynmap`	All Dynmap layers
`voxelbench.dynmap.view`	Global view access
`voxelbench.dynmap.heatmap`	Entity density heatmap
`voxelbench.dynmap.alerts`	Performance alert markers
`voxelbench.dynmap.testzones`	Active test zone markers

Note: Dynmap permissions require additional configuration in plugins/dynmap/markers.yml. See Integrations - Dynmap for details.

World management

Node	Default	Grants
`voxelbench.world`	op	All `/bench world` subcommands (`list`, `show`, `set`, `unset`, `create`, `delete`).

The node is a single gate — no per-subcommand split, since all six actions manipulate voxelbench_* worlds and require equivalent trust. The voxelbench_* prefix is enforced server-side; operators with this node cannot delete your survival map.

Custom benchmark profiles

Node	Default	Grants
`voxelbench.custom`	op	All `/bench custom` subcommands (`run`, `list`, `info`, `reload`).

Extension tests

Extension tests inherit the same permission scheme as built-in tests:

Node pattern	Grants
`voxelbench.test`	All tests, including extension tests.
`voxelbench.test.<ownerplugin>.<testid>`	One specific extension test.

The host plugin registers the permission automatically when the extension calls TestRegistry.register(...). Operators don't need to edit plugin.yml to grant a per-test permission for a freshly-installed extension.

LuckPerms Examples

Grant full access to an admin group

/lp group admin permission set voxelbench.* true

Allow a group to run tests but not full benchmarks

/lp group moderator permission set voxelbench.test true
/lp group moderator permission set voxelbench.gui true
/lp group moderator permission set voxelbench.info true

Allow all players to check TPS

/lp group default permission set voxelbench.use true