PurePerms - PMMPCore Plugin

PurePerms Plugin (Click for More)

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

1. Download PurePerms from CurseForge (comes as .mcpack file)
2. Change file extension: Rename PurePerms.mcpack to PurePerms.zip
3. Extract the archive: Unzip the file to access the contents
4. Locate PMMPCore: Find your PMMPCore Framework installation folder
5. Copy plugin files: From the extracted folder, copy the PurePerms folder from scripts/plugins/
6. Paste to plugins: Paste the folder into scripts/plugins/ within PMMPCore
7. Register plugins: Open scripts/plugins.js and add the import:

// Add this line to your plugins.js file
import "./plugins/PurePerms/main.js";

1. Restart server: Restart Minecraft Bedrock to load the plugin
2. Verify installation: Use /plugins to confirm plugin is loaded

Getting Started

1. Install PMMPCore Framework first (required dependency)
2. Follow the installation steps above to add PurePerms
3. Restart your server to initialize the plugin
4. Use /ppinfo to verify the system is working
5. Use /groups to see default groups
6. 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.