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.