幽灵般的

幽灵般的

一个用于fabric的反实体ESP模组。

基础库

Ghosty 👻

一个服务端可配置的反实体 ESP Fabric 模组。

Ghosty 位于原版服务器的实体跟踪器与客户端之间。一旦原版服务器开始为某个玩家跟踪某个实体,Ghosty 就会智能地拦截并过滤网络数据包(更新)。它阻止客户端收到它们本不该看到的实体的更新(例如,在墙后或在玩家身后),从而有效反制实体 ESP 和透视作弊。

特性

Ghosty 应用以下检查来判断一个被跟踪的实体是否应该更新到客户端:

  • 范围检查: 停止更新超出所配置可视范围的被跟踪实体。
  • FOV 检查: 阻止更新玩家视野之外的实体,除非它们距离极近。
  • 遮挡检查(射线检测): 智能地阻止被不透明方块完全遮挡的实体更新。

配置

安装此模组后运行服务器一次,即可在 config/ghosty.json 生成默认配置文件。

默认配置

{
  "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
    }
  }
}

配置指南

配置键 描述
bypassFovCheckMaxDistance 绝对距离阈值。处于此范围内的实体完全绕过 FOV 检查,只要未被遮挡就会始终更新到客户端(防止“转身”惊吓)。
enterDistance 隐藏实体变为可见(开始更新到客户端)的距离阈值。
exitDistance 可见实体变为隐藏(停止更新到客户端)的距离阈值。(注意:保持 exit 大于 enter 可产生迟滞,防止实体在正好处于边界时闪烁)。
enterAngle 隐藏实体变为可见(开始更新)的 FOV 角度阈值。
exitAngle 可见实体变为隐藏(停止更新)的 FOV 角度阈值。
rayCastSamples 应用于实体包围盒以进行遮挡检查的相对坐标矩阵。增加采样点可提高准确性(例如,捕捉突出的武器),但会消耗更多 CPU 周期。
shouldDespawn 当 Ghosty 停止更新某个实体时,服务器是否应主动向客户端发送“Despawn”(消失)数据包。默认为 false。注意: 启用此功能可能导致客户端视觉故障,例如披风物理效果重置,或实体重新出现时向上飞。
forceRefreshNTicks 基于时间的缓存失效。每隔 N tick 为每位玩家重新计算所有被跟踪实体的可见性。
yawChangedThreshold 基于旋转的缓存失效。如果玩家的 yaw(水平视角)变化超过此值,则触发可见性重新计算。
pitchChangedThreshold 基于旋转的缓存失效。如果玩家的 pitch(垂直视角)变化超过此值,则触发可见性重新计算。
positionMovedThreshold 基于位置的缓存失效。如果目标实体自上次检查以来移动距离的平方超过此值,则触发对跟踪它的玩家重新计算。

开发者 API(可编程过滤器)

Ghosty 提供事件,让其他模组能够挂接并动态修改可见性逻辑。

设置

  1. 按照 https://jitpack.io/#lightsing/ghosty 上的说明,从 JitPack 添加依赖。
  2. 导入事件类:me.lightsing.minecraft.ghosty.api.EntityVisibilityEvents
  3. 将你的事件监听器注册到 EntityVisibilityEvents.PRE 和/或 EntityVisibilityEvents.POST。

EntityVisibilityEvents.PRE

此事件在 Ghosty 的任何内部检查(范围、FOV、遮挡)之前触发。它非常适合用于将特定实体(如宠物、发光实体或 Boss 怪物)加入白名单,使其一旦被原版跟踪器捕获后就始终渲染给客户端。

签名: (ServerPlayer player, Entity target) -> InteractionResult

  • 返回 InteractionResult.FAIL 以跳过所有后续的 Ghosty 检查,并强制将该实体更新到客户端。
  • 返回 InteractionResult.PASS 以不做任何操作,让 Ghosty(或其他钩子)正常处理可见性。

EntityVisibilityEvents.POST

此事件在所有内部检查完成计算之后触发,包含 Ghosty 的最终可见性决定。它允许你在数据包被拦截或发送之前就地修改更新行为。

签名: (EntityVisibilityCheckEvent event) -> InteractionResult

  • 返回除 InteractionResult.PASS 以外的任何值,以拦截该事件并停止将其传播给其他已注册的 POST 钩子。