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.

!hostname guard

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.