?️ Hacking NOT Cheating
适用于 Minecraft 26.1.2 的多玩家模组透明化工具
让你的玩家看到彼此安装的模组,并赋予管理员检测黑名单客户端的权力——而无需封禁所有使用模组的玩家。
✨ 功能介绍
Hacking NOT Cheating (HNC) 是一套为服务器带来完全透明度的客户端-服务端工具集。它由两部分组成,协同工作:
Fabric 模组 – 由每位玩家安装。静默收集他们的模组列表,并在加入时发送至服务器。
Paper 插件 – 安装在服务器上。接收模组列表,按玩家存储,并提供优雅的游戏内 GUI 供检查。
管理员可以配置关键词黑名单(例如 wurst, meteor)以标记可疑模组,甚至可以强制要求玩家在游玩前必须安装该模组。
不再猜测,没有误判。只有透明、尊重的多人游戏体验。
? 工作原理
拥有 HNC Fabric 模组的玩家加入服务器。
模组构建一个包含所有已安装模组(ID + 名称)的 JSON 列表,并通过安全插件频道 (hackingnotcheating:query) 发送。
Paper 插件接收数据包,为该玩家的 UUID 存储列表,并在控制台中记录日志。
任何玩家都可以运行 /mods 查看自己的模组,或在拥有权限的情况下运行 /mods <player> 检查其他人的模组。
默认情况下,会打开一个箱子 GUI —— 一个干净的物品栏,带有绿色/红色玻璃板、工具提示和分页功能。
管理员可以通过更改配置文件中的一行代码,切换到华丽的客户端屏幕(可滚动,带有图标和工具提示)。
匹配任何黑名单关键词的模组会以粗体深红色显示并带有 [!] 警告,无法被忽视。
当玩家离开时,其模组数据会自动清除。
? 安装说明
客户端(每位玩家都必须安装此部分)
- 为 Minecraft 26.1.2 安装 Fabric Loader 0.16.10(或更高版本)。
- 从 Modrinth 或你的发布页面下载 HNC Fabric 模组
.jar 文件。
- 将 jar 文件放入
mods 文件夹。
- 启动游戏。当你加入兼容的服务器时,你会在聊天中看到简短的确认信息
[HNC] Sent mod list to server。
无需配置——开箱即用。
服务端
- 下载 HNC Paper 插件
.jar 文件。
- 将其放入服务器的
plugins 文件夹。
- 重启(或加载)服务器。
插件将创建
plugins/HNC/config.yml 并包含默认设置。
就这样!插件现在正在监听模组列表。
⚙️ 配置
所有设置都位于 plugins/HNC/config.yml 中。以下是默认值及其作用:
# 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 – 添加你想要标记的任何模组 ID 或名称(例如 xray, impact, future)。
- require-mod-to-join – 设置为
true 以强制所有玩家安装 HNC。如果玩家在 mod-timeout-seconds 秒内未发送模组列表,他们将被踢出并收到一条消息。
- gui-type –
CHEST 显示经典的箱子物品栏(即使查看者没有模组也能正常工作)。CUSTOM 打开现代的可滚动屏幕(要求查看者也安装了 HNC 模组)。
编辑文件后,重新加载服务器或重启即可。
? 使用方法
/mods – 打开你自己的模组列表(如果在控制台运行则会在聊天中发送)。
/mods <player> – 查看其他玩家的模组列表。需要权限 hackingnotcheating.viewothers。
这两个命令都将按照 gui-type 配置显示 GUI。
GUI 类型
箱子物品栏 (gui-type: CHEST)
打开一个 54 格的箱子物品栏。
每个模组都是一个绿色玻璃板(安全)或红色玻璃板(已列入黑名单)。
已列入黑名单的模组带有 [!] 前缀和粗体红色文本。
悬停在物品上可查看其模组 ID 和黑名单状态。
如果模组很多,请使用底部的箭头按钮翻页。
此 GUI 即使在查看者没有 HNC 模组的情况下也能正常工作。
华丽客户端屏幕 (gui-type: CUSTOM)
打开原生的 Minecraft 屏幕(类似暂停菜单)。
一个可滚动的列表,每个模组都有绿色/红色混凝土图标。
模组名称和 ID 显示在图标旁边。
悬停时会显示包含模组 ID 和黑名单状态的工具提示。
使用“Next” / “Previous”按钮导航页面,或使用“Done”关闭。
此 GUI 要求查看者也安装了 HNC 模组。
? 权限
| 权限 |
描述 |
hackingnotcheating.viewothers |
允许使用 /mods <player> 查看其他玩家的模组。如果没有此权限,你只能查看自己的模组。 |
默认情况下,没有人拥有此权限;你必须将其授予受信任的角色(例如 admin, moderator)。
❓ 常见问题
Do I need to install both the mod and the plugin?
服务器只需要 Paper 插件。想要保持透明(或加入要求安装模组的服务器)的每位玩家都必须安装 Fabric 模组。
What if a player doesn’t have the mod?
如果 require-mod-to-join 为 false,他们仍然可以游玩,但当有人运行 /mods <player> 时,他们的模组列表将为空。
如果 require-mod-to-join 为 true,他们在超时后会被踢出。
Can I see mods of players who aren’t using the mod?
不可以 —— 如果玩家没有通过 HNC 模组发送列表,插件就无法知道他们的模组信息。
Is this only for catching hackers?
不!这是为了透明度。许多服务器社区欢迎诸如小地图、光影或性能优化等模组。HNC 让你能够识别真正的作弊客户端(如 Wurst, Meteor),而无需一刀切地封禁所有模组用户。
? 许可证
本项目根据 MIT License 许可。
你可以自由地使用、修改和分发它。
? 致谢
专为相信“模组不是作弊”的 Minecraft 社区而 ❤️ 制作。
专为 Minecraft 26.1.2、Paper API 26.1.2、Fabric Loader 0.16.10 和官方 Mojang 映射打造。
“信任建立在透明之上。”
?️ 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 <player> (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 <player> 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 <player>.
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.”
评论 0
登录后参与评分
还没有评论,来抢沙发吧