LagGoggles icon indicating copy to clipboard operation
LagGoggles copied to clipboard

A minecraft forge mod which visualises lag in the world

LagGoggles

Intuitive lag hunting!

Notice: For versions above 5.3 you need to have TickCentral installed!

TickCentral provides the functionality to be compatible with Mixin, and is intended to work across various Minecraft versions. I have decided to move away from Mixin because I noticed a lot of people having versioning issues with it. (One mod requiring version X, another shipping version Y, Change in behavior in version Z...)

I am currently working on a complete rewrite of this mod with added functionality.

The planned main functionality is listed below:

  • ~~Throttling block ticking based upon tps, PER PLAYER. This means that every player gets an equal share of tick time on his/her machines. Needs performance testing to see if this is viable. TileEntities will be assigned owners when placed or claimed by a player.~~ Done! This is part of Tiquality
  • Network profiling, monitor in and outgoing bytes
  • Browser interface instead of in-game. Allows for multi monitor setups and much more space to fit content in a proper manner.

If you have suggestions, I will take them into consideration.
LagGoggles is a profiler where you can see timings in the world, visually. It comes with a custom GUI using a configurable keybind. It's compatible with SpongeForge and Mixin.
You can use LagGoggles as a player too! This is my attempt to create an understanding of what causes lag on a server to regular players.
I noticed some common misconceptions like having machines spread out over different chunks causes less lag than putting it in one chunk.
With LagGoggles, you can look around and see that alot of small things like pipes or cables cause a tiny bit of lag most of the time, often resulting in more lag than a machine right next to the source would.

LagGoggles can also profile clientside FPS as of version 4.0! Note that this only works on rendering entities.

Download: here

Screenshots

LagGoggles enabled normal view
alt text alt text
alt text alt text
alt text alt text

alt text alt text alt text alt text

Video explaining the concept

Massive thanks to Grok DuckFarmer for making this video.

Minecraft Talk 35 - LagGoggles and Better Server Play

IMAGE ALT TEXT HERE

Features

  • Teleporting to sources of lag
  • Client GUI, including overlay and clickable menus
  • Colour scale for easy spotting of sources of lag.
  • Calculations are done on the client, so each client can have a different colour scale.
  • Clientside FPS support!
    • Checks render time for Entities, Tile entities and event subscribers
    • It's very young, but it should give some insight in what may cause FPS issues.
  • Config for client:
    • Custom gradients
    • Colorblindness support
  • Config for server
    • Custom permissions for players (non-operators)

Configuration

  • Drop the jar in the /mods folder
  • Make sure you have TickCentral installed. Try the latest version you can find first.
  • Serverside configuration is not required and has no effect.
  • Clients can edit the config to change the colour scale.

How it works

Entities, blocks and event-subscribers are timed using System.nanotime() before and after the tick() and update() methods. These times are recorded and sent to the client when the profiler is done.

Benefits

  • Visualisation of various sources of lag
  • Learn your players to build lag-free bases.

Dependencies

TickCentral

Incompatible

Tiquality, (for now)