Ghosty 👻

A server-side configurable Anti-EntityESP Fabric mod.

Ghosty sits between the vanilla server's entity tracker and the client. Once the vanilla server starts tracking an entity for a player, Ghosty intelligently intercepts and filters the network packets (updates). It prevents clients getting updates from entities they shouldn't be able to see (e.g., behind walls or behind the player), effectively neutralizing Entity ESP and Wallhack cheats.

Features

Ghosty applies the following checks to determine if a tracked entity should update to the client:

• Range Check: Stops updating tracked entities that are outside the configured visual range.
• FOV Check: Prevents updating entities outside of the player's Field of View, unless they are in extremely close proximity.
• Occlusion Check (Raycast): Intelligently blocks entity updates if they are fully obstructed by opaque blocks.

Configuration

Run the server with this mod installed once to generate the default configuration file at config/ghosty.json.

Default Config

{
  "tracking": {
    "range": {
      "bypassFovCheckMaxDistance": 6.0,
      "enterDistance": 8.0,
      "exitDistance": 12.0
    },
    "fov": {
      "enterAngle": 45.0,
      "exitAngle": 60.0
    },
    "rayCastSamples": [
      [0.5, 0.5, 0.5],
      [0.1, 0.1, 0.1],
      [0.9, 0.1, 0.1],
      [0.1, 0.9, 0.9],
      [0.9, 0.9, 0.9],
      [0.5, 1.0, 0.5],
      [0.5, 0.0, 0.5],
      [0.5, 0.5, 0.1],
      [0.5, 0.5, 0.9]
    ]
  },
  "shouldDespawn": false,
  "cache": {
    "forceRefreshNTicks": 5,
    "byPlayer": {
      "yawChangedThreshold": 10.0,
      "pitchChangedThreshold": 10.0
    },
    "byTarget": {
      "positionMovedThreshold": 1.0
    }
  }
}

Configuration Guide

Developer API (Programmable Filters)

Ghosty provides events to let other mods hook into and modify the visibility logic dynamically.

Setup

1. Add the dependency from JitPack by following the instructions at: https://jitpack.io/#lightsing/ghosty
2. Import the event class: me.lightsing.minecraft.ghosty.api.EntityVisibilityEvents
3. Register your event listeners to EntityVisibilityEvents.PRE and/or EntityVisibilityEvents.POST.

EntityVisibilityEvents.PRE

This event is fired before any internal Ghosty checks (Range, FOV, Occlusion) occur. It is highly useful for whitelisting specific entities (like pets, glowing entities, or boss monsters) that should always be rendered to the client once the vanilla tracker picks them up.

Signature: (ServerPlayer player, Entity target) -> InteractionResult

• Return InteractionResult.FAIL to skip all subsequent Ghosty checks and force the entity to be updated to the client.
• Return InteractionResult.PASS to do nothing and let Ghosty (or other hooks) process the visibility normally.

EntityVisibilityEvents.POST

This event is fired after all internal checks have finished computing, containing Ghosty's final visibility decision. This allows you to modify the update behavior in-place before packets are intercepted or sent.

Signature: (EntityVisibilityCheckEvent event) -> InteractionResult

• Return any value other than InteractionResult.PASS to intercept the event and stop propagating it to other registered POST hooks.