HWID Tracker (Notification / Listing / Kick / Ban)

HWID Tracker is a lightweight utility mod for NeoForge that silently tracks the hardware ID (HWID) of players connecting to your server — enabling reliable HWID-based bans, multi-account detection, and instant operator alerts.

Unlike name or IP bans, a HWID ban is tied to the player's physical hardware, making it significantly harder to evade by simply creating a new account or switching networks.

⚠️ Note: This mod requires installation on both server and client. Add it as a required mod in your modpack. Players without the mod cannot connect.

✨ Features

🔍 Silent HWID tracking — hardware data is collected automatically on login, with no prompt or notification shown to the player
🔨 HWID + UUID + IP ban in one command — /hban covers all three ban layers simultaneously
🚫 Multi-account detection — detects when two accounts share the same hardware and kicks the second account instantly
📢 Operator alerts — all online operators (permission level 3+) receive an immediate in-game notification on multi-account attempts
📁 Per-player HWID files — each player gets their own config/user-hwids/<uuid>.txt with name, UUID, HWID hash, IP, first seen and last seen
📋 Ban list file — all bans are stored in config/user-hwids/bans.json with reason, banner name, and timestamp
🔁 Vanilla ban integration — automatically writes to banned-players.json and banned-ips.json on ban
♻️ Full unban support — /hunban removes the player from all three ban lists at once
🔎 HWID lookup command — /hwid shows all stored data for any player, online or offline
⚡ Lightweight — no database, no external services, pure file-based storage

📋 Commands

All commands require permission level 3 (Operator).

Command	Description
`/hwid <name>`	Show HWID data for a player (online or offline) — UUID, IP, HWID hash, first/last seen, ban status
`/hban <name>`	Ban a player by HWID + UUID + IP (works for online and offline players)
`/hban <name> <reason>`	Ban with a custom reason
`/hunban <name>`	Remove all bans for a player (HWID, UUID and IP)
`/hbanlist`	List all active HWID bans with name, reason, banner and timestamp

🔄 How It Works

Step	What happens
1. Player joins	Client mod silently reads Mainboard Serial + CPU ID + total RAM
2. Hash	Values are combined and hashed with SHA-256 — no raw hardware data ever leaves the client
3. Packet sent	The hash is sent to the server in a silent custom packet
4. Ban check	Server checks the hash against `bans.json` — if banned, player is disconnected and added to vanilla ban lists
5. Multi-account check	Server checks if the same HWID hash is already active in the current session — if so, second account is kicked and operators are alerted
6. File saved	Player data (name, UUID, HWID, IP, timestamps) is written to `config/user-hwids/<uuid>.txt`

🎯 Example Use Case

A player gets caught cheating. You run /hban PlayerName Cheating. The mod instantly:

Kicks them from the server
Writes their HWID, UUID and IP to bans.json
Adds them to vanilla banned-players.json and banned-ips.json

They create a new account and try to rejoin. The moment their client connects, the HWID hash matches → they are disconnected before they can even move, and you receive an in-game alert.

📦 Technical Details


Minecraft Version	1.21.1
Mod Loader	NeoForge 21.1.220+
Java Version	21
Side	Client + Server (required on both)
Dependencies	None (OSHI is bundled with NeoForge)
Mod ID	`hwidtracker`
Storage	`config/user-hwids/`
HWID Components	Mainboard Serial · CPU Identifier · Total RAM

HWID-Tracker (Notification/Listing/Kick/Ban) by Area