ThunderPerms
hangar.papermc.io
- Free plan
- Self-hosted
What ThunderPerms is
ThunderPerms is a free permissions plugin for self-hosted Paper servers. It manages UUID-based player permissions, groups, memberships, true and false nodes, wildcard nodes, and permissions scoped to worlds. Groups can inherit permissions, with cycle prevention and weights to set priority. Temporary permissions, group permissions, and memberships expire automatically, and expired entries are cleaned up. YAML is the default storage backend; SQLite, MySQL, and MariaDB are also supported. Administrators can check and explain permissions, verify or repair data, review status, and create backups. Audit logs record permission, group, repair, and backup actions. The plugin registers an API for permission checks and explanations, user and group inspection, assignments, known groups, and storage health. The listing describes safeguards such as protected default and built-in admin groups, path protections, redacted database credentials, and safer default TLS settings for MySQL and MariaDB. Direct permission bridge support is listed for StormEconomy, StormParty, and StormFactions. ThunderPerms is licensed under Apache 2.0; the version page lists Paper and Minecraft version 26.1.2.
Who it suits
ThunderPerms suits administrators of small and medium Paper servers, plugin suites, and local development servers who need configurable permission management and storage options.
Good to know, and what to watch
- Supports four storage backends
- Provides group inheritance with cycle prevention
- Automatically cleans expired temporary entries
- Includes audit logs and backup commands
- Designed for Paper servers
- The version page lists compatibility with Minecraft version 26.1.2
The verdict
ThunderPerms combines permission management, storage choices, and administrative diagnostics for Paper servers. Its listed compatibility is specific to Paper and Minecraft version 26.1.2.
What the maker publishes
- Admin safeguards
- The default group and built-in admin group are protected from deletion, and operators can bypass API checks when op-bypass is enabled. source
- API
- ThunderPerms registers an API for permission checks, detailed permission reasons, user and group inspection, assignments, known groups, and storage health. source
- Auditing
- The plugin writes audit logs for permission, group, repair, and backup actions. source
- Backups and audits
- ThunderPerms can back up YAML and database-backed storage and logs permission, group, repair, and backup actions. source
- Compatibility
- The version page lists Paper as the platform and Minecraft version 26.1.2. source
- Diagnostics
- Commands include permission checks and explanations, data verification, repair, status reporting, and backups. source
- Inheritance
- Groups support inheritance with cycle prevention and weights to control priority between inherited permissions. source
- Integrations
- ThunderPerms applies Bukkit PermissionAttachment entries for standard permission checks and supports the AugmentedThunder plugin suite, StormEconomy, StormParty, and StormFactions. source
- Intended users
- The listing describes ThunderPerms as designed for small and medium Paper servers, plugin suites, and local development servers. source
- License
- The Hangar listing identifies the license as Apache 2.0. source
- Permission management
- It supports UUID-based player permissions, permission groups, group memberships, true and false nodes, and wildcard nodes. source
- Plugin integrations
- StormEconomy, StormParty, and StormFactions include direct ThunderPerms permission bridge support; AugmentedThunder plugins can use its permission nodes and fall back when it is absent. source
- Purpose
- ThunderPerms is a lightweight permissions plugin for Paper servers that manages users, groups, inheritance, wildcard permissions, temporary and world-scoped grants, backups, audits, and storage diagnostics. source
- Release
- Version 0.1.1 adds effective-permission inspection, attachment refresh, cleanup and audit commands, and makes repair and group deletion preview-first. source
- Security
- The listing says configured file paths are protected from directory traversal and database credentials are redacted, with safer default TLS settings for MySQL and MariaDB. source
- Storage
- YAML is the default storage backend, with optional SQLite, MySQL, and MariaDB support. source
- Temporary and scoped grants
- Users and groups can receive temporary permissions or memberships, and permission grants can be scoped to a world. source
- Temporary grants
- Users can receive temporary permissions, group permissions, and group memberships, with expired entries cleaned automatically. source
Checked against the maker's pages on 3 Oct 2026.