CannaTalePermissions

CannaTalePermissions

CannaTalePermissions is a full permissions + chat formatting solution for Hytale Servers, built to be fast, clean, and admin-friendly. It plugs directly into Hytale's PermissionsModule as a provider, so other mods can rely on one consistent permission system.

Highlights

• SQLite backend (WAL enabled) - no giant JSON files, no "config spam", and edits stay safe + consistent.
• True allow/deny permissions - nodes can be explicitly allowed or denied (deny wins where applicable).
• Wildcard support - checks fall back like: a.b.c. → a.b.* → a.* → *.
• Groups done right
  • Weights (used to determine a player's primary group)
  • Default group support
  • Parent inheritance (groups can inherit permissions/meta from other groups)
  • Direct group permissions + direct user permissions
• Chat formatting (enabled by default)
  • Global format + optional per-primary-group format overrides
  • Placeholders: {GROUP}, {PREFIX}, {SUFFIX}, {USERNAME}, {MESSAGE}
  • Supports Hytale-style color tags (ex: <GREEN>, <RED>, <#FFFFFF>, etc.)
• In-game Editor UI
  • Open a full permissions editor page with /ctperm editor
  • Manage groups/users, weights/default group, parents, members, permissions, prefix/suffix meta, and group chat format overrides in one place

Storage / Files

Created in the plugin data folder:

• ctperm-config.json - config db filename, default group, chat formatting settings)
• ctperm.db - SQLite database (users, groups, memberships, parents, permissions, meta)

Important behavior notes

• Offline editing is supported only after a player has joined at least once.
  • If there's no UUID stored yet, commands fail immediately (no "pending users" are created).

Commands

Main command: /ctperm (alias: /ctp)

Users

• user info <userOrUuid>
• user permset <userOrUuid> <node> [--value=True/False]
• user permunset <userOrUuid> <node>
• user groupadd <userOrUuid> <group>
• user groupremove <userOrUuid> <group>
• user prefixset <userOrUuid> <priority> <text>
• user prefixremove <userOrUuid> <priority>
• user suffixset <userOrUuid> <priority> <text>
• user suffixremove <userOrUuid> <priority>

Groups

• group create <group> [--weight=]
• group delete <group>
• group rename <oldname> <newname>
• group list
• group info <group>
• group permset <group> <node> [--value=True/False]
• group permunset <group> <node>
• group parentadd <group> <parent>
• group parentremove <group> <parent>
• group weightset <group> <weight>
• group defaultset <group>
• group prefixset <group> <priority> <text>
• group prefixremove <group> <priority>
• group suffixset <group> <priority> <text>
• group suffixremove <group> <priority>

Other

• editor
• test <userOrUuid> <node>
• reload

Permission nodes (admin access control)

• cannatalepermissions.command.base
• cannatalepermissions.command.reload
• cannatalepermissions.command.test
• cannatalepermissions.editor
• cannatalepermissions.user.info
• cannatalepermissions.user.perm
• cannatalepermissions.user.group
• cannatalepermissions.user.meta
• cannatalepermissions.group.create
• cannatalepermissions.group.delete
• cannatalepermissions.group.rename
• cannatalepermissions.group.list
• cannatalepermissions.group.info
• cannatalepermissions.group.perm
• cannatalepermissions.group.parent
• cannatalepermissions.group.weight
• cannatalepermissions.group.default
• cannatalepermissions.group.meta