Commands and Permissions

Commands and Permissions

The main command is /optimizeserver, with the alias /os. Every command works both in-game and from the server console, and tab completion is supported.

Monitoring

Command	Permission	Description
/os help [page]	optimizeserver.status	Paginated command reference
/os version	optimizeserver.status	Platform, Minecraft version, JVM, and integration details
/os status	optimizeserver.status	Overall server performance summary
/os tps	optimizeserver.status	Rolling TPS over 5s, 30s, 1m, 5m, and 15m
/os mspt	optimizeserver.status	Average, P50, P95, P99, and standard deviation of MSPT
/os cpu	optimizeserver.status	CPU usage for the server process and for the whole host
/os memory	optimizeserver.status	Heap, non-heap, GC pause rate, and allocation rate
/os network	optimizeserver.status	Player ping, shown separately from server-side processing delay
/os entities	optimizeserver.status	Read-only entity and tile-entity counts by type and world

Chunks (Chunky)

Command	Permission	Description
/os chunks / /os chunks status	optimizeserver.chunks	Chunk telemetry and Chunky task status
/os chunks recommend	optimizeserver.chunks	Suggests a pre-generation radius
/os chunks start	optimizeserver.chunks	Starts Chunky pre-generation manually
/os chunks pause	optimizeserver.chunks	Pauses pre-generation
/os chunks cancel	optimizeserver.chunks	Cancels pre-generation

Diagnostics & Profiling

Command	Permission	Description
/os diagnose [full|cpu|memory|chunks|entities|plugins]	optimizeserver.diagnose	Finds the bottleneck, with supporting evidence and recommendations
/os profile start	optimizeserver.profile	Starts a Spark profiling session
/os profile stop	optimizeserver.profile	Stops the session
/os profile status	optimizeserver.profile	Shows the current profiling state
/os profile memory	optimizeserver.profile	Memory diagnostics
/os health	optimizeserver.profile	Combined server and Spark health report

Optimization

Command	Permission	Description
/os optimize / /os optimize status	optimizeserver.optimize	Current optimization mode and module states
/os optimize list	optimizeserver.optimize	Lists every optimization module
/os optimize enable <module>	optimizeserver.optimize	Enables a module (checked by SafetyValidator first)
/os optimize disable <module>	optimizeserver.optimize	Disables a module
/os optimize rollback	optimizeserver.optimize	Rolls back module changes

Reports & Admin

Command	Permission	Description
/os report generate	optimizeserver.report	Saves a full diagnostic report to plugins/OptimizeServer/reports/
/os report history	optimizeserver.report	Lists saved reports
/os reload	optimizeserver.reload	Reloads config.yml and checks it again

Permission Nodes

Node	Default	Grants
optimizeserver.admin	op	All nodes below
optimizeserver.status	op	Monitoring commands
optimizeserver.diagnose	op	/os diagnose
optimizeserver.optimize	op	/os optimize
optimizeserver.profile	op	/os profile, /os health
optimizeserver.chunks	op	/os chunks
optimizeserver.report	op	/os report
optimizeserver.reload	op	/os reload

Example: let a staff group (in LuckPerms) view stats without being able to change anything:

/lp group staff permission set optimizeserver.status true
/lp group staff permission set optimizeserver.diagnose true