LagGoggles Mod 1.12.2, — Guide

Controls and GUI

The mod is primarily accessed through an in-game GUI rather than physical items.

• Default Keybind: INSERT key. This opens the LagGoggles main menu.
• Alternative Keybinds: If the Insert key conflicts with other mods, it can be rebound in the standard Minecraft Controls menu under the "LagGoggles" category.

From the main menu, users can choose between different profiling modes, view previous results, or clear the current overlay.

Mechanics and Profiling

LagGoggles operates by timing the execution of the update and tick methods for every active object in the world.

Profiling Types

The Color Scale

When the overlay is active, blocks and entities are highlighted with a gradient that indicates their performance impact: * Green: Very low impact (0 - 25 µs/t). Normal for most blocks. * Yellow: Moderate impact (25 - 100 µs/t). Common for active machines. * Orange: High impact (100 - 500 µs/t). Potential source of lag if many are present. * Red: Severe impact (500+ µs/t). Likely the primary cause of server or client lag.

Microseconds per Tick (µs/t)

Lag is measured in microseconds (µs). A Minecraft server has 50,000 µs (50ms) to process a single tick to maintain 20 TPS. If the total sum of all block and entity updates exceeds this threshold, the server will experience TPS lag.

Entities and Tile Entities

LagGoggles does not add new mobs or blocks to the game; instead, it provides a detailed analysis of existing ones.

Analyzed Objects

• Tile Entities: Any block that stores data or performs actions, such as Furnaces, Chests, and complex machinery from other mods (e.g., Thermal Expansion, Applied Energistics 2).
• Entities: All living creatures (mobs), dropped items, and projectiles. Large concentrations of animals or items on the ground are common lag sources identified by the mod.
• Event Subscribers: Code from other mods that runs every tick but isn't attached to a specific block or entity.

Result Analysis

After a profile run (default 30 seconds), the "Analyze Results" button opens a list view. This list sorts every tracked object by its impact, showing the name, coordinates, and exact timing.

Teleportation: Players with appropriate permissions can double-click any entry in the analysis list to teleport directly to the source of the lag, even across dimensions.