# Status Hider<\/p>\n
A network security mod for Minecraft servers, meant to keep server crawlers out of your face and preventing them access
\nto your online players data, MotD, and such, all the while adding some neat features for you to use.<\/p>\n
## Why<\/p>\n
As a server administrator myself, I was often seeing logs of connection attempts, or uncaught network errors
\n(e.g. the recurrent `connection reset by peer` message), that even mass IP-banning simply couldn’t help with.<\/p>\n
But I finally ticked and decided to act when I saw a log of a supposed connection attempt from a ‘ServerSeekerV2′ user,
\nwhich obviously linked to the ServerSeekerV2 software, proving to me
\nonce and for all that there were people out there that had nothing better to do that have software scanning the net for
\nMinecraft servers, to know which ones are online and when, and who is playing on them at set times, storing and
\ncross-comparing the generated data to possibly dress up players profiles that could then be used for ill intents.<\/p>\n
So I took upon myself to dive into the whole server ping and login network protocol, and made this mod to allow more
\nprivacy to server owners and their players.<\/p>\n
### Let me get data in peace<\/p>\n
No. Respect people’s privacy.<\/p>\n
## How it works<\/p>\n
### Files<\/p>\n
The mod stores some information about connection attempts and known players. As such, three additional files are created
\nin the server’s main directory:<\/p>\n
* `player_ip_cache`: this file stores some information about players that have properly joined the server at least once.
\n Each entry (one line being one entry) holds the player name, UUID, and a list of the player’s known IPs’ hashes.
\n It allows the mod to know if an incoming connection is from a known player, and thus determines most of the mod’s
\n overall behaviour. You may at will remove or modify an entry, but the mod will yell in the server’s console if a line
\n cannot be properly parsed in a valid entry.<\/p>\n
* `request_metrics`: this file stores the mod’s memory of connection attempts, ping requests, and alike, from various
\n IP addresses. Each line (entry) is composed of the IP hash, the number of ping attempts from the IP, the number of
\n login attempts from the IP, and the number of overall requests (login or ping alike) all the while the IP address has
\n been banned – if it has been banned. This file is particularly useful for the auto-IP-ban feature.<\/p>\n
* `ip_whitelist`: this file stores a list of RegEx expressions of any whitelisted IP that are allowed to ping the server
\n regardless of registering a player or not. This is only truly relevant for server panels, most often provided by
\n third-party hosting services, that regularly run server pings in order to provide some analytics to the server owners.
\n Note that this does not impact players’ ability to join the server, they do not need to be whitelisted!<\/p>\n
* `ip_limit_list`: this file follows the same format as the `ip_whitelist`.
\n It is only relevant if the appropriate gamerule is enabled.
\n It determines a collection of patterns that any non-local source must match in order to establish a connection to the server.<\/p>\n
#### Why IP hashes<\/p>\n
The mod deal with IP hashes as much as it can, not only in order to reduce the processed data, but also what it may
\nexpose to any potential third party that could get access to the server files. Obviously, considering servers can by
\nthemselves store any and all IP in the logs, it may not be the most relevant, but in the event of a server getting
\ncompromised, exposing the least player information directly remains a better standing point. Since hashing allows to
\nproduce consistent results that will never change from a same initial value, but not easily allow for figuring out the
\ninitial value from the result, it is a mean to somewhat obscure data from potentially malicious factors to some extent.<\/p>\n
### Gamerules<\/p>\n
The mod additionally adds a set of custom gamerules, each allowing to control its various features:<\/p>\n
* `status_hider:reduced_ping_data`: sets from whom to reduce ping data details, such as hiding the connected players
\n list, providing fake max online\/max player counts, and hiding the MotD. Set to unknown or banned IPs by default.
\n* `status_hider:restrict_ping`: toggles whether to cut short to any ping request coming from an
\n unknown IP address (not linked to any player that has already joined the server). Enabled by default.
\n* `status_hider:log_restricted_requests`: toggles whether to log when the mod blocks out a ping request.
\n* `status_hider:enable_fancy_motd`: toggles the [fancy motd](#fancy-motd) feature. Enabled by default.
\n* `status_hider:enforce_ip_ban`: toggles the [real IP-ban](#real-ip-ban) feature. Enabled by default.
\n* `status_hider:auto_ban_unknown_ip_after_requests`: sets how many requests can an unknown IP address can make before
\n automatically getting IP-banned ; set it to 0 in order to disable the feature. Accepts values between 0 and 100, set
\n to 10 by default.
\n* `status_hider:log_banned_ip_requests`: sets how often should requests from banned IPs be logged in the server’s
\n console. More specifically, indicates out of how many requests should it be logged (uses modulo) ;
\n 1 would mean every time, 20 would mean every one request out of 20 ; set it to 0 to disable the feature. Accepts
\n values between 0 and 100, set to 10 by default.
\n* `status_hider:limit_allowed_ip`: toggles whether to restrict connections to sources matching the IP allow list
\n patterns (defaults to `false`)<\/p>\n
### Real IP Ban<\/p>\n
In the vanilla code, IP bans are only checked very late in the player login sequence, and completely ignored when it
\ncomes to ping requests. All in all, it is a rather weak feature.<\/p>\n
As such, this mod takes it to a whole other level, and makes it so that any request whatsoever, from a banned,
\nnon-whitelisted (not matching any ip-whitelist entry) IP address, will purely and simply never be answered to.<\/p>\n
Thus, any banned IP will be left hanging when making a request, as if the server was not running.
\nAdditionally, every 10 request from a banned-ip, the server will mention it in the console, so as to let server
\nadministrators know of the relevance of an IP ban.<\/p>\n
### Fancy MOTD<\/p>\n
Since the mod already links up players and their IP adresses, I figured it also was an occasion to create a fancy way to
\nwelcome players, using the MotD.<\/p>\n
As such, any `{username}` in the server’s MotD will be automatically replaced with a matching known player name, if any.<\/p>\n
Additionally, knowing some basics of how IP addresses are used across the globe, I decided to *include inside the mod a
\nfile of per-country allocated IP ranges*[*](#ip-ranges-file), which enables the mod to guess and replace any `{country}`
\nin the MotD with a possibly matching country name, or `unknown` if none was found.<\/p>\n
#### ip ranges file<\/p>\n
This file is a rather minimalistic file, albeit still pretty big, which makes up for most of the mod jar’s file size.<\/p>\n
It is a bundled file in order to avoid using a third party API, which would go against two of this mod’s goals:
\n* Not giving more data than required to third parties. Using a third party API would mean allowing them to know what IPs
\n are joining the server, and thus, what are the players’ IPs.
\n* Not manipulating or exposing more data than needed. Most third party APIs for IP address geolocation go far and beyond
\n the needs of this mod, and would imply fetching data that other, potentially malicious, mods, could intercept.
\n And while it is true that other mods could already get all these information by themselves, not exposing it even more
\n is but only a good practice.<\/p>\n
This file was produced from data provided free of use by ayra.ch, after simplification, for
\nboth removing unusable values as well as for country name readability.<\/p>\n
### Command<\/p>\n
This mod adds a custom command, that allows for some useful alternatives to manually editing files, besides also a way
\nto reload the cache or metrics file at runtime. (the ip whitelist file is only loaded at server startup, due to its
\nnature of not needing to be edited often). It has a permission level requirement of 4 (default vanilla OP level,
\ncan be changed in the `server.properties` file, per-player values can be modified in the vanilla `ops.json` file)<\/p>\n
`\/status_hider forget `\/status_hider reload [cache|metrics|whitelist|limit_list]` allows server admins to either reload the IP cache file, `\/status_hider whitelist `\/status_hider unwhitelist `\/status_hider test Enforces Minecraft network privacy like it should have always been<\/p>\n","protected":false},"featured_media":148404,"template":"","meta":{"_minecraft_slug":"status_hider","_minecraft_project_id":"avExCliG","_minecraft_author":"Nerjal_Nosk","_minecraft_license":"LicenseRef-Lambda-License","_minecraft_downloads":1066,"_minecraft_follows":24,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"status_hider.zip","_minecraft_size_bytes":71652504,"_minecraft_version_count":26,"_minecraft_updated_at":"2026-05-16T17:36:28.555341Z","_minecraft_date_created":"2025-05-07T04:26:37.108400Z","_minecraft_date_modified":"2026-05-13T09:05:15.721745Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/status_hider","_minecraft_icon_attachment_id":148404,"_minecraft_imported_at":"2026-06-08T21:54:47+00:00","_minecraft_import_hash":"64e0b173433258aec56101357e78d0e1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,126,867,92],"mod_loader":[99],"minecraft_version":[36,60,93,94,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-148403","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-management","mod_category-social","mod_category-utility","mod_loader-fabric","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\nauto-generated name. If the IP is already registered in an existing entry, the command will not do anything.
\nIf an entry already exists for that name, then the provided IP will be added to it. Otherwise, a new entry with a
\nrandom UUID will be created with that IP listed for it.<\/p>\n
\nthe request metrics file, the whitelist file, the limit list file, or all if not specified.
\n(beware that depending on your server’s activity, you may want to run the command quickly after modifying the file,
\nas any changes in the runtime cache or metrics will overwrite the file completely)<\/p>\n
\nto restart the server.<\/p>\n
\nhaving to restart the server. (existing entries will be suggested for patter auto-completion)<\/p>\n
\nThis is especially relevant for minute modifications such as manually removing a specific IP from a player’s entry.<\/p>\n","protected":false},"excerpt":{"rendered":"