Are you running a server and occasionally meet some players you want to get rid of, but they keep coming back using alt accounts and a VPN? Well, now you’ve got the chance to identify their accounts based on a hardware ID instead of unreliable IPs, skins or behaviour!<\/p>\n
—<\/p>\n
### What this mod does ### What this mod doesn’t do ### How to use it then? —<\/p>\n ### Privacy ### Limitations —<\/p>\n ### Bash destination_path=”\/home\/minecraftserver\/config\/hwid” Stop annoying players from circumventing your bans by checking for alts based on hardware IDs<\/p>\n","protected":false},"featured_media":82861,"template":"","meta":{"_minecraft_slug":"hwid","_minecraft_project_id":"wslWWn2c","_minecraft_author":"lunofe","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":33613,"_minecraft_follows":4,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hwid.zip","_minecraft_size_bytes":33172,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T15:11:51.295538Z","_minecraft_date_created":"2023-06-20T02:29:46.718686Z","_minecraft_date_modified":"2026-03-03T21:06:27.200622Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hwid","_minecraft_icon_attachment_id":82861,"_minecraft_imported_at":"2026-06-04T17:59:17+00:00","_minecraft_import_hash":"0b2501bd7657a399dbf9803e9abad972","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,126,158,92],"mod_loader":[106],"minecraft_version":[36,60,93,94,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-82860","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-management","mod_category-neoforge","mod_category-utility","mod_loader-forge","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","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"],"yoast_head":"\n
\n– This mod is registering an empty argument, making it required on clients if your server has it installed. Players who try to remove it from their modpack can’t join your server.
\n– When players join your server, the client calculates a semi-unique hash value based on the player’s hardware, which is then stored by the server (`
\n– Automatically ban people based on hardware IDs
\n– Provide an easy way to find hardware IDs with multiple players in-game<\/p>\n
\nCheck some example scripts further down below, I don’t want to bury the following two points under codeblocks as they’re quite important to read.<\/p>\n
\nWhile a hardware ID sounds invasive, it’s way less confidental information than an IP address. The hardware ID is being calculated on the client using the SHA-256 algorithm, which is irreversible and therefore gives server operators no information on what hardware is being used. The hardware ID can only be used to tell unique hardware configurations apart.<\/p>\n
\n– Hardware IDs are semi-unique. If players upgrade their computer or replace it entirely, it will change. Players can also have the same hardware ID, if they coincidentally have the same computer, for example a common pre-built. Serial numbers (if existing) are included during the hash calculation to minimize this occurence.
\n– Dedicated troublemakers with knowledge of Java can decompile this mod and create an evil twin, sending a random or specific hardware ID every time they join.<\/p>\n
\n“`
\n#!\/bin\/bash<\/p>\n
\nfor file in “$destination_path”\/*
\ndo
\n line_count=$(wc -l <\"$file\") # Count the number of lines in the file\n if [ \"$line_count\" -gt 1 ] # Check if the line count is greater than 1\n then\n echo \"\"; echo \"$(basename \"$file\")\" # Print an empty line and the filename\n while IFS= read -r line # Read each line from the file\n do\n uuid=${line} # Assign the line to the variable 'uuid'\n response=$(curl -s https:\/\/sessionserver.mojang.com\/session\/minecraft\/profile\/${uuid}) # Send a request to the Mojang API to get the profile information\n name=$(echo \"$response\" | jq -r '.name') # Extract the 'name' field from the API response using jq\n echo \"${uuid} - ${name}\" # Print the UUID and the corresponding name\n done < \"$file\" # Read from the file\n fi\ndone\n```\n\n### Python 3\n```\nimport os, json, requests\n\nsearch = \"\" # Set the search term, eg. username, UUID or parts of either\n\nfor filename in os.listdir(\"\/home\/minecraftserver\/config\/hwid\"): # Iterate over each file in the specified directory\n with open(f\"\/home\/minecraftserver\/config\/hwid\/{filename}\", \"r\") as file: # Open each file in read mode\n lines = file.readlines() # Read all lines from the file\n if len(lines) > 1: # Check if there are more than one line in the file
\n result = “” # Initialize the result string
\n for line in lines:
\n uuid = line.strip() # Get the UUID from each line
\n response = requests.get(f”https:\/\/sessionserver.mojang.com\/session\/minecraft\/profile\/{uuid}”) # Send a GET request to Mojang API to get player profile
\n name = json.loads(response.text)[‘name’] # Extract the player name from the response
\n result += f”{uuid} – {name}n” # Append UUID and name to the result string
\n if search in result: # Check if the search string is present in the result
\n print(result) # Print the result
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"