Fake Player Plugin (FPP)

Fake Player Plugin (FPP) - это мощный плагин для серверов Minecraft на Paper, Purpur и Folia (1.21+), который позволяет создавать реалистичных подставных игроков. Решает сразу несколько проблем: пустой сервер никто не хочет заходить, не на ком тестировать автоматизацию, а админам нужно имитировать живую активность. FPP не просто спавнит куклу - он создаёт полноценного фейк-плеера с телом, скином, движением, комбатом и даже ИИ-маршрутизацией.

Что это и зачем нужно

По сути, это фейковые игроки, которых не отличить от настоящих: они видны в табе, пишутся в список игроков сервера, спавнятся с физическим телом (NMS ServerPlayer - с хитбоксом, коллизией, уроном), могут умирать и возрождаться. Им можно задать скин (авто-резолв с Mojang / кастомный пул), выдать инвентарь, настроить поведение. Получается идеальный инструмент для:

• Наполнения сервера - список игроков растёт, что привлекает живых пользователей
• Тестирования механик - проверка ферм, автоматизации, PvE-регионов без риска для реальных игроков
• Экономии времени - боты сами копают, строят, атакуют мобов, спят и даже собирают опыт
• Спама активностью - join/leave сообщения, чат-боты (с расширением), имитация пинга

Плагин отлично работает как на одиночных серверах, так и в связке с прокси (Velocity / BungeeCord) через общую MySQL-базу. Можно синхронизировать состояние ботов между всеми серверами сети - они будут жить в едином пространстве.

Ключевые возможности

Базовый набор (идёт в fpp.jar)

• Физические боты - полноценные сущности с коллизией, уроном, смертью и возрождением
• Таб-лист и присоединение - имитация входа/выхода, отображение в списке игроков, изменение счётчика на сервере
• Скины - автоподбор с Mojang, кастомные скины по команде, пул на все боты
• Навигация и автоматизация - A* pathfinding, следование за игроком, исследование территории (roam), поиск и добыча блоков (find-and-mine), автоматическая еда, укладывание спать
• Зональная добыча и строительство - команды /fpp mine и /fpp place с указанием куба (кубоид), пополнение из контейнеров-хранилищ
• PvE-бой - атака мобов, режим охоты, настройка дальности и приоритета целей
• Графический интерфейс настроек - шифт+ПКМ по боту открывает меню: управление инвентарём, переключение задач, PvE-параметры
• Персистентность - все боты, их задачи и инвентарь сохраняются после перезагрузки сервера (YAML или SQLite/MySQL)
• Поддержка PlaceholderAPI - более 80 плейсхолдеров для таб-хедера, скорбордов, кросс-серверной статистики
• WorldEdit и WorldGuard - пометка зоны добычи/стройки через --wesel;
• Folia - полная совместимость с потоковой региональной архитектурой

Расширение fpp-spoof.jar (ставится отдельно)

Для продвинутых фич требуется дополнительный fpp-spoof.jar:

• ИИ-диалоги (бота можно настроить отвечать в /msg с разными личностями)
• Фейковый чат /broadcast
• Система подмены ботов в пиковые часы
• Группы ботов
• Команда /fpp ping - эмуляция пинга
• Сохранённые команды при ПКМ ( /fpp cmd )

Установка и запуск

1. Скачай fpp.jar с Modrinth или собери из исходников.
2. Кинь JAR в папку plugins/ своего сервера.
3. Перезапусти сервер. Плагин создаст plugins/FakePlayerPlugin/ с конфигами и папками для данных.
4. Настрой пермишены и config.yml под себя.
5. Выполни /fpp reload для применения изменений без перезапуска.

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

# Даём себе админку
/lp user <ваш_ник> permission set fpp.admin true

# Спавним первого бота
/fpp spawn

# Открываем настройки бота
shift+ПКМ по его модели

# Телепортируем бота к себе
/fpp tph <има_бота>

# Заставляем идти за вами
/fpp follow <бот> <игрок>

Полный список команд - в разделе таблицы:

Команда	Описание	Пермишен
/fpp spawn	Спавн ботов (с параметрами)	fpp.spawn
/fpp despawn	Удаление ботов	fpp.despawn
/fpp list	Список активных ботов	fpp.list
/fpp tph	Телепорт бота к себе	fpp.tph
/fpp move	Навигация (к игроку, координаты, исследование)	fpp.move
/fpp mine	Добыча блоков	fpp.mine
/fpp place	Установка блоков	fpp.place
/fpp attack	Атака / охота на мобов	fpp.attack
/fpp follow	Следование за игроком	fpp.follow
/fpp sleep	Авто-сон ночью	fpp.sleep
/fpp freeze	Заморозка бота	fpp.freeze
/fpp inventory	Открыть инвентарь бота	fpp.inventory
/fpp storage	Управление контейнерами для ресурсов	fpp.storage
/fpp rename	Переименовать бота	fpp.rename
/fpp info	Информация о боте / история сессии	fpp.info
/fpp migrate	Резервное копирование / миграция	fpp.migrate
/fpp reload	Перезагрузка конфига	fpp.reload

Примеры использования

/fpp spawn 5                              # 5 ботов сразу
/fpp spawn --name BuilderBot               # Бот с конкретным именем
/fpp spawn --notp                          # Спавн на последней сохранённой позиции
/fpp spawn world_nether 100 64 -200       # В другом мире
/fpp spawn 3 afk                          # 3 бота с пресетом "afk"
/fpp despawn all                           # Убрать всех
/fpp despawn --random --count 3            # Убрать 3 случайных
/fpp move bot1 --to Notch                  # Переместить к игроку
/fpp move bot1 --roam 500,64,200 25        # Исследовать радиус 25 блоков
/fpp mine bot1 diamond_ore --wesel         # Копать алмазы в выделенной зоне
/fpp place bot1 --once                     # Поставить один блок
/fpp attack bot1 --hunt --range 16         # Охота на мобов
/fpp follow bot1 Notch                     # Следовать за игроком
/fpp find bot1 diamond_ore --radius 64 --count 20
/fpp sleep bot1 100 64 200 50              # Спать у координат
/fpp stop bot1                             # Остановить все задачи
/fpp freeze bot1 on                        # Заморозить
/fpp inv bot1                              # Открыть инвентарь
/fpp storage bot1 chest1                   # Зарегистрировать сундук как хранилище
/fpp rename bot1 builder_01                # Переименовать
/fpp info bot1                             # Показать историю сессии

Права доступа (Permissions)

FPP использует двухуровневую систему.

Вайлдкарты

Нода	По умолчанию	Описание
fpp.admin	op	Полный админский доступ (аналог fpp.op)
fpp.op	op	Полный доступ ко всем командам
fpp.use	true	Пользовательский уровень: спавн (1 бот), tph, xp, info (свои боты)

Ключевые ноды

• Spawn: fpp.spawn, fpp.spawn.user, fpp.spawn.limit.1 до fpp.spawn.limit.100
• Despawn: fpp.despawn, fpp.despawn.bulk, fpp.despawn.own
• Movement: fpp.move, fpp.move.to, fpp.move.stop
• Automation: fpp.mine, fpp.place, fpp.use.cmd, fpp.attack, fpp.attack.hunt, fpp.find, fpp.follow, fpp.sleep, fpp.stop
  • fpp.mine.wesel - использование WorldEdit для зоны добычи
  • fpp.place.wesel - использование WorldEdit для зоны строительства
• Management: fpp.freeze, fpp.rename, fpp.rename.own, fpp.inventory, fpp.storage, fpp.setowner, fpp.save, fpp.settings
• System: fpp.reload, fpp.migrate, fpp.badword
• Bypass: fpp.bypass.max, fpp.bypass.cooldown
• Notify: fpp.notify - уведомления об обновлениях

Настройка пермишенов (пример для LuckPerms)

# Админ
/lp group admin permission set fpp.admin true

# Игрок
/lp group member permission set fpp.use true

# Лимит для Alice - 5 ботов
/lp user Alice permission set fpp.spawn.limit.5 true

# VIP-игроки игнорируют кулдаун
/lp group vip permission set fpp.bypass.cooldown true

# Скрыть команду /fpp от гостей
/lp group guest permission set fpp.command false

Плейсхолдеры (PlaceholderAPI)

Более 80 плейсхолдеров с префиксом %fpp_. Вот наиболее полезные:

Глобальные (для всего сервера / сети):

• %fpp_count% - всего ботов (локальные + удалённые через прокси)
• %fpp_local_count% - боты на этом сервере
• %fpp_network_count% - боты на других серверах прокси
• %fpp_max% - глобальный лимит ботов
• %fpp_real% - реальные игроки онлайн
• %fpp_total% / %fpp_online% - всего (реальные + боты) на этом сервере
• %fpp_network_total% - всего игроков + ботов во всей сети
• %fpp_network_real% - все реальные игроки сети
• %fpp_uptime% - время работы плагина

По миру:

• %fpp_count_<мир>% - боты в конкретном мире
• %fpp_real_<мир>% - реальные игроки в мире
• %fpp_total_<мир>% - всего в мире

По игроку (относительно смотрящего):

• %fpp_user_count% - количество ботов у игрока
• %fpp_user_max% - лимит ботов для игрока
• %fpp_user_names% - имена ботов игрока
• %fpp_user_uptime% - общее время работы его ботов

По конкретному боту:

• %fpp_health_<имя_бота>% - здоровье
• %fpp_loc_x_<имя_бота>% - координата X
• %fpp_task_<имя_бота>% - текущая задача (mining, moving, idle и т.д.)
• %fpp_owner_<имя_бота>% - кто создал
• %fpp_type_<имя_бота>% - тип (AFK, MINER, BUILDER и т.д.)

Конфигурация

Основной файл plugins/FakePlayerPlugin/config.yml. Ключевые секции:

• limits - лимиты ботов, кулдауны
• persistence - сохранение/восстановление после рестарта
• bot-name - источник имён для ботов
• badword-filter - фильтрация мата
• body - настройки тела (pushable, damageable, подбор предметов)
• combat - здоровье, урон от падения, звуки боли
• death - поведение при смерти
• chunk-loading - загрузка чанков вокруг ботов
• automation - авто-еда, авто-кровать, авто-молоко, защита от Плохого знамения
• head-ai - плавный поворот головы
• swim-ai - автоматическое всплытие
• collision - радиус отталкивания ботов друг от друга
• database - SQLite / MySQL
• config-sync - синхронизация конфига между серверами через MySQL
• performance - настройки синхронизации позиций
• attack-mob - дальность атаки и приоритет
• pathfinding - тонкая настройка A* (шаги, лимиты, застревания)
• skin - режимы скинов, пул, интеграция с Mineskin
• ping - фейковый пинг (требует fpp-spoof.jar)

Плагин включает автоматический мигратор конфига (текущая версия: 73). Не трогай config-version вручную.

Особенности для админов

• Поддержка прокси - Velocity / BungeeCord с companion-плагинами. Через единую базу данных синхронизируются все боты сети, их количество и состояние.
• Система расширений - можно писать свои .jar-аддоны и класть в plugins/FakePlayerPlugin/extensions/.
• Динамический лимит - можно задать разное кол-во ботов для разных групп игроков.
• Совместимость с Folia - регион-треды не конфликтуют.
• WorldEdit / WorldGuard - можно выделять зоны для добычи и стройки через --wesel, а также защищать регионы от PvP ботов.

А что по производительности?

Сам по себе FPP не сильно грузит сервер, но всё зависит от количества ботов и их задач. На 10-20 ботах с базовым ИИ разница незаметна. Если запускать 50+ с активным pathfinding и боевкой - лучше следить за TPS через %fpp_server_tps%. Настройка performance и chunk-loading поможет снизить нагрузку.

Размер и требования

• Версия Minecraft: 1.21+ (Paper, Purpur, Folia)
• Зависимости: PlaceholderAPI (опционально), LuckPerms (опционально), WorldGuard / WorldEdit (опционально)
• Расширение fpp-spoof.jar ставится по желанию

Лицензия

MIT. Исходники открыты, можно модифицировать и распространять.

Скачайте плагин Fake Player Plugin (FPP) для своего сервера и добавьте жизни на сервер без лишних затрат!