Back to mods
Reach Indicator project artwork

Vintage Story Mod DB · Vintage Story mod

Reach Indicator

What it does Reach Indicator adds a small HUD readout under your crosshair that shows two numbers every time you land a melee hit: Distance / Reach - Distance — the true distance from your player to the nearest point on the target's hitbox at the mome

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Reach Indicator release should I use?

Updated 3 days ago
Latest stable file 1.0.2
Game version 1.22.0, 1.22.1, 1.22.2
Loader Built-in Vintage Story mod system

Reach Indicator 1.0.2 targets 1.22.0, 1.22.1, 1.22.2. It must be installed on the client. Do not install it on the dedicated server. No extra mods listed for this file.

Where it goes

Is Reach Indicator required on the client, server, or both?

It must be installed on the client. Do not install it on the dedicated server.

Client Required
Dedicated server Not supported
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This Vintage Story file is marked client-only.

What else does Reach Indicator 1.0.2 need?

1.0.2. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Reach Indicator without breaking your instance.

Built for Reach Indicator 1.0.2. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.2. It targets 1.22.0, 1.22.1, 1.22.2; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.2. It opens that exact file at the source.

About this project

What does Reach Indicator add?

What it does

Reach Indicator adds a small HUD readout under your crosshair that shows two numbers every time you land a melee hit:

Distance / Reach

- Distance — the true distance from your player to the nearest point on the target's hitbox at the moment of the hit (not center-to-center, so it stays accurate regardless of the target's size) On occasions it may exceed your reach. My hypthesis is that if you attack something at a certain point the attack will go through no matter what.. but the actual dmg comes through a few miliseconds later which if you back away will result in distance being higher than your reach would be.
- Reach — your current weapon's attack range, i.e. the effective cap you're working with.

The readout appears for a few seconds after each hit, then fades until your next swing.

Why

Vanilla gives no feedback on how close you actually need to be to land a hit, and center-to-center distance estimates get thrown off by big-hitbox mobs (bears, wolves, etc.) vs. small ones (dummies, chickens). This mod measures distance to the target's actual collision surface, so the number you see is consistent no matter what you're fighting.

Notes

- Client-side only, no server component, safe for multiplayer.
- No config needed — works out of the box.

 

Every entity in Vintage Story actually carries two separate boxes, plus a position that isn't where you'd expect:

- Entity.Pos — the entity's tracked position. This is feet-level, horizontally centered. It is not the center of the entity's body or hitbox.
- CollisionBox — the box used for physics: what stops the entity from walking through walls, what it lands on, what pushes it out of terrain. Tends to hug the model fairly tightly.
- SelectionBox — the box used for targeting/interaction: what the game checks when deciding whether your crosshair/attack is actually pointing at the entity. This is the box the game itself uses to decide can you hit this.

What we ended up using

Nearest-point distance against SelectionBox.

SelectionBox is the box the game itself uses to decide whether you're actually targeting/hitting the entity. Measuring against it means the number you see lines up with the game's own targeting logic, not an approximation of the entity's physical footprint.

Project description from Vintage Story Mod DB.

Pick your setup

Reach Indicator releases for each Vintage Story version.

Choose the version and loader you play, then open the matching release.

7 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Reach Indicator versions and loaders

2 of 2 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.