ghosty

模组

· 作者 lightsing

一款适用于 Fabric 的反实体透视模组。

0 本站下载 0 关注 更新于 7 个月前

最新 1.0.0 · 1.21.1 · Fabric

一键开服(送7天)

Ghosty ?

一个服务端可配置的 Fabric 模组,用于防止实体透视(Anti-EntityESP)。

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

功能特性

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 停止更新某个实体时,服务器是否应向客户端主动发送“消失”数据包。默认为 false。注意: 启用此选项可能导致客户端视觉故障,例如披风物理效果重置或实体重新出现时向上飞行。
forceRefreshNTicks 基于时间的缓存失效。每 N 个刻对所有玩家追踪的所有实体重新计算可见性。
yawChangedThreshold 旋转缓存失效。如果玩家的偏航角(水平视角)变化超过此值,将触发可见性重新计算。
pitchChangedThreshold 旋转缓存失效。如果玩家的俯仰角(垂直视角)变化超过此值,将触发可见性重新计算。
positionMovedThreshold 位置缓存失效。如果目标实体自上次检查以来移动距离超过该值的平方,将为追踪它的玩家触发重新计算。

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

Ghosty 提供了事件接口,允许其他模组挂钩并动态修改可见性逻辑。

设置

  1. 按照以下说明中的指示,通过 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 钩子。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源