Tick Hunter

Find what is really slowing down your Minecraft modpack.

Tick Hunter is a lightweight runtime lag analyzer for Minecraft. It monitors server ticks, samples the server thread during gameplay, and attempts to identify mods, classes, and entities that may be contributing to lag spikes.

Instead of manually removing mods one by one, you can run Tick Hunter while the game is lagging and generate a detailed performance report.

Features

• Real-time server tick monitoring
• Detects lag ticks and performance spikes
• Analyzes the Minecraft server thread
• Attempts to identify suspected mods
• Detects potentially problematic classes and entities
• Automatic risk levels: LOW, MEDIUM, HIGH, and CRITICAL
• Confidence-based analysis
• Human-readable performance verdict
• Detailed developer information
• Full stack traces for captured lag spikes
• Generates reports automatically

Commands

/tickhunter start

Starts performance analysis.

/tickhunter status

Shows the current analyzer status, analyzed ticks, lag ratio, samples, and captured spikes.

/tickhunter stop

Stops the analyzer and generates a report.

Reports

Tick Hunter saves reports in:

tickhunter-reports/

The beginning of the report is designed to be understandable for regular players.

Example:

MOST LIKELY LAG SOURCE:

Alex's Mobs [alexsmobs]

RISK LEVEL: CRITICAL CONFIDENCE: HIGH

Possible problematic class/entity: EntityCentipedeBody

The developer section contains detailed class information, sampling statistics, spike scores, and stack traces.

How to Use

1. Start your Minecraft world or server.
2. Wait until you experience lag.
3. Run /tickhunter start.
4. Play normally while the lag is happening.
5. Let Tick Hunter analyze the game for several minutes.
6. Run /tickhunter stop.
7. Open the generated report in the tickhunter-reports folder.

For better results, run Tick Hunter for 5–10 minutes during active lag.

Important

Tick Hunter uses runtime stack sampling.

A detected mod is not automatically guilty. A mod may appear in a stack trace because it is part of a larger execution chain.

Always verify the result by temporarily disabling the suspected mod and testing the game again.

Tick Hunter is a diagnostic tool designed to help narrow down possible sources of Minecraft server-side lag.

Supported Version

Minecraft Forge 1.20.1

Why Tick Hunter?

Large modpacks can contain hundreds of mods. Finding the source of lag manually can take hours.

Tick Hunter helps you hunt down suspicious runtime activity and gives you a starting point for further testing.

Start the hunt. Find the lag.