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