HailWall

模组

· 作者 Abaraburu

服务器端模组白名单/黑名单:在玩家加入时检查其客户端安装的模组,并踢出未授权的模组。(需同时安装在服务器和客户端上。)

0 本站下载 0 关注 更新于 5 个月前

需要前置:Fabric API

最新 1.0.3 · 1.16.5 · Fabric

一键开服(送7天)

HailWall — 模组白名单

HailWall 会在玩家加入时检查其 客户端 上已安装的模组,如果检测到 禁止 的模组(或缺少 必需 模组),则将其踢出。这是对经典 Mod Whitelist 理念的一种现代化、轻量级的实现。

⚠️ 必须在服务器和每个客户端上都安装。 纯服务端模组无法读取客户端的完整模组列表——原版游戏根本不会发送它。因此,像所有此类模组一样,HailWall 需要在客户端运行一个微小的配套组件。

✨ 功能特性

  • 白名单模式(默认)—— 阻止除你允许的模组之外的所有内容。核心模组(minecraft、加载器、java、hailwall)始终被允许。
  • 黑名单模式 —— 除了特定模组(作弊客户端、透视等……)外,允许所有内容。
  • 必需模组 —— 踢出缺少强制性模组的玩家。
  • 操作员绕过 —— 服务器操作员永远不会被踢出,即使他们安装了额外模组(可通过 usePermission 开关控制)。
  • 过渡/监控模式 (enforce: false) —— 不踢出任何人,但仍记录所有人的模组信息。非常适合在构建你的列表时部署 HailWall 而不干扰玩家。
  • 访问日志 —— 每天生成一个 JSON-Lines 文件(保存在 config/ 下,因此在 Aternos 等主机上也可访问),列出谁加入了服务器以及使用了哪些模组。旧文件会自动清理。
  • 签名握手 —— HMAC + 每次连接挑战,以防止简单的数据包伪造。
  • 零游戏玩法开销 —— 所有内容仅在登录期间发生一次;日志写入在独立线程中进行。没有每刻(tick)的性能成本。

⚙️ 工作原理

在登录握手过程中,服务器向客户端请求其模组列表。客户端回复其已安装的顶层模组(ID + 版本),并使用 HMAC 进行签名。服务器验证签名,将列表与你的配置进行比较,然后在玩家进入世界之前决定是允许其进入还是断开连接。

情况 结果
安装在客户端 和 服务器上 ✅ 完整验证
仅安装在 客户端 你仍然可以在其他服务器上游玩;在这里它不提供任何保护
仅安装在 服务器 上 没有 HailWall 的客户端无法加入(当 requireCompanionMod 开启时)

? 设置步骤

  1. 在你选择的模组加载器(例如 Fabric、Forge 或 NeoForge)的正确版本以及任何必需的 API 上安装到服务器和每个客户端。
  2. 将 hailwall-x.y.z.jar 放入 服务器 和 每个客户端 的 mods/ 文件夹中。
  3. 启动服务器一次以生成 config/hailwall.json,编辑它,然后重启。

? 配置 — config/hailwall.json

{
  "mode": "whitelist",          // "whitelist" 或 "blacklist"
  "enforce": true,              // false = 监控模式(仅记录日志,不踢人)
  "operatorsBypass": true,      // 操作员永远不会被踢出
  "requireCompanionMod": true,  // 踢出没有 HailWall 的客户端
  "verifySignature": true,
  "logModLists": true,
  "enableAccessLog": true,
  "accessLogRetentionDays": 5,

  "whitelist": ["sodium", "iris", "modmenu"],          // 你允许的模组
  "blacklist": ["meteor-client", "wurst", "baritone"], // 仅在黑名单模式下使用
  "requiredMods": []
  // + 完全可自定义 / 可翻译的踢出消息
}

你可以在其 mod.json(id 字段)中找到任何模组的 ID。更简单的方法:直接从 访问日志 中读取,或者从客户端的 logs/latest.log 中读取,HailWall 会在那里打印报告的模组列表。

? 隐私与数据

  • 客户端仅发送顶层模组的 模组 ID + 版本 —— 没有 文件路径,没有 系统信息,没有 个人数据。
  • 这些数据用于允许/拒绝加入,并仅记录在 服务器自身的访问日志 中(默认保留 5 天)。它不会发送到其他地方,其他玩家也无法看到它。
  • 开源 —— 你可以确切地验证它做了什么。

?️ 诚实的安全说明

与 所有 客户端模组检查一样,HailWall 并非无懈可击:坚定的用户仍然可能绕过它。HMAC + 挑战可以防止随意的伪造,但无法阻止专家级攻击。它对普通玩家非常有效,最好与 online-mode=true 配合使用。将其视为一层坚固的保护,而不是银弹。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源