Hostname Guard

# Hostname Guard

HostnameGuard is a lightweight Bukkit/Spigot/Paper/Purpur plugin that checks the hostname used by players when joining the server.

It can be used to block direct IP joins and allow only configured domain names.

## Features

- Allow only configured hostnames
- Block direct IP connections
- Optional wildcard hostname support
- Optional bypass permission
- Reload command
- Status command
- No NMS or version-specific server internals

## Commands

- `/hostnameguard reload`
- `/hostnameguard status`
- `/hg reload`
- `/hg status`

## Permissions

- `hostnameguard.reload`
- `hostnameguard.status`
- `hostnameguard.bypass`

## Requirements

- Java 21 or newer
- Bukkit/Spigot/Paper/Purpur compatible server
- Minecraft 1.20.5 or newer recommended

## Notes

This plugin checks the hostname reported during player login. It is intended for simple hostname-based access control, such as preventing players from joining through a raw IP address.