JarsAuth

模组

· 作者 jissee1

一款 Minecraft 客户端管理模组,提供多种功能来管理客户端连接

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

最新 6.1 · 1.21.11 · Fabric

一键开服(送7天)

JarsAuth

描述由 ChatGPT 生成并经模组作者校对。 如有任何歧义,请以中文文本为准。

如需查看详细中文说明,请访问 客户端管理 (JarsAuth) - MC百科|最大的Minecraft中文MOD百科

如需发表评论,请前往 GitHub Discussion


重要通知

本模组已更新至 版本 6.0。 这是一次重大更新,配置不兼容 5.x 或更早版本。因此:

  • 必须重新生成服务器端配置
  • 客户端也必须更新模组,但无需进行客户端配置
  • 版本 5.x 存在导致 CPU 异常高占用的严重漏洞,不再推荐使用 此问题已在 6.0 中修复

配置系统变更

  • 所有配置已迁移至 SQLite 数据库

  • 不再生成零散的配置文件

  • 数据库架构在所有版本间保持一致,便于轻松迁移

  • 提供内置配置工具:

    • 入口:在服务器 GUI 底部新增的管理器按钮
    • 配置必须在支持 GUI 的环境中执行
    • 如果您的服务器没有 GUI:
      • 先在本地进行配置
      • 然后将数据库文件复制到服务器
    • 未来可能会添加远程配置支持
  • 模组 JAR 也可作为可执行 JAR 运行,自动使用工作目录中的数据库文件

  • 配置工具包含详细解释 → 将鼠标悬停在按钮上可查看工具提示


常规行为

  • 所有功能均为可选,默认禁用

    • 如果未更改任何配置,模组的行为等同于未安装
  • 功能仅在专用服务器上生效

    • 支持的环境:Forge、Fabric、Arclight、Mohist 等
    • 单人游戏和局域网世界不受影响
  • 所有消息均存储在**语言文件(*.json)**中

    • 如需修改,请解压 JAR,编辑后在发布前重新打包
  • 为确保玩家的知情权,每次玩家连接时,所有启用的功能将以系统消息的形式告知玩家。此消息为强制性的,无法禁用。

  • 由于开发资源有限:

    • 仅支持 Minecraft 1.20.1 及更高版本(稳定版)
    • 1.20.1 是最后一个 Forge 版本
    • 此后开发将转向 NeoForge
    • 可根据需求定制开发

功能 1 – 文件校验和

这是模组的原始功能。

使用场景

通常情况下,模组加载器仅检查客户端与服务器之间的必需模组是否匹配。 它们不会检测:

  • 仅客户端模组(如小地图、性能优化模组、作弊模组)
  • X-ray 或其他资源包

这严重影响游戏公平性。 传统的反制措施(如假矿石)可能会导致区块数据损坏或引发卡顿。

本模组的文件校验和功能可以:

  • 验证所有客户端文件(包括仅客户端模组)是否与整合包创建时使用的版本一致
  • 检测未经授权的仅客户端文件

示例:

  • 如果不允许小地图,安装了小地图模组的客户端将被拒绝连接

  • 如果要求小地图,缺少该模组的客户端也将被拒绝

  • 如果服务器更新了部分模组而客户端未更新:

    • 模组加载器的检查可能仍会通过
    • 版本不匹配可能导致服务器数据损坏 → 本模组可以通过禁用其验证通道来阻止过时的客户端

工作原理

  1. 模组扫描所有配置的文件并计算其哈希值

  2. 所有哈希值合并为一个唯一的客户端签名

  3. 当客户端连接时:

    • 服务器定期发送待验证的文件列表
    • 客户端计算并返回其签名
  4. 如果签名不在服务器的记录中,则拒绝连接


重要配置变更

  • 支持基于组的继承管理

  • 不同的客户端组可以有不同的验证规则

  • 过滤器支持:

    • 简单通配符
    • 正则表达式
  • 排除过滤器可以忽略不应检查的文件 (例如 .DS_Store、desktop.ini)


功能 2 – 客户端认证

此功能类似于登录系统。

使用场景

在离线模式服务器中,玩家身份仅基于用户名,使得冒充他人变得容易。

此功能添加了专用的认证机制,防止其他玩家使用相同的用户名登录。


工作原理

  • 当玩家加入时:

    • 服务器检查该用户名是否存在 ID(UUID)
  • 如果不存在:

    • 该玩家被视为首次登录
  • 如果存在:

    • 服务器向客户端请求该 ID
    • 如果客户端在限定时间内无法提供,则拒绝连接
  • 首次登录时:

    • 服务器生成绑定到用户名的 ID
    • 该 ID 发送给客户端并在服务器端存储
    • 随后断开客户端连接,必须重新连接以进行验证

功能 3 – 服务器许可证

此功能可作为防沉迷功能使用。

使用场景

服务器可能希望:

  • 限制玩家游戏时间
  • 要求明确的服务器所有者授权

此功能提供了一个细粒度的白名单系统,其中:

  • 服务器发放许可证

  • 只有持有有效许可证的玩家才能连接

  • 许可证包括:

    • 过期时间
    • 类型
    • 使用配额

工作原理

登录时,服务器检查玩家的许可证:

  • 无许可证
  • 许可证已过期
  • 许可证配额耗尽

→ 拒绝连接 在游戏过程中也会定期重新验证许可证。

此功能完全在服务器端运行,不需要客户端数据交换。

重要配置变更

  • 用户和规则支持分组继承
  • 移除了“基于连接数”的许可类型
  • 新增周期性许可证,可自动重置或清除配额

功能 4 – 签名与混淆(Beta)

注意: 此功能必须在 Minecraft 环境中使用。 直接运行 JAR 文件不支持此功能。

使用场景

服务器可能希望玩家仅使用服务器提供的整合包。

此功能允许:

  • 导出已签名的模组包以确保唯一性
  • 一键生成 ProGuard 混淆配置文件

重要通知

  • 模组发布页面仅提供未签名的包(“原始包”)
  • 已签名的包绝不会从公共网络资源分发
  • 服务器所有者必须决定是否使用已签名/混淆的版本

设置

自 6.0 版本起,严格的网络通道检查已被移除。 客户端和服务器可以独立运行,不会破坏游戏玩法。

服务器安装 客户端安装 结果
是 是 验证遵循配置
是 否 如果启用则验证始终失败;否则不验证
否 是 不验证
否 否 不验证

准备步骤

  1. 确定你的整合包并确保:

    • 所有模组和文件均已正确放置
    • 服务器和客户端能正常启动并连接
  2. 下载原始包

  3. 将其放入服务器和客户端的 mods 文件夹中

  4. 启动服务器

  5. 通过服务器 GUI 打开配置工具

  6. 在 Config 标签页中启用或禁用所需功能


签名(可选)

  • 在 Signing 标签页中:

    • 生成:

      • *-signed.jar(服务器端)
      • *-signed-expanded.jar(客户端)
    • 这两者必须完全匹配

  • 同时会生成一个 config.pro 文件

    • 导入 ProGuard 以生成:

      • *-signed-expanded-obj.jar
  • 混淆仅适用于客户端包

  • 替换:

    • 将服务器模组替换为服务器已签名 JAR
    • 将客户端模组替换为对应的已签名/混淆 JAR
  • 重启服务器


文件校验和工作流

  1. 启动客户端和服务器
  2. 在服务器上运行 /jarsauth record on (必须启用文件校验和)
  3. 客户端连接 → 记录文件 → 断开客户端连接
  4. 切换配置工具页面以刷新 UI
  5. 运行 /jarsauth record off
  6. 选择客户端组并配置过滤器 → 更改立即生效

客户端认证注意事项

  • 配置工具显示:

    • 服务器 ID
    • 所有记录的客户端 ID
  • 要撤销玩家权限:

    • 删除其 ID 条目
  • 客户端方面:

    • 在客户端根目录中创建一个数据库文件

    • 它存储所有用户名–ID 映射

    • 必须小心备份

      • 丢失 → 无法登录
      • 泄露 → 存在账号冒充风险
      • 多设备使用 → 复制该数据库文件

服务器许可注意事项

  • 在工具中配置组

  • 强制性的 default 组适用于所有用户

  • 玩家可能属于多个组

    • 组关系为OR(逻辑或)
    • 如果任何组还有剩余配额,则授予访问权限
  • 所有组的配额同时减少

    • 有效配额 = 各组中最高的可用值

配置重载通知

  • 不再支持配置重载
  • 启用/禁用功能需要重启服务器
  • 其他配置更改立即生效

模组作者的话

这部分内容已移至 GitHub。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源