Description

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...)

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

Video explaining the concept

Massive thanks to Grok DuckFarmer for making this video.

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 primitive, 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 done through LagGoggles-server.cfg
• Clients can edit the config in-game 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

Contributing

• Submit a pull request!
• If you have suggestions, I will take them into consideration. Please note my time is extremely limited. Pull requests are the way to go here.

What means Verified?

• Compatibility: The mod should be compatible with the latest version of Minecraft and be clearly labeled with its supported versions.
• Functionality: The mod should work as advertised and not cause any game-breaking bugs or crashes.
• Security: The mod should not contain any malicious code or attempts to steal personal information.
• Performance: The mod should not cause a significant decrease in the game's performance, such as by causing lag or reducing frame rates.
• Originality: The mod should be original and not a copy of someone else's work.
• Up-to-date: The mod should be regularly updated to fix bugs, improve performance, and maintain compatibility with the latest version of Minecraft.
• Support: The mod should have an active developer who provides support and troubleshooting assistance to users.
• License: The mod should be released under a clear and open source license that allows others to use, modify, and redistribute the code.
• Documentation: The mod should come with clear and detailed documentation on how to install and use it.

How to Install