ghosty

Ghosty 👻

Серверный настраиваемый Fabric-мод против EntityESP. Ghosty находится между трекером сущностей ванильного сервера и клиентом. Как только ванильный сервер начинает отслеживать сущность для игрока, Ghosty перехватывает и фильтрует сетевые пакеты (обновления). Он не даёт клиентам получать обновления о сущностях, которых они не должны видеть (например, за стенами или за спиной игрока), эффективно нейтрализуя читы Entity ESP и Wallhack.

Возможности

Ghosty применяет следующие проверки, чтобы определить, должна ли отслеживаемая сущность обновляться для клиента:

• Проверка дальности: Прекращает обновление отслеживаемых сущностей, находящихся за пределами настроенной дальности видимости.
• Проверка угла обзора: Не даёт обновлять сущности за пределами поля зрения игрока, если только они не находятся в крайней близости.
• Проверка перекрытия (рейкаст): Разумно блокирует обновления сущностей, если они полностью перекрыты непрозрачными блоками.

Настройка

Запустите сервер с установленным модом один раз, чтобы создать файл конфигурации по умолчанию по пути 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
    }
  }
}

Руководство по настройке

API для разработчиков (программируемые фильтры)

Ghosty предоставляет события, позволяющие другим модам подключаться к логике видимости и динамически её изменять.

Настройка

1. Добавьте зависимость из JitPack, следуя инструкциям по адресу: https://jitpack.io/#lightsing/ghosty
2. Импортируйте класс события: me.lightsing.minecraft.ghosty.api.EntityVisibilityEvents
3. Зарегистрируйте свои слушатели событий для EntityVisibilityEvents.PRE и/или EntityVisibilityEvents.POST.

EntityVisibilityEvents.PRE

Это событие вызывается до любых внутренних проверок Ghosty (дальность, угол обзора, перекрытие). Оно крайне полезно для добавления в белый список конкретных сущностей (например, питомцев, светящихся сущностей или боссов), которые всегда должны отрисовываться у клиента, как только ванильный трекер их обнаружит.

Сигнатура: (ServerPlayer player, Entity target) -> InteractionResult

• Верните InteractionResult.FAIL, чтобы пропустить все последующие проверки Ghosty и принудительно обновить сущность для клиента.
• Верните InteractionResult.PASS, чтобы ничего не делать и позволить Ghosty (или другим хукам) обработать видимость обычным образом.

EntityVisibilityEvents.POST

Это событие вызывается после завершения всех внутренних проверок и содержит окончательное решение Ghosty о видимости. Это позволяет изменять поведение обновления на месте до того, как пакеты будут перехвачены или отправлены. Сигнатура: (EntityVisibilityCheckEvent event) -> InteractionResult

• Верните любое значение, кроме InteractionResult.PASS, чтобы перехватить событие и остановить его распространение к другим зарегистрированным POST-хукам.