HNC

HNC

Minecraft 26.1.2 的透明多人模组 让玩家看到彼此已安装的模组,并赋予管理员检测黑名单客户端的能力——而无需封禁所有对游戏进行模组修改的玩家。

游戏机制

🕵️ 黑客行为而非作弊

为 Minecraft 26.1.2 提供的透明多人模组方案 让你的玩家能够看到彼此已安装的模组,并赋予管理员检测黑名单客户端的能力——而无需封禁所有使用模组的玩家。

✨ 功能简介

黑客行为而非作弊(HNC)是一套客户端-服务端工具集,为你的服务器带来完全的透明度。它由两个协同工作的部分组成:

Fabric 模组——由每位玩家安装。静默收集他们的模组列表,并在加入时发送至服务器。 Paper 插件——安装在服务器上。接收模组列表,按玩家存储,并提供优雅的游戏内 GUI 以供查看。 管理员可以配置关键词黑名单(例如 wurst、meteor)来标记可疑模组,甚至可以强制玩家必须安装该模组才能游玩。

无需猜测,无需误判。只有透明、互相尊重的多人游戏体验。

🔍 工作原理

安装了 HNC Fabric 模组的玩家加入服务器。 该模组构建一个包含所有已安装模组(id + 名称)的 JSON 列表,并通过安全插件通道(hackingnotcheating:query)发送。 Paper 插件接收数据包,按玩家的 UUID 存储该列表,并在控制台记录日志。 任何玩家都可以运行 /mods 查看自己的模组,或使用 /mods (需权限)查看他人的模组。

默认情况下,会打开一个箱子 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 中。以下是默认值及其作用:

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 – 添加任何你想标记的模组 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 和黑名单状态。 如果模组较多,使用底部的箭头按钮翻页。 即使查看者未安装 HNC 模组,此 GUI 也可正常工作。

精美客户端界面(gui-type: CUSTOM)

打开一个原生 Minecraft 界面(类似暂停菜单)。 一个可滚动的列表,每个模组带有绿色/红色混凝土图标。 图标旁边显示模组名称和 ID。 悬停会显示工具提示,包含模组 ID 和黑名单状态。 使用“下一页”/“上一页”按钮导航页面,或使用“完成”关闭。 此 GUI 要求查看者也安装了 HNC 模组。

🔐 权限

权限 描述 hackingnotcheating.viewothers 允许使用 /mods 查看其他玩家的模组。没有此权限,你只能查看自己的模组。 默认:无人拥有此权限;你必须将其授予受信任的角色(例如管理员、版主)。

##❓ 常见问题

我需要同时安装模组和插件吗?

服务器只需要 Paper 插件。每位希望保持透明(或加入要求安装模组的服务器)的玩家必须安装 Fabric 模组。

如果玩家没有安装模组怎么办?

如果 require-mod-to-join 为 false,他们仍可游玩,但当有人运行 /mods 时,他们的模组列表将为空。 如果 require-mod-to-join 为 true,他们将在超时后被踢出。 我可以查看未使用模组的玩家的模组吗? 不可以——插件只有在玩家通过 HNC 模组发送列表时,才知道其模组信息。

这只是用来抓作弊者的吗?

不!这是为了透明度。许多服务器社区欢迎小地图、光影或性能优化等模组。HNC 让你能够发现真正的作弊客户端(如 Wurst、Meteor),而无需一刀切地封禁所有模组用户。

📜 许可证

本项目采用 MIT 许可证授权。 你可以自由使用、修改和分发。

🙏 致谢

用 ❤️ 为相信模组不是作弊的 Minecraft 社区打造。 为 Minecraft 26.1.2、Paper API 26.1.2、Fabric Loader 0.16.10 和官方 Mojang 映射制作。

“信任建立在透明之上。”