PurePerms is an advanced permission and role management system for PMMPCore Framework that brings full group-based permission control to Minecraft Bedrock. Create groups, assign users, manage permissions, and control access with inheritance and per-world scope.


What Does This Plugin Do?
PurePerms provides the backbone permission system for PMMPCore Framework, serving as the central permission backend that all other plugins use for access control. It supports hierarchical groups with inheritance, per-user and per-group permissions, per-world permission scoping, and automatic native OP synchronization.
⚠️ Requirements
| Requirement |
Status |
Details |
| ❌ PMMPCore Framework |
Required |
This plugin cannot work without PMMPCore Framework installed. |
| ✅ Server Owner |
Recommended |
Essential for managing permissions across your server. |
Key Features
- ✅ Group Management: Create, remove, and manage permission groups with aliases.
- ✅ Group Inheritance: Groups can inherit permissions from parent groups.
- ✅ User Management: Assign players to groups with per-world overrides.
- ✅ Granular Permissions: Set individual permissions for users and groups.
- ✅ Per-World Permissions: Different permissions in different worlds/dimensions.
- ✅ Permission Negation: Use
- prefix to explicitly deny permissions.
- ✅ Native OP Sync: Automatically syncs native Minecraft OP status with PurePerms groups.
- ✅ PlaceholderAPI Integration: Expansions for displaying rank, prefix, and suffix in chat/scoreboards.
- ✅ Permission Search: Find permissions by prefix across all groups and users.
- ✅ Noeul Authentication: Optional Noeul 64-based account registration and login system.
🛠️ Available Commands
| Command |
Syntax |
Description |
| ppinfo |
/ppinfo |
Show PurePerms system information |
| groups |
/groups |
List all permission groups |
| usrinfo |
/usrinfo <player> [world] |
Show user information and permissions |
| grpinfo |
/grpinfo <group> [world] |
Show group information and permissions |
| setgroup |
/setgroup <player> <group> [world] |
Assign a player to a group |
| addgroup |
/addgroup <group> |
Create a new permission group |
| rmgroup |
/rmgroup <group> |
Remove a permission group |
| defgroup |
/defgroup <group> [world] |
Set the default group for new players |
| setgperm |
/setgperm <group> <permission> [world] |
Add permission to a group |
| unsetgperm |
/unsetgperm <group> <permission> [world] |
Remove permission from a group |
| setuperm |
/setuperm <player> <permission> [world] |
Add permission to a user |
| unsetuperm |
/unsetuperm <player> <permission> [world] |
Remove permission from a user |
| listgperms |
/listgperms <group> <page> [world] |
List group permissions (paginated) |
| listuperms |
/listuperms <player> <page> [world] |
List user permissions (paginated) |
| addparent |
/addparent <group> <parent> |
Add inheritance parent to a group |
| rmparent |
/rmparent <group> <parent> |
Remove inheritance parent from a group |
| fperms |
/fperms <prefix> |
Find permissions matching a prefix |
| ppreload |
/ppreload |
Reload PurePerms configuration |
| ppsudo |
/ppsudo <login|register> <password> |
Noeul authentication account management |
Example Usage
# Show system info
/ppinfo
# Create a new group
/addgroup VIP
# Assign player to group
/setgroup Steve VIP
# Add permission to group
/setgperm VIP economy.command.pay
# Check user info
/usrinfo Steve
# List group permissions
/listgperms Admin 1
Default Groups
PurePerms comes with pre-configured groups out of the box:
| Group |
Inherits |
Default |
Description |
| Guest |
None |
Yes |
Default group for all new players |
| Mod |
Guest |
No |
Moderator with info commands |
| Admin |
Mod |
No |
Administrator with user/group management |
| OP |
Admin |
No |
Super admin with all permissions (*) |
Configuration Options
const PUREPERMS_CONFIG = {
dataProvider: "dynamic-properties",
defaultLanguage: "en",
disableOp: false,
enableMultiworldPerms: false,
enableNoeulSixtyfour: false,
noeulMinimumPwLength: 6,
superadminRanks: ["OP"]
};
PlaceholderAPI Integration
| Placeholder |
Description |
%pureperms_rank% |
Player's effective rank/group |
%pureperms_prefix% |
Player's prefix |
%pureperms_suffix% |
Player's suffix |
%pureperms_group% |
Player's primary group |
%pureperms_groups% |
All groups the player belongs to |
Integration with Other Plugins
PurePerms serves as the central permission backend for the entire PMMPCore ecosystem:
- All PMMPCore Plugins: Every plugin uses PurePerms for command and feature permission checks.
- EconomyAPI: Permission nodes for economy commands (economy.*).
- EssentialsTP: Permission nodes for teleport commands (essentialstp.*).
- MultiWorld: Permission nodes for world management commands (pperms.command.mw.*).
- PureChat: Group-based chat formatting and prefix/suffix management.
- PlaceholderAPI: Rank, prefix, and suffix placeholders for displays.
- ScoreHud: Display rank and group information on scoreboards.
Compatibility & Requirements
- ⚠️ Requires PMMPCore Framework: This plugin is part of the PMMPCore ecosystem and cannot function independently.
- ✅ Version: Optimized for Minecraft Bedrock 1.21.70+ (Release).
- ✅ Multiplayer: Fully tested on Realms and Dedicated Servers.
- ✅ Cross-Plugin: Serves as the central permission backend for all PMMPCore plugins.
- ✅ License: GPL-3.0 - Free to use, modify, and distribute under the same terms.
Installation
- Download PurePerms from CurseForge (comes as .mcpack file)
- Change file extension: Rename
PurePerms.mcpack to PurePerms.zip
- Extract the archive: Unzip the file to access the contents
- Locate PMMPCore: Find your PMMPCore Framework installation folder
- Copy plugin files: From the extracted folder, copy the
PurePerms folder from scripts/plugins/
- Paste to plugins: Paste the folder into
scripts/plugins/ within PMMPCore
- Register plugins: Open
scripts/plugins.js and add the import:
// Add this line to your plugins.js file
import "./plugins/PurePerms/main.js";
- Restart server: Restart Minecraft Bedrock to load the plugin
- Verify installation: Use
/plugins to confirm plugin is loaded
Getting Started
- Install PMMPCore Framework first (required dependency)
- Follow the installation steps above to add PurePerms
- Restart your server to initialize the plugin
- Use
/ppinfo to verify the system is working
- Use
/groups to see default groups
- Create custom groups and assign players as needed
Need help with permission management? Join our Discord Server for support!
⚠️ Important Notice: This plugin requires PMMPCore Framework and is designed for server administrators with technical knowledge of server management.