HailWall — 模组白名单
HailWall 会在玩家加入时检查其 客户端 上已安装的模组,如果检测到 禁止 的模组(或缺少 必需 模组),则将其踢出。这是对经典 Mod Whitelist 理念的一种现代化、轻量级的实现。
⚠️ 必须在服务器和每个客户端上都安装。 纯服务端模组无法读取客户端的完整模组列表——原版游戏根本不会发送它。因此,像所有此类模组一样,HailWall 需要在客户端运行一个微小的配套组件。
✨ 功能特性
- 白名单模式(默认)—— 阻止除你允许的模组之外的所有内容。核心模组(
minecraft、加载器、java、hailwall)始终被允许。 - 黑名单模式 —— 除了特定模组(作弊客户端、透视等……)外,允许所有内容。
- 必需模组 —— 踢出缺少强制性模组的玩家。
- 操作员绕过 —— 服务器操作员永远不会被踢出,即使他们安装了额外模组(可通过
usePermission开关控制)。 - 过渡/监控模式 (
enforce: false) —— 不踢出任何人,但仍记录所有人的模组信息。非常适合在构建你的列表时部署 HailWall 而不干扰玩家。 - 访问日志 —— 每天生成一个 JSON-Lines 文件(保存在
config/下,因此在 Aternos 等主机上也可访问),列出谁加入了服务器以及使用了哪些模组。旧文件会自动清理。 - 签名握手 —— HMAC + 每次连接挑战,以防止简单的数据包伪造。
- 零游戏玩法开销 —— 所有内容仅在登录期间发生一次;日志写入在独立线程中进行。没有每刻(tick)的性能成本。
⚙️ 工作原理
在登录握手过程中,服务器向客户端请求其模组列表。客户端回复其已安装的顶层模组(ID + 版本),并使用 HMAC 进行签名。服务器验证签名,将列表与你的配置进行比较,然后在玩家进入世界之前决定是允许其进入还是断开连接。
| 情况 | 结果 |
|---|---|
| 安装在客户端 和 服务器上 | ✅ 完整验证 |
| 仅安装在 客户端 | 你仍然可以在其他服务器上游玩;在这里它不提供任何保护 |
| 仅安装在 服务器 上 | 没有 HailWall 的客户端无法加入(当 requireCompanionMod 开启时) |
? 设置步骤
- 在你选择的模组加载器(例如 Fabric、Forge 或 NeoForge)的正确版本以及任何必需的 API 上安装到服务器和每个客户端。
- 将
hailwall-x.y.z.jar放入 服务器 和 每个客户端 的mods/文件夹中。 - 启动服务器一次以生成
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 配合使用。将其视为一层坚固的保护,而不是银弹。
HailWall — Mod Whitelist
HailWall checks the mods installed on a player's client when they join, and kicks them if they have disallowed mods (or are missing a required one). It's a modern, lightweight take on the classic Mod Whitelist idea.
⚠️ Install it on BOTH the server and every client. A purely server-side mod cannot read a client's full mod list — vanilla simply doesn't send it. So, like every mod of this kind, HailWall needs a tiny companion running on the client.
✨ Features
- Whitelist mode (default) — block everything except the mods you allow. The essentials (
minecraft, the loader,java,hailwall) are always allowed. - Blacklist mode — allow everything except specific mods (cheat clients, x-ray, …).
- Required mods — kick players who are missing a mandatory mod.
- Operator bypass — server operators are never kicked, even with extra mods (like a
usePermissiontoggle). - Transition / monitor mode (
enforce: false) — kick nobody, but still record everyone's mods. Perfect for rolling HailWall out without disrupting players while you build your list. - Access log — one JSON-Lines file per day (kept under
config/, so it's reachable even on hosts like Aternos) listing who joined and with which mods. Old files are pruned automatically. - Signed handshake — HMAC + per-connection challenge to stop trivial packet spoofing.
- Zero gameplay overhead — everything happens once, during login; the log is written off-thread. No per-tick cost.
⚙️ How it works
During the login handshake the server asks the client for its mod list. The client replies with its installed top-level mods (id + version), signed with HMAC. The server verifies the signature, compares the list against your config, and either lets the player in or disconnects them — all before they enter the world.
| Situation | Result |
|---|---|
| Installed on client and server | ✅ Full verification |
| Installed only on the client | You can still play on other servers; here it protects nothing |
| Installed only on the server | A client without HailWall can't join (when requireCompanionMod is on) |
? Setup
- Install the correct version of your chosen mod loader (e.g., Fabric, Forge, or NeoForge) and any required APIs on the server and on every client.
- Drop the
hailwall-x.y.z.jarinto themods/folder of the server and of each client. - Start the server once to generate
config/hailwall.json, edit it, and restart.
? Configuration — config/hailwall.json
{
"mode": "whitelist", // "whitelist" or "blacklist"
"enforce": true, // false = monitor mode (log only, kick nobody)
"operatorsBypass": true, // operators are never kicked
"requireCompanionMod": true, // kick clients that don't have HailWall
"verifySignature": true,
"logModLists": true,
"enableAccessLog": true,
"accessLogRetentionDays": 5,
"whitelist": ["sodium", "iris", "modmenu"], // YOUR allowed mods
"blacklist": ["meteor-client", "wurst", "baritone"], // used only in blacklist mode
"requiredMods": []
// + fully customizable / translatable kick messages
}
Find any mod's id in its mod.json (the id field). Easier: read it straight from the access log, or from the client's logs/latest.log, where HailWall prints the reported mod list.
? Privacy & data
- The client sends only mod ids + versions of top-level mods — no file paths, no system info, no personal data.
- That data is used to allow/deny the join and is recorded only in the server's own access log (default 5-day retention). It's never sent anywhere else, and other players can't see it.
- Open source — you can verify exactly what it does.
?️ Honest security note
Like every client-side mod check, HailWall is not bulletproof: a determined user could still bypass it. The HMAC + challenge stops casual spoofing, not an expert. It works great against normal players and is best paired with online-mode=true. Treat it as one solid layer, not a silver bullet.
下载 HailWall
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HailWall
下载 HailWall
下载 HailWall
下载 HailWall
下载 HailWall
下载 HailWall
下载 HailWall
Alpha 版本
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧