promotional bannermobile promotional banner

LagFinder

Find WHERE your server lags: ranks the hottest chunks with their block entities and mobs, highlights them in the world, exports an HTML heatmap. Server-side, no client mod needed.
lagmap-report-example.png

lagmap-report-example.png

Description

LagFinder

Your server is lagging and spark tells you "block entity ticking: 34%". Great - but where? Which chunk, which farm, whose base?

LagFinder answers that in one minute, with no client mod:

/lagfinder start 30    - sample 30 seconds (zero overhead when idle)
/lagfinder top         - the hottest chunks, ranked

#1 overworld chunk [5, 5]   4.04 ms/tick (42%)  [BE 1.13  ent 2.91]  zombie 2.42, hopper 1.13  near Steve (12 m)  [tp]
#2 overworld chunk [60, 60] 0.48 ms/tick (5%)   [BE 0.48]            hopper 0.48                                  [tp]

/lagfinder show        - glowing red/orange/yellow markers over the hottest chunks, visible to every player, even vanilla clients
/lagfinder hide        - remove the markers
/lagfinder export      - self-contained HTML heatmap + table you can open in a browser or send to your players
/lagfinder status      - is sampling running, how many ticks were measured

(/lagmap works as an alias for every command.)

What it measures, per chunk

  • block entities (hoppers, furnaces, modded machines) - with the type that costs most
  • entities - with the mob type that costs most
  • scheduled block & fluid ticks and random ticks
  • what share of the whole server tick that chunk takes, and the nearest player
  • click [tp] in chat to teleport straight to the chunk

Why LagFinder

  • Real measurement, not an estimate. Every block entity, entity, block tick and random tick is timed with nanosecond precision and attributed to its chunk.
  • Server-side only. Nothing to install for players. Works with vanilla clients.
  • No dependencies. No Fabric API, no Architectury, no Kotlin.
  • Zero overhead when not sampling - one boolean check per hook. Start it only when you need it.
  • Spiritual successor to LagGoggles (1.12) and Observable (up to 1.21.4), rebuilt from scratch for 1.21.8 - 26.3.

Versions

Fabric (Quilt works too) and NeoForge: 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1.x, 26.2, 26.3. Java 21 for 1.21.x, Java 25 for 26.x. Pick the file that matches your game version and loader.

Permission level 2 (op) is required for /lagfinder.

How to read the result

ms/tick is how much of every server tick that chunk costs. A vanilla tick has 50 ms; a chunk that takes 10+ ms/tick on its own is the reason your TPS drops. The breakdown tells you what in that chunk is expensive (a mob farm, a wall of hoppers, a modded machine), and the nearest player tells you whose it is.

Found a bug or want a feature? Use the Issues tab.

LagFinder Team

profile avatar
Owner
  • 3
    Followers
  • 36
    Projects
  • 89.8K
    Downloads

Minecraft mod creator

More from PokatoView all

  • What Changed? - Modpack Update Changelog project image

    What Changed? - Modpack Update Changelog

    Automatic modpack changelog: after every update see exactly which mods, items, mobs, recipes, biomes, structures, enchantments and dimensions were added, removed or changed.

    • 28
    • October 11, 2026
  • Dragons project image

    Dragons

    Tame, saddle and fly six elemental dragons, each dragon with its own animated model and ability: fire breath, frost breath, lightning, venom, void blink and tidal jet.

    • 4.9K
    • October 10, 2026
  • Combo Counter project image

    Combo Counter

    See your PvP combo on screen. Counts only hits that actually land, shows reach, crits and your best combo. Client-side, press J to toggle.

    • 25
    • October 10, 2026
  • Biome Bosses: Trial Sentinel project image

    Biome Bosses: Trial Sentinel

    A copper colossus guards the Trial Chambers: a three-phase boss fight with reinforcements, gale attacks and an oxidation armor you scrape off with an axe.

    • 239
    • October 9, 2026
  • What Changed? - Modpack Update Changelog project image

    What Changed? - Modpack Update Changelog

    Automatic modpack changelog: after every update see exactly which mods, items, mobs, recipes, biomes, structures, enchantments and dimensions were added, removed or changed.

    • 28
    • October 11, 2026
  • Dragons project image

    Dragons

    Tame, saddle and fly six elemental dragons, each dragon with its own animated model and ability: fire breath, frost breath, lightning, venom, void blink and tidal jet.

    • 4.9K
    • October 10, 2026
  • Combo Counter project image

    Combo Counter

    See your PvP combo on screen. Counts only hits that actually land, shows reach, crits and your best combo. Client-side, press J to toggle.

    • 25
    • October 10, 2026
  • Biome Bosses: Trial Sentinel project image

    Biome Bosses: Trial Sentinel

    A copper colossus guards the Trial Chambers: a three-phase boss fight with reinforcements, gale attacks and an oxidation armor you scrape off with an axe.

    • 239
    • October 9, 2026