SeedGuard

SeedGuard is a security plugin for Paper 1.21.11 designed to make world-seed leaks significantly harder on SMP servers.

It helps protect servers from common seed leak methods used through commands, packet-based tools, technical abuse of structure-related mechanics, and certain NBT/debug-related paths.

Features

Fake hashed seed
SeedGuard intercepts important outgoing packets and replaces the real hashed seed with a fake value.

Protection is applied in key scenarios:
- joining the server
- respawning or state changes where the client receives world data again

This makes it harder for client-side tools and seed-cracker style mods to obtain the real world seed through normal multiplayer packet data.

Command blocking
The plugin blocks:
- /seed
- /minecraft:seed
- /bukkit:seed
- /spigot:seed
- /paper:seed

Command hiding
Blocked commands are removed from:
- visible command lists
- tab-completion suggestions
- command suggestions where supported

Structure and Jigsaw protection
SeedGuard can block:
- placing structure blocks
- breaking structure blocks
- interacting with structure blocks
- placing jigsaw blocks
- breaking jigsaw blocks
- jigsaw-related technical usage

Packet protection
SeedGuard blocks technical packets related to:
- block or entity NBT queries
- structure update or generate actions
- jigsaw updates
- debug subscription-like requests

Fake seed modes
Supported modes:
- per_player_stable — a stable fake seed for each player
- random_each_join — a new fake seed on every join
- fixed — the same configured fake seed for everyone

Recommended mode

fake-seed:
  mode: "per_player_stable"

Configuration
The plugin allows you to individually enable or disable:
- join packet protection
- respawn packet protection
- structure packet blocking
- jigsaw packet blocking
- NBT query packet blocking
- debug packet blocking
- command list updating on player join
- console logging of blocked attempts

Permission
seedguard.bypass

Players with this permission bypass the plugin’s restrictions.

Compatibility
- Server software: Paper
- Minecraft version: 1.21.11
- Java: 21 recommended

Important
SeedGuard is a hardening plugin, not a magic guarantee of absolute impossibility in every theoretical case.

Its goal is to reduce practical and common seed leak paths on multiplayer servers and make real-world abuse significantly harder.

Installation
1. Download the latest version
2. Put the .jar file into the plugins folder
3. Start or restart the server
4. Edit config.yml if needed
5. Replace the default salt value before production use

Recommended setup
- Use Paper 1.21.11
- Use Java 21
- Replace the default config salt with your own long random string

Why use SeedGuard?
Use SeedGuard if you want to:
- make seed-cracker tools less effective
- reduce easy seed leaks
- harden a public or private SMP
- limit technical abuse involving structure and NBT packet paths

────────────────────────

SeedGuard — это плагин безопасности для Paper 1.21.11, который помогает защитить SMP-сервера от распространённых способов получения сида мира.

Плагин создан для владельцев серверов, которые хотят значительно усложнить получение сида игроками, использующими seed-cracker моды, эксплойты, packet-based методы и техническое злоупотребление structure и NBT механиками.

Возможности

Fake seed
Плагин перехватывает важные исходящие пакеты и заменяет реальный hashed seed на поддельное значение.

Защита применяется в ключевых сценариях:
- вход на сервер
- респавн и смена состояния, где клиент снова получает данные мира

Это мешает клиентским модам и инструментам читать настоящий сид напрямую из сетевых данных.

Блокировка команд
Плагин блокирует:
- /seed
- /minecraft:seed
- /bukkit:seed
- /spigot:seed
- /paper:seed

Скрытие команд
Заблокированные команды убираются из:
- списка доступных команд
- подсказок автодополнения
- command suggestions, где это возможно

Structure и Jigsaw
Плагин может запрещать:
- установку structure block
- ломание structure block
- взаимодействие с structure block
- установку jigsaw
- ломание jigsaw
- использование jigsaw-функциональности

Packet-защита
SeedGuard блокирует технические пакеты, связанные с:
- block or entity NBT query
- structure update or generate
- jigsaw update
- debug subscription-подобными запросами

Режимы поддельного seed
Поддерживаются режимы:
- per_player_stable — стабильный фальшивый сид для каждого игрока
- random_each_join — новый фальшивый сид при каждом входе
- fixed — один и тот же заданный фальшивый сид для всех

Рекомендуемый режим

fake-seed:
  mode: "per_player_stable"

Настройка
Плагин позволяет отдельно включать и выключать:
- защиту join packet
- защиту respawn packet
- блокировку structure packet
- блокировку jigsaw packet
- блокировку NBT query packet
- блокировку debug packet
- обновление списка команд при входе
- логирование попыток в консоль

Permission
seedguard.bypass

Игроки с этим permission обходят ограничения плагина.

Совместимость
- Сервер: Paper
- Версия Minecraft: 1.21.11
- Java: 21 рекомендуется

Важно
SeedGuard — это усиливающий защиту плагин, а не магическая кнопка.
Он создан для того, чтобы сделать реальные способы утечки сида намного менее удобными и перекрыть самые частые практические каналы получения сида на SMP.

Установка
1. Скачайте последнюю версию
2. Переместите .jar в папку plugins
3. Запустите или перезапустите сервер
4. При необходимости настройте config.yml
5. Обязательно замените стандартный salt на собственную длинную случайную строку

Рекомендации
- Используйте Paper 1.21.11
- Используйте Java 21
- Замените стандартный salt в конфиге перед использованием на рабочем сервере

Зачем использовать SeedGuard
SeedGuard подойдёт, если вы хотите:
- усложнить работу seed-cracker модов
- закрыть лёгкие пути утечки сида
- усилить безопасность публичного или приватного SMP
- ограничить технические злоупотребления, связанные с structure и NBT packet-путями