Leaf Client Docs

Displays your current frames per second in a configurable corner of the screen. You can choose the position, text color, and whether to show a colored indicator that turns red when FPS drops below a threshold you set. Useful for monitoring performance without opening an external tool.

Shows clicks per second for left and right mouse buttons, tracked over a rolling one-second window. Configurable position, scale, and color — you can also choose to display one button or both. Commonly used in PvP to verify clicking technique and spot inconsistencies.

Displays your current server latency in milliseconds, updated every second. Position and color are configurable, and you can optionally set color thresholds so the number turns yellow or red when latency climbs above values you define. Works on any server — reads the standard ping from the tab list.

Shows your X, Y, Z coordinates and current biome name at all times. You can toggle each field independently — for example, display only X/Z for navigation while hiding Y. The direction you are facing (N/S/E/W) can also be enabled as an optional sub-label.

Displays your equipped armor pieces and their remaining durability as both a numeric value and a color-coded bar. The bar transitions from green to yellow to red as durability drops, giving you an at-a-glance warning before a piece breaks. Each slot (helmet, chestplate, leggings, boots) is shown individually and can be hidden if empty.

Shows real-time WASD, jump, and mouse key presses on screen. Configurable colors, scale, and animations.

Tracks the total count of a specific item across your entire inventory, including hotbar, main inventory, and offhand. You can pin any item type to watch — useful for tracking arrows, food, or building materials mid-session. Auto-detection mode automatically highlights the item currently in your main hand.

Displays CPU usage and memory consumption so you can monitor system load without alt-tabbing. Shows used vs. allocated heap memory and overall JVM CPU time, updated every second. Useful for diagnosing lag spikes or confirming that your RAM allocation is appropriately sized for your setup.

Shows the current server IP address and online player count on your HUD, pulled directly from the server connection. The player count updates in real time as people join or leave. You can configure which fields are visible and choose to display a custom label instead of the raw IP for cleaner presentation on known servers.

Renders a real-time top-down minimap that updates as you explore, built on an optimized chunk-scanning system. Size, zoom level, and screen position are all configurable. Waypoints you create are shown as labeled pins on the map, and an optional coordinates overlay displays your current position beneath the minimap frame.

Displays the current in-game day number, time of day as a 24-hour clock, and the current moon phase icon. Each element can be toggled independently so you only show what you need. Handy for planning nighttime activities or tracking how many days have passed in a survival world.

Shows the Leaf Client branding logo on your HUD. Purely cosmetic — it has no effect on gameplay. Position and scale are configurable, and you can disable it entirely if you prefer a clean screen. It is on by default as a subtle indicator that you are running Leaf Client.

Press Left Alt to enter spectate mode. Your camera detaches and floats freely — look and move around without affecting your character's position. Press again to return. Servers can disable this.

Sprint and sneak by toggling instead of holding. Supports fly speed boost when sprinting in creative mode.

Hold C to zoom in. Scroll the mouse wheel while zooming to adjust the zoom level. Smooth cinematic zoom transitions included.

Maximizes in-game brightness so you can see in caves and dark areas without needing torches or night vision. It works by overriding the client-side gamma value and has no effect on the server — other players see normal lighting. Servers can disable this via the leafclient:control channel if their gameplay depends on darkness.

Adds a configurable motion blur effect when panning the camera, implemented via a post-processing shader for smooth, high-quality results. Blur intensity is adjustable — lower values give a subtle cinematic feel while higher values produce a more dramatic effect. Has no performance impact on most modern GPUs since it runs entirely on the GPU pipeline.

Held light-emitting items — torches, glowstone, lanterns, sea lanterns, and similar blocks — cast real-time light onto nearby blocks and entities as you move. This is purely client-side and does not affect the server's lighting engine or other players. It significantly improves visibility when mining or exploring without committing to placing torches everywhere.

Enables a suite of client-side culling optimizations including entity occlusion culling, shadow distance caps, and block entity distance culling. Each optimization reduces the number of objects the renderer has to process per frame, which translates directly to higher and more stable frame rates — especially on servers with many players or complex builds nearby. Individual toggles let you enable only the optimizations that suit your hardware.

Replace the default crosshair with a fully customizable one. Adjust size, gap, dot visibility, and color.

Changes the red hurt flash that appears on entities when they take damage to any RGB color you choose. Supports a chroma (rainbow cycling) mode with configurable cycle speed for a more distinctive look. The change is purely visual and client-side — it has no effect on other players or the server.

Overrides the client-side weather rendering so you always see clear skies, constant rain, or a perpetual thunderstorm — regardless of what the server's actual weather is. The override is local only and does not affect other players or server-side weather mechanics. Useful for screenshots, performance testing, or simply preferring a consistent visual environment.

Resizes and adjusts the opacity of the totem pop overlay animation that plays when a totem of undying activates. The default overlay fills the entire screen, which some players find disorienting in high-stakes moments. You can scale it down significantly or reduce its opacity so you stay aware of your surroundings during the animation.

Applies global theming to all HUD elements, letting you change accent color, background opacity, and font style across every HUD mod in a single step rather than configuring each one individually. Theme presets are planned, and custom theme values can be saved and loaded. Note: full theme switching is still in development — basic color and opacity controls are available now.

Create named waypoints at any coordinate and have them displayed as floating labels in the world at their location. Waypoints are stored per-server so your markers on one server do not bleed into another. Open the waypoints list from the mod menu to edit, delete, or teleport your camera to any saved point. They also appear as pins on the Minimap if that mod is enabled.

Bind any chat message or command to a key so you can send it instantly without typing. Each macro stores a label, a key binding, and the message text — supports server commands like /kit or /home as well as regular chat. You can define as many macros as you need and manage them all from the mod settings panel.

Shows a confirmation dialog whenever you attempt to disconnect from a server, preventing accidental disconnects from a misclick or a stray key press. The dialog requires an explicit confirm before the connection is closed. You can whitelist specific servers where you want the prompt skipped if you disconnect from them frequently by choice.