ZZCompat

ZZCompat is the ecosystem bridge between ZZCore and external permission providers. It centralizes external groups, nodes, and known players inside a dedicated ZZ ecosystem UI.

What ZZCompat Does

• Binds an external permissions provider on top of ZZCore, with LuckPerms as the main target.
• Synchronizes external groups, namespaces, and catalogs detected in loaded plugins and jars.
• Exposes a visual dashboard for groups, players, sections, permissions, and audit information.
• Caches groups, permissions, and known-player data with configurable refresh behavior.
• Lets staff enable or disable nodes and group membership from the UI.

Commands And Workflow

• /permissionsbridge is the detected command surface for the module.
• In practice, the main flow is UI-first from the ZZCore hub.
• Reloading the module rebinds the provider, rescans namespaces, and clears caches.

Runtime Files And Data

• config.json stores the active provider, cache behavior, refresh interval, and persisted external catalogs.
• externalCatalogs lives inside config.json and is filled with discovered namespaces and prefixes.
• Group, permission, and known-player caches are runtime-managed.

Visible Config Example

This is the kind of config.json file you will see when the module generates its settings:

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

The section below explains what each line changes in normal language.

Configuration Reference

Main Settings In config.json

• version (number): internal config schema version.
• provider (text): active provider mode. The current code accepts auto, luckperms, or none.
• cache (true/false): enables runtime caching for groups, permissions, and player lookups.
• refreshIntervalSeconds (number): refresh interval used by the bridge cache.
• externalCatalogs (list of entries): persisted external namespace catalogs discovered or curated by the bridge.

External Catalog Entry Shape

• id (text): stable catalog id.
• name (text): display name for that external catalog.
• prefixes (list): permission prefixes associated with the catalog.
• permissions (list): explicit permission nodes associated with the catalog.

Permissions

• permissionsbridge.use
• permissionsbridge.admin

Installation

1. Copy ZZCore.jar into the server mods folder first.
2. Copy ZZPermissionsBridge.jar into the same server mods folder after that.
3. If you want an external provider, make sure that provider is also installed and loaded, for example LuckPerms.
4. Start Hytale.
5. Open the ecosystem hub and verify that the provider binds correctly.

License

All Rights Reserved.

Redistribution, reposting, resale edits, or reuploading forks is not allowed without written permission from the author.