
幽灵般的
一个用于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 提供事件,让其他模组能够挂接并动态修改可见性逻辑。
设置
- 按照 https://jitpack.io/#lightsing/ghosty 上的说明,从 JitPack 添加依赖。
- 导入事件类:
me.lightsing.minecraft.ghosty.api.EntityVisibilityEvents - 将你的事件监听器注册到
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 钩子。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。