ZZCompat.jar

ZZCompat.jar

ZZCompat是ZZCore与外部权限提供者之间的生态系统桥梁。它在专用的ZZ生态系统界面中集中管理外部群组、节点和已知玩家。

实用

ZZCompat.jar预览查看大图

ZZCompat

ZZCompat 是 ZZCore 与外部权限提供者之间的生态桥梁。它在专有的 ZZ 生态系统界面中集中管理外部用户组、权限节点和已知玩家。

ZZCompat 的功能

  • 在 ZZCore 之上绑定外部权限提供者，主要目标是 LuckPerms。
  • 同步在已加载插件和 jar 文件中检测到的外部用户组、命名空间和目录。
  • 为用户组、玩家、分区、权限和审计信息提供可视化仪表盘。
  • 缓存用户组、权限和已知玩家数据，并支持可配置的刷新行为。
  • 允许工作人员通过界面启用或禁用权限节点和用户组成员资格。

命令与工作流程

  • /permissionsbridge 是该模块被检测到的命令入口。
  • 实际上，主要流程是从 ZZCore 中心开始的界面优先模式。
  • 重新加载模块会重新绑定提供者、重新扫描命名空间并清除缓存。

运行时文件与数据

  • config.json 存储活动的提供者、缓存行为、刷新间隔以及持久化的外部目录。
  • externalCatalogs 位于 config.json 内部，用于填充发现到的命名空间和前缀。
  • 用户组、权限和已知玩家缓存由运行时管理。

可见配置示例

这是模块生成设置时你可能会看到的 config.json 文件类型：

{
  "version": 1,
  "provider": "auto",
  "cache": true,
  "refreshIntervalSeconds": 30,
  "externalCatalogs": []
}

以下部分将用通俗语言解释每一行的含义。

配置参考

config.json 中的主要设置

  • version（数字）：内部配置架构版本。
  • provider（文本）：活动的提供者模式。当前代码接受 auto、luckperms 或 none。
  • cache（true/false）：启用用户组、权限和玩家查询的运行时缓存。
  • refreshIntervalSeconds（数字）：桥梁缓存使用的刷新间隔。
  • externalCatalogs（条目列表）：由桥梁发现或整理的持久化外部命名空间目录。

外部目录条目结构

  • id（文本）：稳定的目录 ID。
  • name（文本）：该外部目录的显示名称。
  • prefixes（列表）：与该目录关联的权限前缀。
  • permissions（列表）：与该目录关联的显式权限节点。

权限

  • permissionsbridge.use
  • permissionsbridge.admin

安装

  1. 先将 ZZCore.jar 复制到服务器的 mods 文件夹中。
  2. 之后将 ZZPermissionsBridge.jar 复制到同一个服务器的 mods 文件夹中。
  3. 如果你需要外部提供者，请确保该提供者也已安装并加载，例如 LuckPerms。
  4. 启动 Hytale。
  5. 打开生态系统中心并验证提供者是否正确绑定。

许可证

保留所有权利。

未经作者书面许可，禁止再分发、转发、转售修改或重新上传分支版本。