MeowMC

The /meow suite

The /meow command suite is MeowMC's built-in profiler, health and report surface — what a plugin like spark would give you, with no plugin to install. Both /meow and /meowmc dispatch the same command.

| Command | Purpose | Permission | | --- | --- | --- | | /meow health | One page: MSPT, TPS windows, memory, GC, chunks, entities, threads, platform. | bukkit.command.meowmc.health | | /meow tps | TPS history as inline bars across five windows. | bukkit.command.meowmc.tps | | /meow profiler | Start, stop and status for a sampling profiler. | bukkit.command.meowmc.profiler | | /meow activity | Top threads by CPU time over the last window. | bukkit.command.meowmc.activity | | /meow report | One JSON artifact: health + last profiler session + platform. | bukkit.command.meowmc.report | | /meow config | View and set the live config: view, list, get, set, diff. | bukkit.command.meowmc.config | | /meow setup | Re-enter the first-run wizard's preset picker (boot-only). | bukkit.command.meowmc.setup | | /meow hologram | Scenes, components and placeholders — the hologram lane. | bukkit.command.meowmc.hologram | | /meow panel | Turn the web admin panel's pairing service on and off. | bukkit.command.meowmc.panel | | /meow threads | Thread inventory. (pre-existing) | bukkit.command.meowmc.threads | | /meow benchmark dump | Machine-readable benchmark dump to dumps/. (pre-existing) | bukkit.command.meowmc.benchmark | | /meow perfhud | In-game performance HUD toggle. (pre-existing) | bukkit.command.meowmc.perfhud |

See Permissions for the exact permission names, their default, and the one root permission that grants the whole suite.

How to read these pages

Every output panel on these pages is an example:

MSPT 14.2ms (budget 50.0ms)
TPS  5s 20.0  10s 20.0  1m 19.8  5m 19.4  15m 18.9
Memory 1.1 GB / 4.0 GB heap  direct 88 MB / 1.0 GB
GC 2.4% of wall time
Chunks 1284  Entities 3120
Threads 28 jvm, 6 registered pool(s)
MeowMC 26.3 (MC: 26.3) on 26.3 — Java HotSpot(TM) 64-Bit Server VM 25+38, 8 cores
Example output.

What the suite is not

  • Not a web service. /meow report and /meow profiler stop write the artifact to disk and print the path. The report viewer at meowmc.org/r/<id> exists, but upload is off: no client in the jar speaks the upload API. See Report artifacts.
  • Not a second metric pipeline. Every subcommand reads numbers the server already computes, or computes them once when asked. The per-thread CPU sampler runs only while a profiler session or an activity window is open.
  • No performance claims. What the suite costs on a live server has not been measured.

The profiling block in config/meowmc-global.yml gates the suite:

meowmc:
  profiling:
    support-cpu-time: true        # per-thread CPU segment — gates activity + profiler thread view
    relative-mspt-thresholds: true
    per-region-profiling: true    # meaningful only at regionized execution and above
    benchmark-dump: true          # the machine-readable dump command

See global keys — profiling.