# 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.
