HtzDistance

Don't let go your armor stands, paintings and item frames! Keep them loaded with this client-side mod on servers.

HtzDistance

Keep seeing your armor stands, item frames and paintings from far away.

Servers stop sending armor stands, item frames and paintings once you are a few blocks away. On Spigot and Paper that is usually 16 blocks for armor stands and only 8 blocks for item frames and paintings. That means a decorated base, a wall of maps or a shop full of displays looks empty as soon as you step back to look at it.

HtzDistance fixes this on your side. Just before the game removes one of these entities because you walked too far, the mod takes a snapshot of it and keeps drawing it as a hologram in the same spot. When you walk back and the server sends the real entity again, the hologram disappears and the real one takes its place. You won't notice the switch.

See it in action

Each clip switches between OFF (vanilla, what the server sends) and ON (with HtzDistance), seen from the same distance.

Bedroom with and without HtzDistance

Dining room with and without HtzDistance

Wall display with and without HtzDistance

Display hall with and without HtzDistance

Safe on any server

  • Client-only. Install it on your game, not on the server.
  • Nothing is sent to the server.
  • Holograms are not part of the world: they can't be hit, clicked or targeted.

What it keeps

  • Armor stands: armor (with trims), held items, pose, size, arms, base plate, invisibility and custom name.
  • Item frames and glow item frames: the item, its rotation, the facing and invisible frames. Maps keep their picture.
  • Paintings: every variant and size.

Smart about what it shows

  • Broken things don't stay. If an entity disappears while you are close to it, it was broken or removed, so no hologram is kept. And if you are standing where you should see the real entity and it doesn't come back after a few seconds, the hologram is removed too.
  • Remembers your builds. Holograms are saved per server and per dimension, so after reconnecting or changing worlds the far parts of your base are still there. You can turn this off.
  • Learning mode (optional). The mod measures the real distance at which each entity disappears on the server you are playing on, instead of using the default ranges.
  • Hidden behind walls. Holograms behind walls are not drawn, and this check runs in the background without slowing down your game.
  • Limits. A maximum render distance and a maximum number of holograms per dimension keep huge builds under control.

Styles

Holograms can look exactly like the real thing or stand out:

  • Normal: identical to the real entity.
  • Tinted: as if seen through stained glass. You choose the color and how strong it is.
  • Translucent: see-through, with adjustable opacity.

You can also add a glowing outline with its own color to any of the three styles (Minecraft 1.21.10 and later).

Without the mod: once you step back, the frames, paintings and armor stand are gone.

Without HtzDistance

Normal

Normal style

Tinted

Tinted style

Translucent

Translucent style

Glowing outline

Glowing outline

Controls

  • H: turn the mod on or off. While it is off it does no work at all, and the choice is remembered after restarting.
  • J: open the config screen.

Both keys can be changed in the Controls menu.

Configuration

Everything can be changed from the config screen or with the /htzdistance config command:

  • Tracking range for each entity type, and which types get holograms
  • Maximum render distance (96 blocks by default) and maximum hologram count (1024 by default)
  • Style, tint color and strength, opacity, glowing outline and its color
  • Saving between sessions, wall culling and learning mode

The /htzdistance command can also show statistics, clear holograms (in the current dimension, within a radius or on the whole server) and reset the settings. Statistics are also shown on the F3 screen.

Performance

Holograms reuse their render data instead of rebuilding it every frame. In tests with large builds (hundreds of armor stands with full equipment and around two thousand item frames) they were cheaper to draw than the real entities they replace.

Requirements

Compatibility

Works alongside Sodium, Iris, EntityCulling, Bobby and Distant Horizons.

Available in English and Spanish.

About the development

The code of this mod was written with the help of artificial intelligence. The idea, the design of every feature, the planning and the testing decisions are my own.

Links

Licensed under MIT.

HtzDistance Team

profile avatar
Owner
  • 1
    Projects
  • 63
    Downloads