Перейти к содержимому
Mineforgian

CullTag

Server-side mod that hides player nametags through walls

Загрузки
338
Подписчики
4
Обновлён
31 июля 2026 г.
Лицензия
MIT

Опубликован 16 мая 2026 г.

Исходный кодСообщить об ошибке

CullTag

True Server-Side Nametag Culling for Fair Play

Vanilla Minecraft gives every player a free, built-in wallhack: nametags visible through solid blocks. CullTag fixes this unfair advantage with highly optimized, server-side raycasting.

If a player is hiding behind a wall, their nametag is gone. It’s that simple.

Because all calculations and packet interceptions happen entirely on the server, your players don't need to install anything. They can connect with a 100% vanilla client and immediately experience fairer gameplay, making it perfect for SMPs, PvP arenas, and hardcore survival servers.

Key Features

  • Zero Client Setup: 100% server-side. Vanilla and modded clients both see the correct, culled nametags automatically.
  • Aimed at the nametag, not the eyes: the ray ends where the tag actually floats, so a tag peeking over a wall stays visible and one hidden behind it does not.
  • Glass is not a wall: panes, bars, chains and ladders never hide a nametag. Which blocks count is a datapack tag, #culltag:transparent, so you can change it without waiting for a release.
  • Named mobs too: a named mob or armour stand is the same wallhack as a player. cull_entity_nametags covers them, and leaves invisible ones alone so hologram stands stay readable.
  • Engineered for Performance: sweeps run every few ticks, skip spectators and anything invisible, and never look past the 64 blocks at which vanilla stops drawing nametags. Typical cost is well under a millisecond.
  • Live Configuration: config/culltag.properties holds enabled, max_distance, check_interval_ticks and cull_entity_nametags.
  • Hot-Swappable: Toggle the entire system or reload config changes live without ever needing to restart your server.
  • Built-in Profiling: Monitor exactly how the mod is operating under the hood with built-in performance metrics.

Commands

Manage the mod entirely in-game (requires appropriate permissions):

  • /culltag enable & /culltag disable - Toggle the culling system live. Your choice automatically persists to the config file.
  • /culltag reload - Hot-reload any changes made to culltag.properties.
  • /culltag stats - View real-time raycast performance metrics and active tracking data.

Documentation

  • Configuration - every key with its default and range, and the block tag that decides what counts as see-through.
  • Commands - what each subcommand does, and how to read /culltag stats.
  • How It Works - the sight test, the hiding trick, and what each costs.
  • Compatibility - other mods, modded blocks, and holograms.
  • Troubleshooting - what to check when a nametag is stuck, missing, or showing when it should not be.

Requirements

  • Environment: Server-side ONLY (Drop it in your server's mods folder and you're done)
  • Dependencies: Fabric API
  • Fabric Loader: 0.19.3 or newer

Known Incompatibilities

  • PassableFoliage - mutates leaf collision shapes on both client and server, desynchronising LOS raycasts through foliage and producing erratic nametag visibility.

Ченджлог

1.1.2Релиз26.1, 26.1.1, 26.1.2 · 31 июля 2026 г.

1.1.2

  • Added nametag culling for named mobs and armour stands. A named animal or a labelled armour stand gave a base away through terrain exactly like a player did. Invisible ones are left alone, so hologram armour stands stay readable. Turn it off with cull_entity_nametags.
  • Added #culltag:transparent, a block tag listing everything you can see through. Change it with a datapack to cover blocks from other mods, or to make something hide nametags that currently does not.
  • Added translation support. Every message the mod prints can be replaced by a language file, and English is built in, so nothing changes if you do not add one.
  • Changed glass so it no longer hides anyone. Glass, stained glass, panes, iron bars, chains, ladders and scaffolding are all see-through, and hiding a nametag behind something you can see straight through was never the point.
  • Changed what the sight check aims at, from a player's eyes to the nametag itself. A nametag peeking over a low wall now stays visible, and one tucked behind a ledge stays hidden even when the player's eyes are not.
  • Changed max_distance to top out at 64. Vanilla stops drawing nametags at 64 blocks, so anything higher was doing nothing at all. Existing configs above 64 are lowered to it on load.
  • Changed the minimum Fabric Loader version to 0.19.3.
  • Removed crouch_hides_nametag. Crouching to vanish was a stealth mechanic rather than a fix for anything vanilla gets wrong, and it cost a crouching player their team colour in the eyes of anyone they were hidden from. The culltag_hidden team it left in your world is cleaned up for you on first start.
  • Fixed nametags showing through walls until somebody moved. Logging in behind a wall, respawning behind a wall, walking into range from far off, or re-enabling the mod all left nametags fully visible until the two players moved in and out of each other's sight.
  • Fixed nametags staying hidden at long range, in the open, after two players had walked apart.
  • Fixed nametags staying hidden after a player died, changed dimension, or logged out and back in.
1.1.1Релиз26.1, 26.1.1, 26.1.2 · 23 мая 2026 г.

1.1.1

Fixed

  • Stuck-blocked LOS cache.
  • crouch_hides_nametag actually hides nametags now.
  • /culltag disable failing to fully restore nametags.

Added

  • /culltag stats now reports LOS-hidden and crouch-hidden counts separately.
  • /culltag disable restores both LOS and crouch overrides; message reports both counts.
  • Declared PassableFoliage as incompatible
1.1.0Релиз26.1, 26.1.1, 26.1.2 · 20 мая 2026 г.

CullTag 1.1.0

Added

  • Crouch hides nametag — crouching players now have their nametag hidden from everyone entirely, regardless of line of sight. Controlled by the new crouch_hides_nametag option in config/culltag.properties (enabled by default). Set it to false to keep the old behaviour.

Notes

  • Existing config files are upgraded automatically on first launch; the new option is written with crouch_hides_nametag=true.
  • No changes required for clients — CullTag remains fully server-side.
1.0.0Релиз26.1, 26.1.1, 26.1.2 · 17 мая 2026 г.

Initial Release!

Комментарии

Загружаем…