Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

BungeePerms

github.com

  • Free plan
  • Open source
  • API
  • Self-hosted
7.4 Club score Visit github.com

What BungeePerms is

BungeePerms is a free, self-hosted permissions plugin for managing access across a Minecraft server network. It replaces the built-in permission systems of BungeeCord and Spigot, with support described for BungeeCord, Waterfall and Velocity proxies and for Spigot and Paper/PaperSpigot servers. Administrators can organize permissions into groups, use group inheritance and ladders, and assign timed access to permissions or groups, with promotion and demotion functions. Permissions can be restricted to particular servers and worlds. In-game tools support permission checks as well as user and group listings and management. Users and groups can also have prefixes, suffixes and display names. Storage options are MySQL and YAML; UUID support and regex permissions are optional. The project links to development builds and documents a Maven repository for BungeePerms 4. Its repository identifies the license as GPL-3.0, and it directs users to Discord for questions and a wiki for further information. Prefixes require a chat plugin that supports Vault; the project notes that Essentials Chat is supported.

Who it suits

BungeePerms suits administrators running a Minecraft network with supported proxy and server software who want to manage permissions centrally. It is self-hosted and requires a Vault-compatible chat plugin for prefixes.

Good to know, and what to watch

  • Manages permissions across supported proxy and server software.
  • Supports timed permissions and group membership.
  • Permissions can be scoped to servers and worlds.
  • Offers YAML and MySQL storage.
  • Licensed under GPL-3.0.
  • Prefixes require a chat plugin supporting Vault.
  • UUID and regex permission features are optional.
  • The project links to development builds.

BungeePerms

Free

Open source

Getting started

  1. Open the BungeePerms GitHub repository
  2. Choose a documented development build or Maven repository distribution
  3. Install it in a supported proxy and Minecraft server setup
  4. Configure YAML or MySQL storage
  5. Create groups, inheritance, and scoped permissions
  6. Use the in-game management and listing tools

Limits to check

The project is free and self-hosted. Prefix display requires a chat plugin supporting Vault, and UUID support and regex permissions are optional features.

The verdict

BungeePerms combines group, timed and server-scoped permissions for supported Minecraft networks, with both YAML and MySQL storage. Check the compatibility requirements for prefixes and the optional status of UUID and regex features before choosing it.

Questions people ask

What does BungeePerms cost?

The BungeePerms plan is listed as free. The project is open source and GPL-3.0 licensed.

Which proxy and server software are supported?

Proxy support includes BungeeCord, Waterfall, and Velocity. Server support includes Spigot and Paper/PaperSpigot.

Can permissions expire or be restricted?

Yes. It supports timed permissions and groups, promotion and demotion, and scopes permissions to specific servers and worlds.

Which storage systems are available?

BungeePerms lists YAML and MySQL storage backends.

How are prefixes displayed?

Users and groups can have prefixes, suffixes, and display names. Prefixes require a chat plugin that supports Vault; Essentials Chat is supported.

Where can users get help?

The README directs questions to the project's Discord server and provides a wiki for more information.

What the maker publishes

API availability
The project exposes a BungeePerms API artifact, while its issue tracker contains a report that the API is not thread safe. source
Centralized management
Administrators can manage permissions for all servers in a connected network from one system. source
Chat integration
Prefixes require a chat plugin supporting Vault; the listing specifically names Essentials Chat as supported. source
Compatibility detail
The SpigotMC listing says prefixes require a chat plugin that supports Vault, and that Essentials Chat is supported. source
Compatibility range
The Spigot listing identifies legacy as the native major version and lists tested Minecraft versions 1.12 through 1.16. source
Developer distribution
The README publishes a Maven repository and dependency coordinates for BungeePerms 4.0-dev-108. source
Display metadata
Users and groups can have prefixes, suffixes, and display names. source
Distribution
The README links to development builds and documents a Maven repository for BungeePerms 4. source
Distribution history
The Spigot resource lists 52,011 total downloads, an April 1, 2013 first release and an April 18, 2021 last update. source
Documentation depth
The GitHub wiki lists eight pages, including configuration, FAQ, groups, permission resolving, permissions.yml and command documentation. source
Documentation status
The wiki says it is still under construction and asks users to report missing or incorrect information. source
Groups
It supports permission groups, group inheritance, timed inheritance, and group ladders. source
Inheritance
Groups support inherited permissions and timed inheritances. source
License
The GitHub repository identifies the project as GPL-3.0 licensed. source
License
The repository is marked GPL-3.0 and includes a GPL license file. source
Limit: API thread safety
An open issue reports that BungeePermsAPI is not thread safe and needs rework. source
Limit: crashes
The issue tracker contains an open crash-on-connection report. source
Limit: download availability
Spigot forum users reported service-unavailable pages and broken download links for the plugin. source
Limit: maintenance concerns
A Spigot forum participant said development appeared to have stopped and that newer server versions became difficult to support. source
Limit: missing integrations
Open enhancement issues request RedisBungee support and an MSSQL database backend. source
Limit: permissions disruption
A reviewer reported that the plugin altered permissions and prevented BungeeCord-related commands from working. source
Limit: tab completion
A reviewer said the tab-completion setting did not properly hide Bungee plugin commands. source
Limit: version failures
A reviewer reported API errors and failure to load on BungeeCord 1.15. source
Limit: weak API support
A reviewer complained that API usage information was unavailable and Discord support was poor. source

Checked against the maker's pages on 15 Oct 2026.