HWID Auth — HWID authorization for Minecraft servers

Version: 1.0.0
Compatibility: Minecraft 1.20.1, Forge 47.4.8

Description:

HWID Auth collects a unique HWID (hardware identifier) of a player on the client using the OSHI library, sends it to the server upon connection and stores player data in a local JSON file on the server. The mod allows you to block and unblock players by HWID through commands, kick them if the HWID does not match, and also integrates with server permission systems to restrict commands.

Functionality

HWID collection

On the client side, the mod calculates the HWID through a combination of the manufacturer, model and serial number of the motherboard.

The HWID is hashed using SHA-256 and sent to the server when the player connects.

Data storage

The server stores information about each player in the file config/FPZone/hwid_storage.json.

The structure of the JSON file:

{ "UUID1": { "username": "username1", "hwid": "hwid1", "status": true }, "UUID2": { "username": "username2", "hwid": "hwid2", "status": false } }

UUID is a unique Minecraft player identifier.

username is the player's name.

hwid is the HWID received from the client.

status is the authorization status: true = allowed, false = blocked.

HWID check upon connection:

If a player with an already registered HWID has status: false, he is kicked from the server with the message:
"You have not been authorized on the server!".

If the status is true or the player is new, the HWID is saved/updated in JSON.

HWID management commands:

Command Description Access

/banHwid <nickname> Ban a player by HWID and kick him if online Operator
/unbanHwid <nickname> Unban a player by HWID Operator

The commands work with offline players, search for them by name in hwid_storage.json.

Banning changes the status field to false, unbanning - to true.

You can support a budding author through DonationAlerts