Documentation

Learn how to install and use LiquidBounce with our comprehensive guides

Debug

Debug is a diagnostic overlay aimed squarely at developers and advanced users who want to peek under the hood of the client. When other modules expose internal data — server-sided rotations, hitboxes, target lines, predicted paths and other geometry, plus live parameter values — Debug draws that information into the world and onto your screen so you can see exactly what the client is calculating.

For everyday play there's nothing here to gain; it doesn't give you any in-game advantage. It's most useful when you're testing behavior, reporting a bug, or trying to understand why a feature like KillAura or Scaffold is acting a certain way. Captured parameter values are shown in a list that fades out after a set time, and holding the player-list (Tab) key temporarily hides that overlay.

The optional groups add their own visualizations: SimulatedPlayer draws a predicted line showing where your movement is heading over the next several ticks, and Graph renders a small on-screen plot of an editable curve for tuning value mappings.

Because many modules report data at once, TitleFilter lets you narrow the capture to the sources whose name matches a regex pattern; everything else is ignored, both on screen and in the log. With DebugLog enabled, captured parameter values are additionally written to a tab-separated file in the debug-log folder of your LiquidBounce directory, one file per time the module is switched on, with a line of timestamp, source, name and value per capture. That makes it easy to attach a recording of what the client calculated to a bug report.

Category: Render Enabled by default: No

Settings

SettingTypeDefaultRangeDescription
ParametersToggletrue—Shows the on-screen list of captured parameter values reported by other modules.
GeometryToggletrue—Draws debug geometry (lines, boxes, points, triangles) that other modules submit into the world.
ExpiresInteger51..30 (secs)How long a captured parameter value stays on screen before fading away.
TitleFilterText.*—Regex pattern matched against the name of the module or feature reporting the data; only matching sources are captured.
DebugLogTogglefalse—Writes captured parameter values to a tab-separated file in the debug-log folder of your LiquidBounce directory. The file is created when the module is enabled.
SimulatedPlayerToggleable Groupoff—Draws a line predicting your movement path over the coming ticks.
SimulatedPlayer → TicksToPredictInteger205..100How many ticks ahead the predicted movement path is simulated.
GraphToggleable Groupoff—Renders an on-screen plot of the editable curve below for visual tuning.
Graph → CurveCurve——The curve drawn and edited in the on-screen graph.

Last updated: 2026-09-25 — Based on source code