NetherPerms is a modern permissions plugin for PocketMine-MP. It lets server admins control what features players can use by creating groups and assigning permissions.
It is:
- Fast — written with performance and scalability in mind.
- Easy to use — set up permissions using commands, directly in config files, or using the in-game editor.
- Extensive — a rich set of customization options and settings to suit your server.
- Free — available at no cost, permissively licensed so it can remain free forever.
NetherPerms can store data in two ways: "SQLite" and "YAML". You can change this in the storage setting of config.yml.
The default option is SQLite.
| Backend | Pros | Cons |
|---|---|---|
| SQLite (single DB file) | Fast and robust; WAL journaling; fewer files to manage; good durability | Not as friendly for hand-editing; requires SQLite3 extension (bundled with PMMP builds) |
| YAML (per-entity files) | Human-readable; easy to edit; simple to version with Git | Many small files; slower I/O on some hosts; filesystem-bound concurrency |
A full list with examples and permissions is in COMMAND_USAGE.md.
Highlights:
- Groups: create/delete/rename/clone, permissions, parents, weights, meta, list members, show tracks.
- Users: show info, parents (add/set/remove/switchprimarygroup), permissions, meta, primary group (show/set/unset), temporary permissions.
- Tracks:
- Legacy syntax:
/np track set <track> <g1> <g2> ...and/np track show <track>. - Preferred syntax:
/np track <track> info|set|rename|clone|insert|remove|append .... - Promote/demote along a track:
/np promote <player> <track>,/np demote <player> <track>.
- Legacy syntax:
A context is a set of conditions where a permission or parent applies:
- Supported keys:
world,gamemode. - Format:
key=valuepairs separated by commas, e.g.world=world,gamemode=survival.
If no context is provided, the change applies globally.
- Wildcards: Nodes ending with
.*expand to all registered permissions with that prefix (PMMP registry), without overriding explicitly set nodes. - Temporary permissions: Grant user permissions that expire after a duration (e.g.,
10m,1h30m,2d3h).
- Place the plugin into your
plugins/directory. - Configure groups, users, and tracks via commands.
- Group deletion doesn’t remove the YAML file:
- Ensure you run a command that saves data (most management commands do), or restart/reload; the per-entity saver removes stale files.
- Promote/Demote says “Track not found”:
- Verify the track exists and contains at least two ordered groups.
- Permission isn’t applying:
- Check priority and meta, and whether contexts limit the scope (world/gamemode).