Sampler Wiki › FAQ
Sampler FAQ
10 questions players actually ask, answered.
What does the Sampler mod do?
Sampler is a performance profiling and diagnostic utility for Minecraft that helps identify TPS lags, FPS drops, and memory leaks. It provides real-time graphs and external analysis tools for both client and server.
What Minecraft versions does Sampler support?
Sampler is available for Minecraft 1.12.2 and 1.11.2.
Does Sampler add new items or blocks?
No, Sampler does not add any new items or blocks. It is purely a performance analysis and debugging tool.
How do I use Sampler?
Sampler is command-driven. Use /sampler help for server-side commands and /csampler help for client-side commands. Each command follows the pattern /sampler [ ] or /csampler [ ].
What are the main features of Sampler?
Sampler includes a sampling profiler, event-based sampling triggers, precise tickrate information, ticking game object counts, memory and garbage collection statistics, TESR highlights, chunk update source highlights, and sub-commands for network I/O, chunk loads, saves, and finding blocks or entities.
Does Sampler cause lag or overhead?
Sampler is designed to have no observable overhead while idle and very little overhead during profiling.
Who is Sampler intended for?
Until further documentation or the GUI is done, Sampler's target audience is mostly advanced users or anyone asked to provide debugging data by mod or mod pack authors.
How do I check my server's tickrate with Sampler?
Use the tps sub-command or press F3 to get precise tickrate information.
How do I profile where Minecraft spends its time?
Use the sampler sub-command to start, wait, stop, and export profiling data. This shows exactly where the Minecraft client or server spends its time.
How do I capture only lag spikes with Sampler?
Use the trigger sub-command to set up event-based sampling triggers, such as capturing only lag spikes.