🕵️ Hacking NOT Cheating

Transparent multiplayer modding for Minecraft 26.1.2
Let your players see each other's installed mods, and give admins the power to detect blacklisted clients – without banning everyone who mods their game.

✨ What It Does

Hacking NOT Cheating (HNC) is a client-server toolset that brings full transparency to your server. It's two parts, working together:

Fabric mod – installed by each player. Silently collects their mod list and sends it to the server when they join.
Paper plugin – installed on the server. Receives mod lists, stores them per player, and provides an elegant in-game GUI to inspect them.
Admins can configure a keyword blacklist (e.g., wurst, meteor) to flag suspicious mods, and even force players to have the mod before they can play.

No guessing, no false accusations. Just transparent, respectful multiplayer.

🔍 How It Works

A player with the HNC Fabric mod joins the server.
The mod builds a JSON list of all installed mods (id + name) and sends it through a secure plugin channel (hackingnotcheating:query).
The Paper plugin receives the packet, stores the list for that player's UUID, and logs it in the console.
Any player can run /mods to see their own mods, or /mods (with permission) to inspect someone else’s.

By default, a chest GUI opens – a clean inventory with green/red glass panes, tooltips, and pages.
Admins can switch to a fancy client-side screen (scrollable, with icons and tooltips) by changing one line in the config.
Mods matching any blacklisted keyword appear in bold dark red with a [!] warning, impossible to miss.
When a player leaves, their mod data is cleared automatically.
📥 Installation

Client (every player must install this)

Install Fabric Loader 0.16.10 (or later) for Minecraft 26.1.2.
Download the HNC Fabric mod .jar from Modrinth or your releases page.
Place the jar into your mods folder.
Launch the game. You’ll see a brief chat confirmation [HNC] Sent mod list to server when you join a compatible server.
No configuration needed – it just works.
Server

Download the HNC Paper plugin .jar.

Place it into your server’s plugins folder.
Restart (or load) the server.
The plugin will create plugins/HNC/config.yml with default settings.
That’s it! The plugin is now listening for mod lists.

⚙️ Configuration

All settings are inside plugins/HNC/config.yml. Here are the defaults and what they do:

yaml
# Keywords to flag as blacklisted (case-insensitive, matches anywhere in mod id or name)
blacklisted-keywords:
  - wurst
  - meteor

# Kick players who don't have the HNC mod installed?
require-mod-to-join: false

# Seconds to wait for the mod list before kicking (only applies if require-mod-to-join is true)
mod-timeout-seconds: 10

# GUI style: "CHEST" (default, server-side inventory) or "CUSTOM" (client-side fancy screen)
gui-type: CHEST
blacklisted-keywords – add any mod id or name you want to flag (e.g., xray, impact, future).
require-mod-to-join – set to true to force all players to install HNC. If a player doesn’t send their mod list within mod-timeout-seconds, they get kicked with a message.
gui-type – CHEST shows a classic chest inventory (works even without the mod on the viewer's side). CUSTOM opens a modern, scrollable screen (requires the viewer to also have the HNC mod).
After editing the file, reload the server or restart.

🎮 Usage

/mods – Opens your own mod list (or sends it in chat for console).
/mods <player> – Views another player’s mod list. Requires permission hackingnotcheating.viewothers.
Both commands will display the GUI as configured in gui-type.

GUI Types

Chest Inventory (gui-type: CHEST)

Opens a 54‑slot chest inventory.
Each mod is a green glass pane (safe) or red glass pane (blacklisted).
Blacklisted mods have a [!] prefix and bold red text.
Hover over an item to see its mod ID and blacklist status.
If there are many mods, use the arrow buttons at the bottom to flip pages.
This GUI works even if the viewer doesn’t have the HNC mod.

Fancy Client Screen (gui-type: CUSTOM)

Opens a native Minecraft screen (like the pause menu).
A scrollable list with green/red concrete icons for each mod.
Mod name and ID are shown next to the icon.
Hovering shows a tooltip with the mod ID and blacklist status.
Use the "Next" / "Previous" buttons to navigate pages, or "Done" to close.
This GUI requires the viewer to also have the HNC mod installed.

🔐 Permissions

Permission Description
hackingnotcheating.viewothers Allows using /mods to see other players' mods. Without it, you can only view your own.
Default: no one has this permission; you must grant it to trusted roles (e.g., admin, moderator).

##❓ FAQ

Do I need to install both the mod and the plugin?

The server only needs the Paper plugin. Each player who wants to be transparent (or join a server that requires the mod) must install the Fabric mod.

What if a player doesn’t have the mod?

If require-mod-to-join is false, they can still play, but their mod list will be empty when someone runs /mods .
If require-mod-to-join is true, they will be kicked after the timeout.
Can I see mods of players who aren’t using the mod?
No – the plugin only knows about a player’s mods if they send the list via the HNC mod.

Is this only for catching hackers?

No! It’s for transparency. Many server communities welcome mods like minimaps, shaders, or performance tweaks. HNC lets you spot actual hacked clients (like Wurst, Meteor) without blanket banning all mod users.

📜 License

This project is licensed under the MIT License.
You are free to use, modify, and distribute it as you see fit.

🙏 Credits

Made with ❤️ for the Minecraft community that believes modding isn’t cheating.
Crafted for Minecraft 26.1.2, Paper API 26.1.2, Fabric Loader 0.16.10, and official Mojang mappings.

“Trust is built with transparency.”