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 或其他资源包
这严重影响游戏公平性。 传统的反制措施(如假矿石)可能会导致区块数据损坏或引发卡顿。
本模组的文件校验和功能可以:
- 验证所有客户端文件(包括仅客户端模组)是否与整合包创建时使用的版本一致
- 检测未经授权的仅客户端文件
示例:
-
如果不允许小地图,安装了小地图模组的客户端将被拒绝连接
-
如果要求小地图,缺少该模组的客户端也将被拒绝
-
如果服务器更新了部分模组而客户端未更新:
- 模组加载器的检查可能仍会通过
- 版本不匹配可能导致服务器数据损坏 → 本模组可以通过禁用其验证通道来阻止过时的客户端
工作原理
-
模组扫描所有配置的文件并计算其哈希值
-
所有哈希值合并为一个唯一的客户端签名
-
当客户端连接时:
- 服务器定期发送待验证的文件列表
- 客户端计算并返回其签名
-
如果签名不在服务器的记录中,则拒绝连接
重要配置变更
-
支持基于组的继承管理
-
不同的客户端组可以有不同的验证规则
-
过滤器支持:
- 简单通配符
- 正则表达式
-
排除过滤器可以忽略不应检查的文件 (例如
.DS_Store、desktop.ini)
功能 2 – 客户端认证
此功能类似于登录系统。
使用场景
在离线模式服务器中,玩家身份仅基于用户名,使得冒充他人变得容易。
此功能添加了专用的认证机制,防止其他玩家使用相同的用户名登录。
工作原理
-
当玩家加入时:
- 服务器检查该用户名是否存在 ID(UUID)
-
如果不存在:
- 该玩家被视为首次登录
-
如果存在:
- 服务器向客户端请求该 ID
- 如果客户端在限定时间内无法提供,则拒绝连接
-
首次登录时:
- 服务器生成绑定到用户名的 ID
- 该 ID 发送给客户端并在服务器端存储
- 随后断开客户端连接,必须重新连接以进行验证
功能 3 – 服务器许可证
此功能可作为防沉迷功能使用。
使用场景
服务器可能希望:
- 限制玩家游戏时间
- 要求明确的服务器所有者授权
此功能提供了一个细粒度的白名单系统,其中:
-
服务器发放许可证
-
只有持有有效许可证的玩家才能连接
-
许可证包括:
- 过期时间
- 类型
- 使用配额
工作原理
登录时,服务器检查玩家的许可证:
- 无许可证
- 许可证已过期
- 许可证配额耗尽
→ 拒绝连接 在游戏过程中也会定期重新验证许可证。
此功能完全在服务器端运行,不需要客户端数据交换。
重要配置变更
- 用户和规则支持分组继承
- 移除了“基于连接数”的许可类型
- 新增周期性许可证,可自动重置或清除配额
功能 4 – 签名与混淆(Beta)
注意: 此功能必须在 Minecraft 环境中使用。 直接运行 JAR 文件不支持此功能。
使用场景
服务器可能希望玩家仅使用服务器提供的整合包。
此功能允许:
- 导出已签名的模组包以确保唯一性
- 一键生成 ProGuard 混淆配置文件
重要通知
- 模组发布页面仅提供未签名的包(“原始包”)
- 已签名的包绝不会从公共网络资源分发
- 服务器所有者必须决定是否使用已签名/混淆的版本
设置
自 6.0 版本起,严格的网络通道检查已被移除。 客户端和服务器可以独立运行,不会破坏游戏玩法。
| 服务器安装 | 客户端安装 | 结果 |
|---|---|---|
| 是 | 是 | 验证遵循配置 |
| 是 | 否 | 如果启用则验证始终失败;否则不验证 |
| 否 | 是 | 不验证 |
| 否 | 否 | 不验证 |
准备步骤
-
确定你的整合包并确保:
- 所有模组和文件均已正确放置
- 服务器和客户端能正常启动并连接
-
下载原始包
-
将其放入服务器和客户端的
mods文件夹中 -
启动服务器
-
通过服务器 GUI 打开配置工具
-
在 Config 标签页中启用或禁用所需功能
签名(可选)
-
在 Signing 标签页中:
-
生成:
*-signed.jar(服务器端)*-signed-expanded.jar(客户端)
-
这两者必须完全匹配
-
-
同时会生成一个
config.pro文件-
导入 ProGuard 以生成:
*-signed-expanded-obj.jar
-
-
混淆仅适用于客户端包
-
替换:
- 将服务器模组替换为服务器已签名 JAR
- 将客户端模组替换为对应的已签名/混淆 JAR
-
重启服务器
文件校验和工作流
- 启动客户端和服务器
- 在服务器上运行
/jarsauth record on(必须启用文件校验和) - 客户端连接 → 记录文件 → 断开客户端连接
- 切换配置工具页面以刷新 UI
- 运行
/jarsauth record off - 选择客户端组并配置过滤器 → 更改立即生效
客户端认证注意事项
-
配置工具显示:
- 服务器 ID
- 所有记录的客户端 ID
-
要撤销玩家权限:
- 删除其 ID 条目
-
客户端方面:
-
在客户端根目录中创建一个数据库文件
-
它存储所有用户名–ID 映射
-
必须小心备份
- 丢失 → 无法登录
- 泄露 → 存在账号冒充风险
- 多设备使用 → 复制该数据库文件
-
服务器许可注意事项
-
在工具中配置组
-
强制性的
default组适用于所有用户 -
玩家可能属于多个组
- 组关系为OR(逻辑或)
- 如果任何组还有剩余配额,则授予访问权限
-
所有组的配额同时减少
- 有效配额 = 各组中最高的可用值
配置重载通知
- 不再支持配置重载
- 启用/禁用功能需要重启服务器
- 其他配置更改立即生效
模组作者的话
这部分内容已移至 GitHub。
JarsAuth
The description is generated by ChatGPT and proofread by the mod author.
In case of any ambiguity, please refer to Chinese texts.
For detailed Chinese description, please go to 客户端管理 (JarsAuth) - MC百科|最大的Minecraft中文MOD百科
If you want to leave a comment, please go to GitHub Discussion
Important Notice
The mod has been updated to version 6.0. This is a major update, and configurations are NOT compatible with 5.x or earlier versions. Therefore:
- Server-side configurations must be regenerated
- Clients must also update the mod, but no client-side configuration is required
- Version 5.x contains a critical bug that causes abnormally high CPU usage and is no longer recommended This issue has been fixed in 6.0
Configuration System Changes
-
All configurations have been migrated to an SQLite database
-
No scattered config files will be generated anymore
-
The database schema is identical across all versions, allowing easy migration
-
A built-in configuration tool is provided:
- Entry point: a new Manager button at the bottom of the server GUI
- Configuration must be performed in a GUI-capable environment
- If your server has no GUI:
- Configure locally first
- Then copy the database file to the server
- Remote configuration support may be added in the future
-
The mod JAR can also be run as an executable JAR, automatically using the database file in the working directory
-
The configuration tool includes detailed explanations → Hover over buttons to view tooltips
General Behavior
-
All features are optional and disabled by default
- If no configuration changes are made, the mod behaves as if it were not installed
-
Features only take effect on dedicated servers
- Supported environments: Forge, Fabric, Arclight, Mohist, etc.
- Singleplayer and LAN worlds are not affected
-
All messages are stored in language files (
*.json)- If you need to modify them, unpack the JAR, edit, then repackage before release
-
To ensure players’ right to be informed, all enabled features will be communicated to players in the form of system messages each time they connect. This message is mandatory and cannot be disabled.
-
Due to limited development resources:
- Only Minecraft 1.20.1 and later (stable releases) are supported
- 1.20.1 is the final Forge version
- Development will move to NeoForge afterward
- Custom development is available upon request
Feature 1 – File Checksum
This is the original feature of the mod.
Use Cases
Normally, mod loaders only check whether required mods match between client and server. They do not detect:
- Client-only mods (e.g. minimaps, performance mods, cheat mods)
- X-ray or other resource packs
This severely impacts game fairness. Traditional countermeasures (e.g. fake ores) may corrupt chunk data or cause lag.
This mod’s File Checksum feature can:
- Verify that all client-side files, including client-only mods, match the versions used when the modpack was created
- Detect unauthorized client-only files
Examples:
-
If minimaps are not allowed, clients with a minimap mod will be denied connection
-
If minimaps are required, clients missing it will also be denied
-
If the server updates some mods but clients do not:
- Mod loader checks may still pass
- Version mismatch can corrupt server data → This mod can block outdated clients by disabling their validation channel
How It Works
-
The mod scans all configured files and computes their hash values
-
All hashes are merged into a single client signature
-
When a client connects:
- The server periodically sends a list of files to verify
- The client computes and returns its signature
-
If the signature is not in the server’s record, the connection is rejected
Important Configuration Changes
-
Supports group-based management with inheritance
-
Different client groups can have different validation rules
-
Filters support:
- Simple wildcards
- Regular expressions
-
Exclusion filters can ignore files that should not be checked (e.g.
.DS_Store,desktop.ini)
Feature 2 – Client Authentication
This feature functions similarly to a login system.
Use Cases
In offline-mode servers, player identity is based solely on usernames, making impersonation easy.
This feature adds a dedicated authentication mechanism, preventing other players from logging in using the same username.
How It Works
-
When a player joins:
- The server checks if an ID (UUID) exists for that username
-
If none exists:
- The player is treated as a first-time login
-
If one exists:
- The server requests the ID from the client
- If the client cannot provide it within a time limit, the connection is rejected
-
On first login:
- The server generates an ID bound to the username
- The ID is sent to the client and stored server-side
- The client is then disconnected and must reconnect for verification
Feature 3 – Server License
This feature can be used as an anti-addiction feature.
Use Cases
Servers may want to:
- Limit player playtime
- Require explicit server owner authorization
This feature provides a fine-grained whitelist system where:
-
The server issues licenses
-
Only players with valid licenses may connect
-
Licenses include:
- Expiration time
- Type
- Usage quota
How It Works
On login, the server checks the player’s license:
- No license
- License expired
- License quota exhausted
→ Connection is denied Licenses are also revalidated periodically during gameplay.
This feature is entirely server-side and does not require client data exchange.
Important Configuration Changes
- Users and rules support grouping with inheritance
- Removed “connection-count–based” license type
- Added periodic licenses that automatically reset or clear quotas
Feature 4 – Signing & Obfuscation (Beta)
Note: This feature must be used inside a Minecraft environment. Running the JAR directly does not support it.
Use Cases
Servers may want players to use only the modpack provided by the server.
This feature allows:
- Exporting signed mod packages to ensure uniqueness
- One-click generation of ProGuard obfuscation configs
Important Notice
- The mod release page only provides unsigned packages (“original packages”)
- Signed packages are never distributed from public web resource
- Server owners must decide whether to use signed/obfuscated versions
Setup
Starting from 6.0, strict network channel checks have been removed. Client and server can run independently without breaking gameplay.
| Server Installed | Client Installed | Result |
|---|---|---|
| Yes | Yes | Validation follows configuration |
| Yes | No | Validation always fails if enabled; otherwise no validation |
| No | Yes | No validation |
| No | No | No validation |
Preparation Steps
-
Finalize your modpack and ensure:
- All mods and files are correctly placed
- Server and client can start and connect normally
-
Download the original package
-
Place it in both server and client
modsfolders -
Start the server
-
Open the configuration tool via server GUI
-
Enable or disable required features in the Config tab
Signing (Optional)
-
In the Signing tab:
-
Generate:
*-signed.jar(server)*-signed-expanded.jar(client)
-
These must match exactly
-
-
A
config.profile is also generated-
Import into ProGuard to generate:
*-signed-expanded-obj.jar
-
-
Obfuscation applies only to client packages
-
Replace:
- Server mod with server signed JAR
- Client mod with corresponding signed/obfuscated JAR
-
Restart the server
File Checksum Workflow
- Start client and server
- Run
/jarsauth record onon the server (File Checksum must be enabled) - Client connects → files are recorded → client is disconnected
- Switch config tool pages to refresh UI
- Run
/jarsauth record off - Select client groups and configure filters → Changes apply immediately
Client Authentication Notes
-
Config tool shows:
- Server ID
- All recorded client IDs
-
To revoke a player:
- Delete their ID entry
-
Client-side:
-
A database file is created in the client root directory
-
It stores all username–ID mappings
-
Must be backed up carefully
- Loss → cannot log in
- Leak → account impersonation risk
- Multi-device use → copy the database file
-
Server License Notes
-
Configure groups in the tool
-
A mandatory
defaultgroup applies to all users -
Players may belong to multiple groups
- Group relationship is OR
- If any group has remaining allowance, access is granted
-
All group allowance decrease simultaneously
- Effective allowance = highest available among groups
Configuration Reload Notice
- Configuration reload is no longer supported
- Enabling/disabling features requires a server restart
- Other configuration changes take effect immediately
Mod Author's Words
This part has been moved to GitHub.
下载 JarsAuth
下载 JarsAuth
下载 JarsAuth
下载 JarsAuth
下载 JarsAuth
下载 JarsAuth
下载 JarsAuth
下载 JarsAuth
下载 JarsAuth
下载 JarsAuth
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧