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.reloadhostnameguard.statushostnameguard.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.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20.5, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Verified by MCModsHub
- Ships as HostnameGuard-1.0.1.jar — drop this file into the mods folder
- Download size: 7 KB
- Download link checked 14 Sept 2026 — working
These come from our own check of the pack file, not from the source page.