Mineuniverse
Log in Register
Mods

IP Whitelist

A very simple mod for letting server owner only allow certain ips to join.
by Cyberking42
Download Claim this project
352 downloads
0 likes
Updated Jul 6, 2026
0 hypes
Miscellaneous Processing Server Utility

Have you ever wanted to protect your offline server from griefers, especially when default user whitelisting can be easily bypassed? With this simple, config-based mod, you can now do that! This is a server-sided mod so you will only need to install it on your server.

 

It is really easy to set this up:

  1. Install the mod onto your server
  2. Add your IPs that should be able to join the server to the ipwhitelist.txt file
  3. Restart the server for changes to take effect

 

Important Locations:

ipwhitelist.txt: \config\ipwhitelist.txt

ipwhitelist-server.toml: \world\serverconfig\ipwhitelist-server.toml

ip_attempts.log: \logs\ip_attempts.log

 

Features:

Supports IP Patterns: 127.*.*.* or 127.*.10.21 or 127.0.0.*

IP Logging: Logs connection attempts to the ip_attempts.log file

 

Examples:

This is how the ipwhitelist.txt file can look like:

127.0.0.1

10.255.255.*

172.31.255.255

188.*.*.*

 

Q: How do I know if this works?

A: If you just added the mod and try to connect to the server you will get disconnected. Then the mod is working and you havent set up your IPs in the ipwhitelist.txt file and get disconnected with the following message: "Your IP is not whitelisted."
The console will also log the loaded mod state and ip patterns (if it works):

[net.cyberking42.ipwhitelist.IpWhitelistMod/]: Starting IP Whitelist Mod (Server-side)
[net.cyberking42.ipwhitelist.IpWhitelistMod/]: IP whitelist file is empty. No IPs loaded.

What would happen if two IPs were added to the ipwhitelist.txt file:

[net.cyberking42.ipwhitelist.IpWhitelistMod/]: Loaded 2 IP patterns into the whitelist.

 

IP Whitelist 1.1.0 1.20.6-1.21.4 FORGE
MC 1.21, 1.21.4, Forge, 1.20.6, 1.21.3, 1.21.1, Server, 1.21.2
Release 2025-03-25 Get

More from Cyberking42

Tense Ambience
191,926
Day Counter
17,223

You Might Also Like

LoadingTips
A mod that adds custom tips to the loading screen
999,218
Sampler
Performance oriented debugging/administration tools
998,926
VulkanMod
Vulkan renderer mod for Minecraft.
997,115
Charm Fixer
Disables some modules on charm to fix incompatbility issues with owo
996,251
Trading station
Basic items to item trading machines
99,755
NarrateBookForMe [FABRIC]
Adds a narration keybind, and two GUI buttons to the book screen. Text-to-speech (tts) / narration on the go! Client sided.
99,734