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

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

---

<details>
<summary>RU (описание на русском)</summary>

**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` |

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

```yaml
# Режим работы: "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"

🔧 Установка

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