Vanish++

Стандарт современной невидимости для администраторов.

Надоело, что плагины для ваниша оставляют следы? Игроки таб-комплитят ваше имя? Стрелы отскакивают от невидимого тела? Мобы странно смотрят на пустое место?

Vanish++ делает другие плагины ваниша устаревшими. Он создан для современных серверов Paper, Folia, Purpur, Spigot и Bukkit. Использует перехват пакетов, нативную физику и глубокие API-хуки, чтобы вы были математически необнаружимы.

Работает из коробки без какой-либо настройки, но даёт полный контроль тем, кому он нужен.

---

Почему Vanish++ вне конкуренции

Движок физики "Матрица" (Настоящая неосязаемость)

Большинство плагинов просто скрывают вас визуально. Vanish++ удаляет вас физически.

• Режим Бога: Пока вы в ванише, вы строго неуязвимы. Вы не получаете урона, иммунитет к эффектам зелий, не горите. Вы - зритель в режиме выживания.
• Умный ИИ мобов (Истинное зрение): Мобы полностью игнорируют невидимых игроков. Атака отменяется через EntityTargetEvent до того, как моб вообще начнёт атаку. Если моб уже нацелился на вас до активации ваниша, он сразу сбрасывает цель.
• Прохождение снарядов: Не используются "телепорт-хаки". Через нативные события Paper стрелы, трезубцы и снежки физически проходят сквозь ваше тело. Попасть в невидимого игрока невозможно.
• Нулевая коллизия: Вы не можете толкать игроков, мобов или лодки, и они не могут толкнуть вас. Вы призрак.
• Нет физических триггеров: Вы можете ходить по яйцам черепах, посевам, нажимным плитам, растяжкам и скалк-сенсорам, не вызывая ни одной вибрации или обновления блока.
• Защита от рейдов: Вы не активируете рейды от Плохого знамения, наблюдая за деревней.

Глубокая невидимость на уровне протокола (Скрытие на уровне пакетов)

Мы встраиваемся прямо в серверный протокол, чтобы стереть ваше существование из клиентов. (Требуется ProtocolLib)

• Ядерная чистка таб-комплита: Если обычный игрок попытается дополнить ваше имя табом в чате, командах или плагинах - вас там нет. Ваше имя удаляется из пакета, отправляемого клиенту.
• Скрытие из списка серверов: Количество игроков в мультиплеерном списке серверов математически корректируется. Если вы единственный онлайн, сервер показывает "0/20".
• Призрачный вид для персонала: Обычные игроки ничего не видят, а персонал (с разрешением) видит невидимых игроков в таб-листе как серых, курсивных зрителей - это упрощает координацию.
• Индикатор свечения для персонала: Невидимые игроки отображаются с светящимся контуром для персонала - чёткий визуальный индикатор на уровне пакетов. Обычные игроки его не видят. Настраивается в vanish-appearance.staff-glow.
• Интеграция с Dynmap и EssentialsX: Автоматически скрывает вас с динамических веб-карт и команд /who, /list, /online.

Погружение и совместимость

• Нативные языковые фейковые сообщения: Когда вы исчезаете, фейковое сообщение "Игрок покинул игру" - это не просто текст. Оно использует нативный переводческий пакет сервера. То есть немецкий игрок увидит сообщение на немецком, а игрок из США - на английском. Это неотличимо от настоящего выхода.
• Нативная поддержка TAB Plugin: Если вы используете TAB (от NEZNAMY), Vanish++ встраивается в него и автоматически отображает префикс ваниша. Ручная настройка Placeholder не требуется.
• Поддержка старых плагинов: Даже без специальных хуков Vanish++ устанавливает стандартную Bukkit-мету ("vanished"). Так что плагины вроде CMI, TAB или кастомные скрипты автоматически учитывают ваш статус ваниша.
• Бесшумные сундуки: Открывайте сундуки, шалкер-боксы, бочки и эндер-сундуки бесшумно. Контейнер открывается прямо поверх реального инвентаря - никакой анимации, звуков, дублирования предметов.
• Интеграция с DiscordSRV: Регистрируется как нативный хук ваниша в DiscordSRV. Объявления о входе/выходе, достижениях и смерти подавляются в Discord - даже если вы перезаходите, будучи в ванише. Фейковые сообщения входа/выхода учитывают полную конфигурацию DiscordSRV (embed, цвет, аватар, вебхуки) из messages.yml. Уведомления персонала всё равно показываются в консоли и игрокам с разрешением see.
• Интеграция с Simple Voice Chat: Автоматически изолирует/отключает вас в голосовом чате, чтобы вас не было слышно и вы не слышали ближний чат во время слежки.
• Умный подбор предметов: Включайте/выключайте подбор предметов через /vanishpickup. Не украдите случайно алмазы, которые вы смотрите, как игрок добывает.
• Защита от /msg / /tell: Не-персонал больше не может отправить /msg или /tell невидимому игроку - они получают ошибку в стиле ванильного "игрок не найден". Ответ через /r блокируется, если последний получатель был невидимым отправителем. /me от невидимого игрока ограничивается аудиторией персонала. Текст сообщения настраивается.

Детальный контроль и безопасность

• Быстрое переключение в зрителя: Дважды нажмите Shift в ванише, чтобы мгновенно войти в режим зрителя. Повторное двойное нажатие возвращает вас в предыдущий режим игры. Отключение ваниша автоматически возвращает вас обратно. Требуется vanishpp.spectator. (vanishpp.spectator.bypass позволяет остаться в режиме зрителя после отключения ваниша.)
• /vspec Быстрое наблюдение: Мгновенно входите в режим зрителя, привязанный к любому игроку, через /vspec <игрок>. Используйте /vspec stop, чтобы вернуться на прежнее место и в режим. Требуется vanishpp.spec.
• /vfollow Слежение камерой: Зафиксируйте камеру на любом игроке и бесшумно следите за ним через /vfollow <игрок>. HUD-индикатор показывает активную цель. Автоматически останавливается, если цель отключается. Требуется vanishpp.follow.
• /vhistory Журнал аудита: Полная история включений/выключений ваниша с метками времени, исполнителем и причиной, хранящаяся в базе данных. Требуется vanishpp.history.
• /vstats Статистика времени ваниша: Просмотр общего времени в ванише, количества сессий и самой длинной сессии для каждого игрока. Требуется vanishpp.stats.
• /vadmin Панель управления GUI: Внутриигровой графический интерфейс со списком всех невидимых игроков, активных правил и быстрыми действиями. Требуется vanishpp.admin.
• /vincognito Режим фальшивого имени: Замените ваше отображаемое имя и запись в таб-листе на настраиваемое фальшивое имя, пока вы в ванише. Требуется vanishpp.incognito.
• /vwand Жезл включения: Выдаёт огненный стержень - жезл ваниша. ПКМ для переключения режима. Настраивается в config.yml. Требуется vanishpp.wand.
• /vzone Зоны без ваниша: Создавайте зоны с радиусом, в которых ваниш блокируется или принудительно включается. Управление через /vzone create|delete|list|reload. Требуется vanishpp.zone.
• /vautovanish Автоматический ваниш при входе: Игроки могут включить автоматическое включение ваниша при входе. Сохраняется по UUID - переживает перезапуски сервера и переходы между серверами. Требуется vanishpp.autovanish.
• Массовый ваниш: /vanish all включает ваниш для всех подходящих игроков онлайн. /vanish world <мир> нацеливается на всех игроков в конкретном мире. Отслеживание причины ваниша: /vanish <игрок> [причина] записывает причину, видимую персоналу через /vhistory.
• Индикатор ваниша через боссбар: Опциональный постоянный боссбар для невидимых игроков - напоминание о скрытности. Настраиваемый цвет, стиль и текст в config.yml.
• Редактор конфига вживую (/vconfig): Изменяйте любые настройки config.yml (сообщения, правила, булевы переключатели) прямо в игре. Изменения применяются мгновенно без перезагрузки.
• Интерактивная справка (/vhelp): Забудьте про вики. Плагин содержит кликабельное интерактивное руководство, объясняющее каждую команду и функцию.
• Умное слияние при миграции: Обновления без стресса. Плагин автоматически обнаруживает старые конфиги и безопасно переносит ваши кастомные сообщения/настройки в новую версию. Отсутствующие ключи сообщений автоматически записываются в messages.yml при загрузке - обновление никогда не оставляет ключ неопределённым.
• Система личных правил (/vrules): Решите сами, что вы хотите делать в ванише. Поддерживает именованные пресеты - сохранять, загружать, список и удалять конфигурации правил через /vrules preset <save|load|list|delete> <имя>.
  • Хотите ломать блоки? Включите.
  • Хотите абсолютный покой? Отключите "Может бить сущностей".
  • Боитесь утечки информации? Включите "Подтверждение чата".
  • Нужно выбросить предметы? Включите "Может выбрасывать предметы".
• Скорборд ваниша (/vscoreboard): Полностью настраиваемый боковой скорборд, отображаемый автоматически при ванише. Показывает мир, TPS, количество игроков, реальные координаты и направление, биом, пинг, здоровье, еду, броню, время и многое другое. Координаты обновляются мгновенно при движении через прослушивание пакетов ProtocolLib - никакой задержки по тикам. Поддерживает все встроенные плейсхолдеры плюс полный PlaceholderAPI. Разделители столбцов (|) автоматически выравниваются независимо от длины метки. Настраивается в scoreboards.yml, перезагружается через /vreload.
• Синхронизация пульса: Изменили разрешение в LuckPerms? Повысили кого-то через консоль? Задача Heartbeat обновляет визуал мгновенно. Перезаходить не нужно.
• Советчик по настройке: При каждом запуске плагин сканирует активный конфиг и предупреждает, если хук включён, но его зависимость отсутствует, или если плейсхолдер PlaceholderAPI используется без установленного PlaceholderAPI. Предупреждения выводятся в консоль и в чат всем персоналом с vanishpp.see - так вы всегда знаете, что ваша настройка неполна.
• Предупреждения о зависимостях: Плагин умно предупреждает администраторов, если ProtocolLib отсутствует, но позволяет навсегда отключить эти предупреждения через /vignore.
• Защита от случайного чата: Если включено, набор текста в чате блокирует сообщение и просит подтверждения через /vchat confirm. Никогда больше не раскрывайте своё присутствие случайно.
• Асинхронное сохранение данных: Все данные сохраняются асинхронно. Сервер упал? Перезагрузился? Ваше состояние ваниша сохраняется мгновенно. Никаких случайных входов.
• Нативный плагин для Velocity: Компаньон vanishpp-velocity предоставляет выделенный канал обмена сообщениями в реальном времени между всеми серверами Paper и Velocity. Состояние ваниша, изменения конфига и /vanishreload распространяются по всей сети мгновенно. Уведомления об истечении правила по таймеру доставляются на сервер, где в данный момент находится игрок - переподключение не требуется. Серверы автоматически определяют прокси при запуске и переключаются в автономный режим, если прокси отсутствует.
• Мониторинг подключения к базе данных: При сбое подключения к БД персонал уведомляется в игре, чтобы проблемы инфраструктуры не оставались незамеченными. Включает корректную обработку ошибок и пул соединений.

API для разработчиков и интеграция

• Публичный VanishAPI: Чистый API для разработчиков (VanishAPI) предоставляет запросы состояния ваниша, вызовы включения/отключения, хуки событий и чтение правил для интеграции сторонних плагинов. Без необходимости лезть во внутренности.
• Интеграция контекста LuckPerms: Регистрирует контекстный узел vanished в LuckPerms, чтобы права могли быть условно выданы или отозваны, пока игрок в ванише.
• Регионные флаги WorldGuard: Два новых флага WorldGuard: vanishpp-force-vanish (автоматически включает ваниш игрокам, входящим в регион) и vanishpp-deny-vanish (блокирует переключение ваниша внутри региона).
• Поддержка вебхуков: Настраиваемые HTTP-вебхуки срабатывают при событиях ваниша/анваниша для внешних интеграций - Discord-боты, дашборды, системы аудита и т.д.
• Shift+ПКМ Invsee: Shift+ПКМ по игроку, пока вы в ванише, открывает его инвентарь через OpenInv или InvSee++ (если установлены), или через встроенный просмотрщик. Разрешения выдаются на время и отзываются при закрытии.

---

Команды

Большинство команд поддерживают аргумент [игрок], позволяя администраторам изменять состояние/правила других сотрудников.

Команда	Алиас	Описание	Разрешение
/vhelp [команда]	/vanishhelp	Интерактивное меню справки и руководство.	нет разрешения
/vanish [игрок] [причина]	/v, /sv	Переключить состояние ваниша. Поддерживает /vanish all и /vanish world <мир>.	vanishpp.vanish
/vrules [игрок] <правило> [значение] [секунды]	/vanishrules	Настроить правила физики/взаимодействия. Поддерживает пресеты.	vanishpp.rules
/vconfig <ключ> [значение]	/vanishconfig	Изменить настройки конфига вживую.	vanishpp.config
/vperms	-	Управление разрешениями без плагина на права.	vanishpp.manageperms
/vlist	/vanishlist	Интерактивный список невидимых игроков. Нажмите на имя, чтобы мгновенно снять ваниш.	vanishpp.list
/vignore [игрок]	/vanishignore	Включить/отключить предупреждения при запуске.	vanishpp.ignorewarning
/vchat confirm	/vanishchat	Подтвердить сообщение в чате (если включена защита).	vanishpp.chat
/vreload	/vanishreload	Перезагрузить конфиг и ресинхронизировать все эффекты ваниша.	vanishpp.reload
/vscoreboard	/vsb	Включить/отключить боковой скорборд ваниша.	vanishpp.scoreboard
`/vspec <игрок	stop>`	-	Быстрое наблюдение за игроком. /vspec stop для возврата.
`/vfollow <игрок	stop>`	-	Зафиксировать камеру для бесшумного следования за игроком.
/vhistory [игрок]	-	Просмотреть журнал аудита ваниша.	vanishpp.history
/vautovanish [игрок]	-	Включить/отключить авто-ваниш при входе для игрока.	vanishpp.autovanish
/vstats [игрок]	-	Просмотреть статистику времени ваниша.	vanishpp.stats
/vadmin	-	Внутриигровая панель управления GUI для обзора ваниша.	vanishpp.admin
/vwand	-	Выдать жезл ваниша (огненный стержень - предмет переключения).	vanishpp.wand
`/vzone <create	delete	list	reload>`
/vincognito [игрок] [фейк-имя]	-	Включить/отключить режим фальшивого имени.	vanishpp.incognito

---

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

Нужны только если вы создаёте кастомные HUDы или скорборды. (TAB Plugin работает автоматически без них).

Плейсхолдер	Пример вывода	Описание
%vanishpp_is_vanished%	Yes / No	Текущий статус текстом.
%vanishpp_is_vanished_bool%	true / false	Булев статус для логики/условий.
%vanishpp_vanished_count%	3	Количество онлайн невидимых игроков.
%vanishpp_visible_online%	15	Всего игроков минус невидимые (фейковое количество).
%vanishpp_prefix%	[VANISHED]	Настроенный префикс (пусто, если видим).
%vanishpp_pickup%	Enabled	Текущий статус подбора предметов.
%vanishpp_vanished_list%	Notch, Herobrine	Список имён невидимых игроков онлайн через запятую.
%vanishpp_visible_player_list%	Steve, Alex	Список имён видимых (не в ванише) игроков онлайн через запятую.

---

Личные правила (/vrules)

Настройте свой призрачный опыт. Поведение по умолчанию можно подстроить для каждого игрока.

• can_break_blocks (По умолчанию: false - Не может ломать блоки)
• can_place_blocks (По умолчанию: false - Не может ставить блоки)
• can_interact (По умолчанию: false - Сундуки, кнопки)
• can_hit_entities (По умолчанию: false - Запрещает бить игроков/мобов)
• can_pickup_items (По умолчанию: false - Не может подбирать предметы)
• can_drop_items (По умолчанию: false - Не может выбрасывать предметы из инвентаря)
• can_chat (По умолчанию: false - Требует подтверждения для речи)
• can_trigger_physical (По умолчанию: false - Нажимные плиты, посевы и т.д.)
• can_throw (По умолчанию: false - Не может бросать предметы типа яиц, снежков, эндер-жемчуга или стрелять из луков)
• mob_targeting (По умолчанию: false - Мобы игнорируют вас)
• spectator_gamemode (По умолчанию: true - Двойное нажатие Shift для переключения в режим зрителя в ванише)
• show_notifications (По умолчанию: true - Получать предупреждения о заблокированных действиях в чате)

---

Совместимость и требования

Vanish++ создан для современных экосистем.

Поддерживаемые версии Майнкрафт

Версия Minecraft	Статус	Примечания
1.21 - 1.21.11	✅ Поддерживается	Нативная поддержка. Собрано против Paper 1.21 API, протестировано на 1.21.11.
1.20.4 и старше	❌ Не поддерживается	Несовместимые изменения API. Используйте старые версии Vanish++.

Поддерживаемые платформы

Платформа	Статус	Примечания
Paper	✅ Рекомендуется	Лучшая производительность. Требуется для полной поддержки физики/снарядов.
Purpur	✅ Поддерживается	Полностью совместим (форк Paper).
Folia	✅ Поддерживается	Мультирегиональный планировщик с автоопределением. Полная поддержка регионального выполнения. Протестировано на 1.21.x.
Spigot	⚠️ Совместим	Работает, но Paper-специфичные функции (прохождение снарядов) деградируют.
Bukkit	⚠️ Совместим	Те же ограничения, что у Spigot.

Требования:

• Java 21
• ProtocolLib 5.3.0+ (Настоятельно рекомендуется для скрытности)

Хранилище (опционально):

• YAML (По умолчанию) - Файловое хранилище, встроено
• MySQL 5.7+ - Сетевая база данных
• PostgreSQL 12+ - Сетевая база данных
• Redis (Опционально) - Для синхронизации состояния ваниша между серверами

Опциональные хуки:

• TAB (NEZNAMY) (Нативная поддержка)
• PlaceholderAPI, Dynmap, EssentialsX, Simple Voice Chat, DiscordSRV, LuckPerms, WorldGuard, OpenInv / InvSee++

Просто бросьте JAR в папку plugins. Никакой сложной настройки не требуется. Работает безопасно из коробки.

---

Лицензия

Этот проект с открытым исходным кодом под лицензией GNU GPL v3.