Permissions Setup

Permissions Setup

Setting up permissions for BuildersWand requires careful planning to ensure players have appropriate access while maintaining server security. This guide covers common permission setups for different server types and player groups.

Permission Plugin Compatibility

BuildersWand works with all major permission plugins:

LuckPerms (Recommended)

# Basic setup commands
/lp creategroup builders
/lp creategroup moderators
/lp creategroup administrators

# Builder group permissions
/lp group builders permission set builderswand.use true
/lp group builders permission set builderswand.use.basic true
/lp group builders permission set builderswand.craft.basic true

# Moderator group permissions
/lp group moderators permission set builderswand.use true
/lp group moderators permission set builderswand.use.basic true
/lp group moderators permission set builderswand.use.advanced true
/lp group moderators permission set builderswand.craft.basic true
/lp group moderators permission set builderswand.craft.advanced true
/lp group moderators permission set builderswand.admin.give true
/lp group moderators permission set builderswand.admin.stats true

# Administrator group permissions
/lp group administrators permission set builderswand.* true

PermissionsEx

# Create groups
/pex group builders create
/pex group moderators create
/pex group administrators create

# Set permissions
/pex group builders add builderswand.use
/pex group builders add builderswand.use.basic
/pex group builders add builderswand.craft.basic

/pex group moderators add builderswand.use
/pex group moderators add builderswand.use.basic
/pex group moderators add builderswand.use.advanced
/pex group moderators add builderswand.craft.basic
/pex group moderators add builderswand.craft.advanced
/pex group moderators add builderswand.admin.give
/pex group moderators add builderswand.admin.stats

/pex group administrators add builderswand.*

GroupManager

# Create groups
/manuaddgroup builders
/manuaddgroup moderators
/manuaddgroup administrators

# Add permissions
/manuaddsub builders builderswand.use
/manuaddsub builders builderswand.use.basic
/manuaddsub builders builderswand.craft.basic

/manuaddsub moderators builderswand.use
/manuaddsub moderators builderswand.use.basic
/manuaddsub moderators builderswand.use.advanced
/manuaddsub moderators builderswand.craft.basic
/manuaddsub moderators builderswand.craft.advanced
/manuaddsub moderators builderswand.admin.give
/manuaddsub moderators builderswand.admin.stats

/manuaddsub administrators builderswand.*

Common Permission Setups

Survival Server Setup

New Players (Default Group)

# No permissions - players must earn access

Trusted Players

builderswand.use: true
builderswand.use.basic: true
builderswand.craft.basic: true
builderswand.use.world.survival: true

Builders

builderswand.use: true
builderswand.use.basic: true
builderswand.use.advanced: true
builderswand.craft.basic: true
builderswand.craft.advanced: true
builderswand.use.world.survival: true
builderswand.use.world.creative: true
builderswand.break.diamond_ore: true
builderswand.break.emerald_ore: true

Moderators

builderswand.use: true
builderswand.use.basic: true
builderswand.use.advanced: true
builderswand.craft.basic: true
builderswand.craft.advanced: true
builderswand.admin.give: true
builderswand.admin.stats: true
builderswand.bypass.restrictions: true
builderswand.bypass.blocks: true

Creative Server Setup

Guests

builderswand.use: true
builderswand.use.basic: true
builderswand.craft.basic: true
builderswand.use.world.creative: true

Builders

builderswand.use: true
builderswand.use.basic: true
builderswand.use.advanced: true
builderswand.use.expert: true
builderswand.craft.basic: true
builderswand.craft.advanced: true
builderswand.craft.expert: true
builderswand.use.world.creative: true
builderswand.bypass.restrictions: true

Staff

builderswand.*: true

Faction Server Setup

Members

builderswand.use: true
builderswand.use.basic: true
builderswand.craft.basic: true
builderswand.use.world.factions: true

Officers

builderswand.use: true
builderswand.use.basic: true
builderswand.use.advanced: true
builderswand.craft.basic: true
builderswand.craft.advanced: true
builderswand.use.world.factions: true
builderswand.break.diamond_ore: true
builderswand.break.emerald_ore: true

Leaders

builderswand.use: true
builderswand.use.basic: true
builderswand.use.advanced: true
builderswand.use.expert: true
builderswand.craft.basic: true
builderswand.craft.advanced: true
builderswand.craft.expert: true
builderswand.use.world.factions: true
builderswand.bypass.restrictions: true

World-Specific Permissions

Multi-World Server

# Survival world
builderswand.use.world.survival: true
builderswand.use.world.survival_nether: true

# Creative world
builderswand.use.world.creative: true
builderswand.use.world.creative_flat: true

# Resource world
builderswand.use.world.resource: true
builderswand.break.diamond_ore: true
builderswand.break.emerald_ore: true
builderswand.break.ancient_debris: true

# Protected worlds (no wands)
# No permissions for these worlds

WorldGuard Region Permissions

# Spawn protection
builderswand.use.region.spawn: false

# Build zones
builderswand.use.region.build_zone: true
builderswand.use.region.build_zone_advanced: true

# Resource zones
builderswand.use.region.resource_zone: true
builderswand.break.diamond_ore: true
builderswand.break.emerald_ore: true

Material-Specific Permissions

Valuable Materials

# Diamond and emerald ores
builderswand.break.diamond_ore: true
builderswand.break.emerald_ore: true
builderswand.break.deepslate_diamond_ore: true
builderswand.break.deepslate_emerald_ore: true

# Nether resources
builderswand.break.ancient_debris: true
builderswand.break.nether_gold_ore: true

# Special blocks
builderswand.place.bedrock: false
builderswand.place.command_block: false
builderswand.place.barrier: false

Building Materials

# Common building blocks
builderswand.place.stone: true
builderswand.place.dirt: true
builderswand.place.oak_planks: true
builderswand.place.cobblestone: true

# Advanced materials
builderswand.place.obsidian: true
builderswand.place.quartz_block: true
builderswand.place.prismarine: true

Permission Inheritance Examples

Tiered Access System

# Basic tier inherits from nothing
builderswand.use.basic: true

# Advanced tier inherits from basic
builderswand.use.advanced: true  # Includes basic permissions

# Expert tier inherits from advanced
builderswand.use.expert: true    # Includes basic and advanced permissions

Role-Based Inheritance

# Builder role
builderswand.use: true
builderswand.use.basic: true
builderswand.use.advanced: true
builderswand.craft.basic: true
builderswand.craft.advanced: true

# Senior Builder (inherits Builder + more)
builderswand.use.expert: true
builderswand.craft.expert: true
builderswand.break.diamond_ore: true
builderswand.break.emerald_ore: true

# Moderator (inherits Senior Builder + admin)
builderswand.admin.give: true
builderswand.admin.stats: true
builderswand.bypass.restrictions: true

Permission Testing

Testing Commands

# Test if player can use basic wand
/bw give <player> basic

# Test if player can use advanced wand
/bw give <player> advanced

# Test if player can craft wands
# Have player try to craft in-game

Debug Permissions

# LuckPerms
/lp user <player> info
/lp user <player> permission check builderswand.use.basic

# PermissionsEx
/pex user <player> list
/pex user <player> check builderswand.use.basic

# GroupManager
/manuwho <player>
/manucheck <player> builderswand.use.basic

Permission Troubleshooting

Common Issues

Player can't use any wands:

1. Check if they have builderswand.use permission

2. Verify they have permission for specific wand tier

3. Check world permissions

4. Ensure they're not in a disabled world

Player can't craft wands:

1. Check builderswand.craft permission

2. Verify builderswand.craft.<tier> permission

3. Ensure crafting is enabled in wands.yml

4. Check if recipe is properly configured

Player can't use in specific world:

1. Check builderswand.use.world.<worldname> permission

2. Verify world is not in disabled-worlds list

3. Check creative-only/survival-only settings

4. Ensure WorldGuard regions allow usage

Player can't break specific blocks:

1. Check builderswand.break.<material> permission

2. Verify block is not blacklisted

3. Check if block is break-only (not place-only)

4. Ensure material limits are not exceeded

Debug Steps

1. Enable debug mode in config.yml:

   general:
     debug: true

2. Check server logs for permission-related messages

3. Test permissions with a test player account

4. Verify permission plugin is working correctly

5. Check inheritance - ensure parent permissions are set

Security Considerations

Restrictive Setup

# Start with no permissions
# Add permissions only as needed
# Use specific permissions rather than wildcards
# Regularly audit permission assignments

Monitoring Setup

# Enable logging for permission denials
admin:
  logging:
    enabled: true
    log-permissions: true
    log-to-file: true

Backup Permissions

# Keep backups of permission configurations
# Document all permission assignments
# Test permission changes on test server first
# Have rollback plan ready