Wiki 9Minecraft Wiki 9Minecraft

Observable Mod Wiki & Guide

Guides 4FAQ 19Related mods 60

A Minecraft mod that adds no blocks or items, instead providing observation and debugging tools for inspecting game state and behavior.

DownloadObservable Mod

Get the files on 9Minecraft

Contents (6)
  1. Overview
  2. Guides
  3. Frequently asked questions
  4. Dependencies
  5. Gallery
  6. You May Also Like

Overview

Observable is a powerful diagnostic tool designed to help players and server administrators pinpoint performance bottlenecks within Minecraft. Unlike traditional profilers that output complex text files, Observable provides a user-friendly graphical interface and an in-world visual overlay. It tracks the execution time of various game elements, including entities (mobs, items, projectiles), block entities (chests, furnaces, machines), and scheduled events.

The mod is essential for troubleshooting 'TPS' (Ticks Per Second) drops, allowing users to see exactly which objects are consuming the most processing power in microseconds (µs).

Guides

Step-by-step, in-game.

Filter and Focus on Significant Performance IssuesReducing Noise in Your Data When profiling, the mod tracks everything affecting TPS—including minor impacts that…Locate and Teleport to Lag SourcesFinding Problem Areas After running a profile and viewing results, you'll see chunk coordinates and entity listings…Start Your First Performance ProfileOpening the Profiler Press R (default hotkey) while in-game to open the Observable Mod interface. You'll see the…Use the Overlay to Visualize Lag in Real-TimeEnabling the Overlay After completing a profile and viewing results, click the Overlay button in the profiler GUI.…

Frequently asked questions

How do I open the Observable Mod profiler?
Press R (the default hotkey) while in-game to open the profiler GUI. You can change this hotkey in the mod's settings if needed.
What's the difference between TPS and FPS, and why does Observable only track TPS?
TPS measures server-side performance (entity updates, block changes, chunk generation), while FPS measures your graphics card's frame rendering. Observable currently focuses on TPS because server lag affects all players, but client-side FPS monitoring is planned for the future.
How long can I record gameplay with the profiler?
You can record up to 30 seconds of gameplay by clicking Profile TPS in the profiler GUI. This duration is enough to capture most lag spikes and performance issues.
Can I teleport directly to laggy entities or chunks?
Yes, after profiling completes and you view the Results, you can click on specific entities, mobs, or chunk coordinates to teleport to them for closer inspection.

See all 19 Observable questions ›

Dependencies

Other mods needed to run this one.

Architectury (required)