Плагин AkyCheatCheck - интерактивная проверка на читы с веб-панелью! [1.0]

Плагин для проверки игроков на читы.
Цель простая: быстро вызвать игрока, изолировать его, провести проверку и нормально сохранить результат.

Поддержка: Paper / Spigot 1.20.4
Java: 17+
Package: ru.akydevv

---

Что умеет

• вызов игрока на проверку;
• заморозка и телепорт в кабинку;
• несколько кабинок без конфликтов;
• BossBar с таймером;
• автобан за выход или истечение времени;
• авто-бан по фразам признания;
• отдельный чат игрока и модератора;
• блокировка команд во время проверки;
• блокировка телепортов, дропа, инвентаря, интерактов и урона;
• определение клиента через brand и каналы клиента;
• поддержка Lunar, Badlion, Forge, Fabric и похожих клиентов;
• трофей честному игроку после проверки;
• статистика модераторов;
• AFK-трекинг с автовызовом;
• логи в файл;
• Discord webhook;
• Telegram уведомления;
• Web-панель для просмотра проверок и логов;
• PlaceholderAPI expansion;
• API-события для других плагинов.

---

Установка​

1. Скачай AkyCheatCheck-1.0.0.jar.
2. Положи файл в папку:

plugins/

1. Перезапусти сервер.
2. Открой конфиг:

plugins/AkyCheatCheck/config.yml

1. Настрой кабинку проверки.

Можно вручную в config.yml.
Можно из игры:

/akycheck setcabin default


Команду нужно выполнить в месте, куда должен попадать игрок на проверку.

---

Команды​

Основная команда:

/akycheck


Алиасы:

/check
/cc

Проверки​

/akycheck start <ник> [секунды]


Начать проверку.

/akycheck release <ник>
/akycheck as <ник>


Отпустить игрока. Если включены трофеи, игрок получит предмет.

/akycheck ban <ник> [причина]
/akycheck soft <ник> [причина]


Забанить игрока по итогам проверки.

/akycheck deny <ник> [причина]


Забанить за игнор проверки.

/akycheck confess <ник>


Забанить за признание.

/akycheck addtime <ник> <минуты>


Добавить время к проверке.

Информация​

/akycheck info <ник>


Показывает статус проверки и клиент игрока.

/akycheck list


Показывает активные проверки.

/akycheck stats
/akycheck stats <модератор>


Показывает статистику модераторов.

Настройка​

/akycheck setcabin [id]


Сохраняет кабинку на текущей позиции.

/akycheck reload


Перезагружает конфиг.

---

Права​

akycheatcheck.moderator


Доступ к командам проверки.

akycheatcheck.reload


Перезагрузка конфига и настройка кабинок.

akycheatcheck.bypass


Иммунитет от AFK-вызова на проверку.

---

PlaceholderAPI​

Если на сервере стоит PlaceholderAPI, expansion подключится сам.

Доступные плейсхолдеры:

%akycheck_active_checks%
%akycheck_moderator_checks%
%akycheck_moderator_bans%


Что они показывают:

---

Web-панель​

В плагин встроена простая web-панель.
Она показывает активные проверки и последние записи из checks.log.

Настройка в config.yml:

web-dashboard:
enabled: true
host: '0.0.0.0'
port: 8094
token: 'change-me'

Открыть:

http://IP_СЕРВЕРА:8094/?token=change-me


token лучше сразу поменять.

Пример:

token: 'long-random-token-here'

---

Логи и уведомления​

AkyCheatCheck пишет журнал проверок в файл:

plugins/AkyCheatCheck/logs/checks.log


Также можно включить Discord и Telegram.

audit:
file:
enabled: true
discord:
enabled: false
webhook-url: ''
telegram:
enabled: false
bot-token: ''
chat-id: ''

Все сетевые отправки идут асинхронно.

---

Настройка античитов​

В конфиге можно указать команды, которые выполняются при старте и конце проверки.

Пример:

compatibility:
enable-flight-while-frozen: true
disable-paper-fly-kick: true
commands-on-check-start:

• 'grim exempt %player%'
• 'vulcan bypass add %player%'

commands-on-check-end:

• 'grim unexempt %player%'
• 'vulcan bypass remove %player%'

Так можно аккуратно работать рядом с GrimAC, Vulcan и похожими системами.

---

Кабинки​

Пример ручной настройки:

cabins:
- id: 'default'
world: 'world'
x: 0.5
y: 100.0
z: 0.5
yaw: 0.0
pitch: 0.0

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

---

API для разработчиков​

Плагин вызывает события:

AkyCheckStartEvent
AkyCheckEndEvent

Пример:

@EventHandler
public void onCheckEnd(AkyCheckEndEvent event) {
if (event.getReason() == CheckEndReason.RELEASED) {
Bukkit.getLogger().info(event.getSuspectName() + " прошёл проверку");
}
}

---

Сборка​

git clone https://github.com/USER/AkyCheatCheck.git
cd AkyCheatCheck
gradle build

Готовый jar будет здесь:

build/libs/AkyCheatCheck-1.0.0.jar


Для сборки нужен JDK 17.

---

Структура проекта​

ru.akydevv.akycheatcheck
├── api/event # события для других плагинов
├── command # команды
├── config # чтение настроек
├── listener # обработчики событий Bukkit
├── model # модели данных
├── placeholder # PlaceholderAPI expansion
├── repository # хранение статистики
└── service # логика плагина


Главный класс AkyCheatCheckPlugin только запускает и выключает части плагина.
Основная логика вынесена в отдельные классы.

---

Статус​

Версия: 1.0.0
Сборка проверена на JDK 17.
Целевая версия сервера: Paper / Spigot 1.20.4.
Отдельная благодарность разработчику плагина ElemCheck - некоторые идеи были взяты с его плагина.