Bukkit

# SeedGuard HMAC

SeedGuard HMAC is an open-source security plugin that makes automated Minecraft world-seed extraction significantly harder without modifying terrain, structures, loot, or normal gameplay.

## Features

- Replaces the client-visible hashed seed in LOGIN and RESPAWN packets
- Generates a private 256-bit master secret
- Derives a different stable fake seed hash for every player using HMAC-SHA256
- Protects joins, respawns, and dimension changes
- Blocks /seed, /locate, and namespaced variants for unauthorized players
- Removes blocked commands from command suggestions
- Fails safely on unknown packet layouts instead of disconnecting players
- Includes /seedguard status compatibility counters
- No telemetry, network connections, database, or world modification

## Requirements

- Java 17+
- Paper or Spigot 1.20.4+
- ProtocolLib 5.4.0
- Newer Minecraft versions may require a current ProtocolLib development build

## Commands

- /seedguard status
- /seedguard reload

## Permissions

- seedguard.admin
- seedguard.commands.bypass

## Important

SeedGuard HMAC is a defensive hardening layer. Minecraft clients necessarily receive terrain data, so no plugin can promise mathematical impossibility of seed recovery. For maximum protection, combine it with Paper feature seeds, custom Spigot structure seeds, and Paper Anti-Xray.