ScamScreener - защита от мошенников в Hypixel SkyBlock

ScamScreener - это клиентский мод для Fabric, который в реальном времени анализирует входящие сообщения в чате Hypixel SkyBlock, выявляет подозрительное поведение и помогает принимать взвешенные решения при торговле. Если вы хоть раз теряли предметы из-за хитрых схем скамеров - этот мод для вас.

Зачем это нужно

Hypixel SkyBlock - огромный экономический мир, где игроки постоянно обмениваются предметами, монетами и услугами. К сожалению, вместе с этим процветает и мошенничество: фейковые сделки, подмена предметов, социальная инженерия. ScamScreener берет на себя роль бдительного помощника, который отслеживает паттерны обмана и предупреждает вас до того, как вы попадетесь.

Как это работает

Мод использует многоступенчатый пайплайн анализа:

• Проверка по спискам - сверка с вашим белым и черным списками игроков
• Детерминированные правила - поиск ссылок, признаков срочности, перенаправлений на сторонние платформы
• Нечеткое совпадение фраз - поиск известных мошеннических фраз и их вариаций
• Анализ поведения - отслеживание повторяющихся сообщений от одного игрока
• Трендовый анализ - выявление волн подозрительных сообщений от разных игроков
• Контекстный анализ - оценка цепочки сообщений от одного отправителя

Результат может быть: IGNORE (игнорировать), REVIEW (проверить), BLOCK (заблокировать), WHITELISTED (в белом списке), BLACKLISTED (в черном списке) или MUTED (заглушено).

Быстрый старт

1. Установи Fabric Loader для своей версии Minecraft.
2. Положи ScamScreener и Fabric API в папку mods.
3. Запусти игру.
4. Открой настройки командой /scamscreener settings (или /ss settings).
5. Установи порог риска (LOW, MEDIUM, HIGH, CRITICAL). Имей в виду: на LOW мод будет предупреждать часто, особенно на больших публичных островах.
6. Играй как обычно - ScamScreener будет следить за чатом.
7. Открывай очередь проверки (/scamscreener review) для помеченных случаев.
8. Помечай случаи как RISK, SAFE или DISMISSED.
9. При необходимости экспортируй данные через /scamscreener review export.

Команды в игре

Корневые команды:

• /scamscreener ...
• /ss ... (сокращение)

Основные группы команд:

• settings, rules, runtime, messages, metrics
• whitelist add/remove/clear
• blacklist add/remove/clear
• review, review player, review manage, review info, review export
• alertlevel
• autoleave on/off
• mute, mute <regex>, unmute, unmute <regex>
• debug
• version, help

Интерфейс

Главный экран настроек включает:

• Порог предупреждений и авто-захват
• Включение/отключение авто-выхода и фильтра заглушек
• Управление белым и черным списками
• Очередь проверки и настройки проверки
• Правила, рантайм, метрики и настройки сообщений

Проверка случаев и экспорт для обучения

Процесс проверки:

1. Открой очередь и выбери случай.
2. Пометь каждое сообщение как Exclude, Context или Signal.
3. Сохрани вердикт: Risk, Safe или Dismiss.

Экспорт:

• Команда: /scamscreener review export
• Файл: config/scamscreener/training-cases-v2.jsonl

Важно: тренировочный хаб пока не запущен. Кнопки "Contribute Training Data" в GUI отключены. Но локальный экспорт работает стабильно.

Файлы конфигурации

ScamScreener хранит данные в папке config/scamscreener/:

• runtime.json - поведение во время выполнения
• rules.json - настройки правил пайплайна
• review.json - состояние очереди проверки
• whitelist.json - доверенные игроки
• blacklist.json - заблокированные игроки
• training-cases-v2.jsonl - экспортированные данные для обучения

Конфиденциальность и данные

• Мод работает только на стороне клиента.
• Автоматической загрузки данных для обучения нет.
• Данные проверки очищаются от UUID отправителя.
• UUID используются только для управления белым и черным списками.

Миграция с v1 на v2

При первом запуске v2 мод выполняет одноразовую миграцию:

• Переносит старые файлы белого/черного списков в формат v2
• Создает маркер .v1-to-v2-migration.done
• Удаляет старые файлы конфигурации v1 после миграции
• Существующие файлы v2 не перезаписываются.

API для других модов

Получить API можно через Fabric entrypoint:

import eu.tango.scamscreener.api.ScamScreenerApi;
import net.fabricmc.loader.api.FabricLoader;
import java.util.List;
List<ScamScreenerApi> apis = FabricLoader.getInstance()
    .getEntrypoints(ScamScreenerApi.ENTRYPOINT_KEY, ScamScreenerApi.class);
if (!apis.isEmpty()) {
    ScamScreenerApi api = apis.get(0);
}

Затем используй доступ к общим спискам и событиям:

import eu.tango.scamscreener.api.BlacklistAccess;
import eu.tango.scamscreener.api.WhitelistAccess;
import eu.tango.scamscreener.api.event.BlacklistEvent;
import eu.tango.scamscreener.api.event.PipelineDecisionEvent;
import eu.tango.scamscreener.api.event.WhitelistEvent;
WhitelistAccess whitelist = api.whitelist();
BlacklistAccess blacklist = api.blacklist();
PipelineDecisionEvent.EVENT.register((chatEvent, decision) -> {
    // реагируй на решения пайплайна
});
WhitelistEvent.EVENT.register((changeType, entry) -> {
    // entry равен null при очистке списка
});
BlacklistEvent.EVENT.register((changeType, entry) -> {
    // entry равен null при очистке списка
});

Поддерживаемые версии и требования

• Minecraft: 1.21.10 (EOL), 1.21.11 (EOL), 26.1
• Загрузчик модов: Fabric Loader >= 0.17
• Зависимость: Fabric API
• Среда: только клиент