Super Ignore

EN

SuperIgnor is an advanced server protection plugin for 1.20-1.21.x that allows server administrators to control player access with flexible rules, realistic kick messages, and full in-game management.

The plugin creates a "whitelist-like" or "blacklist" environment depending on who is online, perfect for private servers or trolling unwanted guests with fake connection errors.

🚀 Features

🛡️ Smart Protection Modes

when_online - Ignored players cannot join only when Main Users (admins/owners) are online.
always - Ignored players are blocked permanently, regardless of who is online.

⚙️ Full In-Game Management

No need to edit config files manually!
Add/Remove admins and ignored players via commands.
Switch operation modes instantly without reloading.

🔔 Admin Notifications

Main users receive a notification in chat when an ignored player tries to join and gets kicked.
Know exactly when your "enemies" are trying to connect.

🎭 Stealth & Kick Types

custom - Customizable message with color support (&c, &l, etc.).
random - Realistic connection errors (Java Exceptions, Timeouts) to make the player think it's their internet, not a ban.

💻 Commands

Command	Arguments	Description
`/si add`	`<main/ignore> <nick>`	Add a player to the Main or Ignored list
`/si remove`	`<main/ignore> <nick>`	Remove a player from the lists
`/si list`	None	View all Main and Ignored users
`/si mode`	`<always/when_online>`	Switch the plugin operation mode
`/si reload`	None	Reload configuration from file

Aliases: /superignor, /si

🔐 Permissions

Permission	Description	Default
`superignor.admin`	Allows using all plugin commands and receiving notifications	`op`
`superignor.bypass`	Players with this permission are never kicked, even if they are in the ignore list	`false`

📋 Configuration Example

# Operation mode: "when_online" or "always"
operation-mode: "when_online"

# Notify main users when an ignored player tries to join?
notify-main-users: true

# Main server users (nicknames)
# Can be managed via /si add main <nick>
main-users:
  - "OwnerSteve"

# Ignored users (nicknames)
# Can be managed via /si add ignore <nick>
ignored-users:
  - "BadPlayer1"

# Kick message type: "custom" or "random"
kick-type: "custom"

# Custom kick message (supports color codes with &)
kick-custom-message: "&cYou cannot join the server while main administrators are online!"

# Random realistic errors
kick-random-messages:
  - "Internal Exception: java.io.IOException: Connection reset by peer"
  - "Internal Exception: java.net.SocketException: Connection timed out"

🔧 Installation

Place the JAR file in your plugins/ folder.
Restart the server.
Use /si add main YourNick to add yourself as a main user.
Use /si add ignore BadGuy to block someone.

RU (описание на русском)

SuperIgnor - это продвинутый плагин защиты для серверов 1.20-1.21.x, который позволяет администраторам контролировать доступ игроков с помощью гибких правил, реалистичных сообщений об ошибках и полного управления из игры.

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

🚀 Возможности

🛡️ Умные режимы защиты

when_online - Игнорированные игроки не могут зайти, только когда "Главные пользователи" (админы) онлайн.
always - Игнорированные игроки не могут зайти никогда (бан).

⚙️ Управление из игры

Больше не нужно лезть в конфиг для добавления игроков!
Добавляйте/удаляйте админов и игнорируемых игроков командами.
Переключайте режимы работы "на лету".

🔔 Уведомления для админов

Главные пользователи получают сообщение в чате, когда игнорируемый игрок пытается зайти и его кикает.
Вы всегда будете знать, когда ваши "враги" пытаются подключиться.

🎭 Скрытность и типы кика

custom - Настраиваемое сообщение с поддержкой цветов (&c, &l и т.д.).
random - Реалистичные ошибки подключения (Java Exceptions, Timeouts). Игрок будет думать, что у него проблемы с интернетом, а не бан.

💻 Команды

Команда	Аргументы	Описание
`/si add`	`<main/ignore> <ник>`	Добавить игрока в список Главных или Игнорируемых
`/si remove`	`<main/ignore> <ник>`	Удалить игрока из списка
`/si list`	Нет	Показать списки игроков
`/si mode`	`<always/when_online>`	Переключить режим работы
`/si reload`	Нет	Перезагрузить конфиг из файла

Алиасы: /superignor, /si

🔐 Права (Permissions)

Право	Описание	По умолчанию
`superignor.admin`	Доступ ко всем командам и получение уведомлений	`op`
`superignor.bypass`	Игроки с этим правом никогда не будут кикнуты, даже если они в черном списке	`false`

📋 Пример конфигурации

# Режим работы: "when_online" или "always"
operation-mode: "when_online"

# Уведомлять главных пользователей при попытке входа игнорируемого?
notify-main-users: true

# Главные пользователи (можно добавить через /si add main)
main-users:
  - "OwnerSteve"

# Игнорированные пользователи (можно добавить через /si add ignore)
ignored-users:
  - "BadPlayer1"

# Тип кика: "custom" или "random"
kick-type: "custom"

# Кастомное сообщение (поддерживает цвета через &)
kick-custom-message: "&cВы не можете зайти на сервер, пока администрация онлайн!"

# Случайные ошибки (для режима random)
kick-random-messages:
  - "Internal Exception: java.io.IOException: Connection reset by peer"
  - "Internal Exception: java.net.SocketException: Connection timed out"

🔧 Установка

Поместите JAR файл в папку plugins/.
Перезагрузите сервер.
Введите /si add main ВашНик, чтобы добавить себя в главные пользователи.
Введите /si add ignore НикВрага, чтобы заблокировать кого-то.

EN