Better Dynamic Crosshair Docs

~2 min read v1.1.0 Fabric

Overview #

Better Dynamic Crosshair is a client-side crosshair replacement that adapts to what you target. It colour-codes the crosshair by target type — hostile mobs red, passive mobs yellow, players blue, bosses purple, containers cyan, interactables green, redstone orange and ores gold — and attaches tooltips showing entity name, HP, armor and distance, or the correct tool, tool level and estimated break time for whatever block you aim at. Combat glows appear automatically: full attack charge, critical hits, low-health targets and correct-tool indicators. It is a lightweight HUD mixin with low performance impact, works on any server with no server requirements, and exposes a public API (CrosshairContext, CrosshairColor and CrosshairStyle) for other mods.

A static crosshair gives you nothing. Better Dynamic Crosshair re-colors and styles the crosshair based on what you're targeting — hostile or passive mobs, players, bosses, containers, redstone, crops and ores — and attaches tooltips showing entity HP, armor and distance or the correct tool and estimated break time.

Quick start #

  1. Install Fabric Loader and Fabric API for 1.21.11 — the current build is a single Fabric 1.21.11 JAR (multi-loader matrix planned).
  2. Place the Better Dynamic Crosshair JAR into your mods folder — no server mod, no configuration required to start.
  3. Launch the game and aim at anything — the crosshair does the rest, re-colouring by target type.
  4. Read the colours: hostile=red, passive=yellow, player=blue, boss=purple, container=cyan, interactable=green, redstone=orange, ore=gold.
  5. Watch the tooltips — entity name/HP/armor/distance while aiming at mobs; correct tool, level and estimated break time while aiming at blocks.
  6. Combat and correct-tool glows appear automatically — full attack charge, critical hits and low-health targets light up on their own.
  7. For other mods, integrate via the public API: CrosshairContext, CrosshairColor and CrosshairStyle.

Configuration #

v1.1.0 ships with sensible defaults and no required configuration — the crosshair reads your target and acts. Deeper style and colour configuration is on the roadmap alongside the multi-loader matrix.

SettingDefaultDescription
Context colour codingOnHostile=red, passive=yellow, player=blue, boss=purple, container=cyan, interactable=green, redstone=orange, ore=gold.
TooltipsOnEntity name/HP/armor/distance; block tool, level and estimated break time.
Combat glow indicatorsOnFull attack charge, critical hits, low-health targets and correct-tool glows.
Public APIShipped (1.1.0)CrosshairContext, CrosshairColor and CrosshairStyle exposed for other mods.

Frequently asked questions #

Does it work on servers?
Yes — it is fully client-side with no server requirements.
Which versions are supported?
Currently 1.21.11; 26.x and NeoForge/Quilt builds are in progress.
Can other mods use it?
Yes — a public API exposes CrosshairContext, CrosshairColor, and CrosshairStyle.
Does it affect performance?
Minimal — it is a lightweight HUD mixin with low performance impact.
What crosshair styles are there?
The crosshair re-colours and styles dynamically by target type: hostile=red, passive=yellow, player=blue, boss=purple, container=cyan, interactable=green, redstone=orange, ore=gold — with combat glows layered on top.
What conditions change the crosshair?
What you are targeting (entity type or block type) drives the colour; combat conditions — full attack charge, critical hits, low-health targets and holding the correct tool — drive the glows.
How heavy is it in-game?
Lightweight by design — a HUD mixin that reads the current target each frame. If anything feels heavy on your mod list, report it to the support portal.
Does it replace the vanilla crosshair entirely?
Yes — it replaces the static crosshair with the dynamic one. Nothing else about the HUD changes.

Compatibility #

PropertyValue
Loader / platformFabric
Minecraft versions1.21.11
Latest version1.1.0

Single Fabric build so far; multi-loader matrix in progress.

Learn more. Step-by-step walkthroughs live in the tutorials, with install guides for every platform and a general guide to configuration. Still stuck? Open the support portal and we'll reply from support@herostudios.dev.