Skip to content
SPECIFICTION
Get listed

ThunderPerms

hangar.papermc.io

Self-hosted
Visit hangar.papermc.io
Spec score 6.4 #9 of 12 in Minecraft Permissions Plugins

What it is

ThunderPerms is a free permissions plugin for self-hosted Paper servers. It manages UUID-based player permissions, groups, memberships, inheritance, true and false nodes, wildcard nodes, temporary grants, and world-scoped permissions. Group inheritance includes cycle prevention and weights for priority. Expired temporary permissions and memberships are removed automatically. YAML is the default storage backend, with optional SQLite, MySQL, and MariaDB support. Administrators can check and explain permissions, verify or repair data, inspect status, and create backups. Audit logs record permission, group, repair, and backup actions. The API supports permission checks, detailed reasons, user and group inspection, assignments, known groups, and storage health. Safeguards include protected default and built-in administrator groups, path protections against directory traversal, credential redaction, and safer default TLS settings for MySQL and MariaDB. Integrations include the AugmentedThunder suite, StormEconomy, StormParty, and StormFactions. The listed license is Apache 2.0, with Paper and Minecraft version 26.1.2 specified.

Spec sheet

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.Read 3 Oct 2026 · hangar.papermc.io
Intended users
The listing describes ThunderPerms as designed for small and medium Paper servers, plugin suites, and local development servers.Read 3 Oct 2026 · hangar.papermc.io
API
ThunderPerms registers an API for permission checks, detailed permission reasons, user and group inspection, assignments, known groups, and storage health.Read 3 Oct 2026 · hangar.papermc.io
Integrations
ThunderPerms applies Bukkit PermissionAttachment entries for standard permission checks and supports the AugmentedThunder plugin suite, StormEconomy, StormParty, and StormFactions.Read 3 Oct 2026 · hangar.papermc.io
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.Read 3 Oct 2026 · hangar.papermc.io
License
The Hangar listing identifies the license as Apache 2.0.Read 3 Oct 2026 · hangar.papermc.io
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.Read 3 Oct 2026 · hangar.papermc.io
Auditing
The plugin writes audit logs for permission, group, repair, and backup actions.Read 3 Oct 2026 · hangar.papermc.io
Backups and audits
ThunderPerms can back up YAML and database-backed storage and logs permission, group, repair, and backup actions.Read 3 Oct 2026 · hangar.papermc.io
Compatibility
The version page lists Paper as the platform and Minecraft version 26.1.2.Read 3 Oct 2026 · hangar.papermc.io
Diagnostics
Commands include permission checks and explanations, data verification, repair, status reporting, and backups.Read 3 Oct 2026 · hangar.papermc.io
Inheritance
Groups support inheritance with cycle prevention and weights to control priority between inherited permissions.Read 3 Oct 2026 · hangar.papermc.io
Permission management
It supports UUID-based player permissions, permission groups, group memberships, true and false nodes, and wildcard nodes.Read 3 Oct 2026 · hangar.papermc.io
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.Read 3 Oct 2026 · hangar.papermc.io
Release
Version 0.1.1 adds effective-permission inspection, attachment refresh, cleanup and audit commands, and makes repair and group deletion preview-first.Read 3 Oct 2026 · hangar.papermc.io
Storage
YAML is the default storage backend, with optional SQLite, MySQL, and MariaDB support.Read 3 Oct 2026 · hangar.papermc.io
Temporary and scoped grants
Users and groups can receive temporary permissions or memberships, and permission grants can be scoped to a world.Read 3 Oct 2026 · hangar.papermc.io
Temporary grants
Users can receive temporary permissions, group permissions, and group memberships, with expired entries cleaned automatically.Read 3 Oct 2026 · hangar.papermc.io

Strong points and limits

Strong points

  • Supports groups, inheritance, wildcards, and temporary grants
  • Offers YAML, SQLite, MySQL, and MariaDB storage
  • Includes verification, repair, status, and backup commands
  • Provides an inspection and health API
  • Free Apache 2.0 plugin

Limits

  • Supports Paper servers rather than general platforms
  • Self-hosted deployment is required
  • Version compatibility lists Minecraft 26.1.2

Who it suits

It is designed for small and medium Paper servers, plugin suites, and local development servers. Administrators needing configurable permissions, storage choices, diagnostics, and audit records are the intended users.

Verdict

ThunderPerms provides a detailed permissions system with multiple storage backends, diagnostics, safeguards, and integrations. Its stated scope is focused on Paper server administration and development.

Where Specifiction places it

Alternatives to ThunderPermsAll alternatives →