Skip to main content

PivotPoly Permissions

Permission nodes for controlling access to PivotPoly features.

Permission Nodes​

pivotpoly.admin​

Description: Grants full access to all PivotPoly commands and features

Default: op (server operators only)

Grants access to:

  • All /pivotpoly commands
  • Wand usage and selection tools
  • Door creation, deletion, and editing
  • GUI access
  • Blueprint management

Usage:

# Grant to a user
/lp user <username> permission set pivotpoly.admin true

# Grant to a group
/lp group admin permission set pivotpoly.admin true

# Revoke from a user
/lp user <username> permission unset pivotpoly.admin

Permission Configuration​

plugin.yml Definition​

permissions:
  pivotpoly.admin:
    description: Allows all PivotPoly commands
    default: op

For Server Administrators:

/lp group admin permission set pivotpoly.admin true

For Builders/Staff:

# Create a custom builder group with PivotPoly access
/lp creategroup builders
/lp group builders permission set pivotpoly.admin true
/lp user <builder_name> parent add builders

For Regular Players:

  • Not recommended to grant pivotpoly.admin to regular players
  • Doors can be used/triggered by all players without permissions
  • Only creation/management requires permissions

Permission Scenarios​

Scenario 1: Full Staff Access​

All staff members can create and manage doors:

/lp group mod permission set pivotpoly.admin true
/lp group admin permission set pivotpoly.admin true

Scenario 2: Builder-Only Access​

Only designated builders can create doors:

/lp creategroup builders
/lp group builders permission set pivotpoly.admin true

# Add specific users
/lp user <builder1> parent add builders
/lp user <builder2> parent add builders

Scenario 3: Single Administrator​

Only one admin manages all doors:

/lp user <admin_name> permission set pivotpoly.admin true

Checking Permissions​

Check if you have permission:

/lp user <your_name> permission check pivotpoly.admin

View all permissions:

/lp user <username> permission info

Future Permissions (Not Yet Implemented)​

These permission nodes may be added in future versions:

  • pivotpoly.use - Basic usage (interact with doors)
  • pivotpoly.create - Create new doors only
  • pivotpoly.delete - Delete existing doors only
  • pivotpoly.edit - Edit door configurations
  • pivotpoly.blueprint - Access blueprint system
  • pivotpoly.bypass.limit - Bypass door creation limits

Check future release notes for permission system updates

Troubleshooting Permissions​

IssueSolution
Commands not workingVerify user has pivotpoly.admin permission
Permission deniedCheck permission with /lp user <name> permission check pivotpoly.admin
Changes not applyingUser may need to rejoin server after permission changes

Next: Learn how to configure PivotPoly behavior and settings