Permission System

MC 1.21.1MC 1.21.2MC 1.21.4MC 1.21.5MC 1.21.6MC 1.21.9

Showcase provides a comprehensive permission system that integrates with LuckPerms for fine-grained access control. Players can be granted specific permissions for different sharing types and features.

Permission Hierarchy

Showcase uses a hierarchical permission system where higher-level permissions automatically grant access to sub-permissions.

Base Structure

showcase.command.<type>                    # Base permission
├── showcase.command.<type>.receivers      # Can specify recipients
├── showcase.command.<type>.duration       # Can set custom durations
├── showcase.command.<type>.description    # Can add descriptions
└── showcase.command.<type>.cooldown       # Bypass cooldowns

Command Permissions

Player Commands

showcase.command.stats

Share player statistics

Sub-permissions:

showcase.command.stats.receivers - Specify recipients
showcase.command.stats.duration - Custom duration
showcase.command.stats.description - Add descriptions
showcase.command.stats.cooldown - Bypass cooldowns

Utility Commands

showcase.command.view

View shared content via /showcase-view command

showcase.command.cancel

Cancel your own active shares

Administrative Permissions

Management Commands

showcase.manage.about

View mod information (default: available to all players)

showcase.manage.reload

Reload configuration files (default: level 4)

showcase.manage.list

View all active shares (default: level 4)

showcase.manage.cancel

Cancel any player's shares (default: level 4)

Global Admin Access

showcase.admin

Full administrative access to all features

showcase.manage

Access to all management commands (default: level 4)

Chat Placeholder Permissions

Basic Placeholder Access

showcase.chat.placeholder

Basic chat placeholder functionality

showcase.chat.placeholder.item

Use [item] keyword in chat

showcase.chat.placeholder.inventory

Use [inventory] keyword in chat

showcase.chat.placeholder.hotbar

Use [hotbar] keyword in chat

showcase.chat.placeholder.enderchest

Use [enderchest] keyword in chat

showcase.chat.placeholder.stats

Use [stats] keyword in chat

Permission Examples

Basic Player Setup

Grant basic sharing permissions to default players:

# Basic item and inventory sharing
/lp group default permission set showcase.command.item true
/lp group default permission set showcase.command.inventory true
/lp group default permission set showcase.command.hotbar true

# Basic chat placeholders
/lp group default permission set showcase.chat.placeholder.item true
/lp group default permission set showcase.chat.placeholder.inventory true

# View and cancel own shares
/lp group default permission set showcase.command.view true
/lp group default permission set showcase.command.cancel true

Trusted Player Setup

Grant advanced permissions to trusted players:

# All sharing types
/lp group trusted permission set showcase.command.item true
/lp group trusted permission set showcase.command.inventory true
/lp group trusted permission set showcase.command.hotbar true
/lp group trusted permission set showcase.command.enderchest true
/lp group trusted permission set showcase.command.stats true
/lp group trusted permission set showcase.command.container true

# Advanced features
/lp group trusted permission set showcase.command.item.receivers true
/lp group trusted permission set showcase.command.inventory.receivers true
/lp group trusted permission set showcase.command.item.duration true
/lp group trusted permission set showcase.command.inventory.duration true

# All chat placeholders
/lp group trusted permission set showcase.chat.placeholder true

Staff/Moderator Setup

Grant management permissions to staff:

# All player permissions
/lp group staff parent add trusted

# Management commands
/lp group staff permission set showcase.manage.list true
/lp group staff permission set showcase.manage.cancel true

# Bypass some restrictions
/lp group staff permission set showcase.command.item.cooldown true
/lp group staff permission set showcase.command.inventory.cooldown true

Administrator Setup

Grant full access to administrators:

# Full admin access
/lp group admin permission set showcase.admin true

# Or specific management permissions
/lp group admin permission set showcase.manage true
/lp group admin permission set showcase.manage.reload true

# Plus all player permissions
/lp group admin parent add trusted

Permission Defaults

Configuration-Based Defaults

The mod uses configuration to set default permission levels for each share type:

shareSettings:
  ITEM:
    defaultPermission: 0  # Level 0 = all players
  INVENTORY:
    defaultPermission: 0  # Level 0 = all players
  HOTBAR:
    defaultPermission: 0  # Level 0 = all players
  ENDERCHEST:
    defaultPermission: 0  # Level 0 = all players
  STATS:
    defaultPermission: 0  # Level 0 = all players
  CONTAINER:
    defaultPermission: 0  # Level 0 = all players
  MERCHANT:
    defaultPermission: 0  # Level 0 = all players

Fallback Behavior

When LuckPerms is not available, the mod falls back to:

Permission level 0: All players
Permission level 1: Players with level 1+ operator status
Permission level 2: Players with level 2+ operator status
Permission level 3: Players with level 3+ operator status
Permission level 4: Players with level 4 operator status

Permission Testing

Check Player Permissions

Use LuckPerms commands to verify permissions:

# Check specific permission
/lp user <player> permission check showcase.command.item

# List all showcase permissions for a player
/lp user <player> permission list | grep showcase

# Check effective permissions (including inheritance)
/lp user <player> permission check showcase.command.item.receivers

Debug Permission Issues

Use /showcase-manage about to verify the mod is loaded correctly, then check permissions systematically.

Common Issues:

Player can't share: Check base permission (showcase.command.item)
Can't specify receivers: Check sub-permission (showcase.command.item.receivers)
Chat keywords don't work: Check chat placeholder permissions
Admin commands fail: Verify management permissions or operator level

Permission Wildcards

LuckPerms supports wildcard permissions:

# Grant all command permissions
/lp group trusted permission set showcase.command.* true

# Grant all item-related permissions
/lp group trusted permission set showcase.command.item.* true

# Grant all management permissions
/lp group admin permission set showcase.manage.* true

# Grant all showcase permissions
/lp group admin permission set showcase.* true

Migration from Other Permission Plugins

From PermissionsEx (PEX)

# Convert PEX groups to LuckPerms
/lp migration permissionsex

# Then apply showcase permissions as shown above

From GroupManager

# Convert GroupManager to LuckPerms
/lp migration groupmanager

# Apply showcase permissions to converted groups

Integration with Other Mods

Compatibility Notes

Showcase permissions work alongside other mod permission systems without conflicts.

Tested Compatibility:

✅ LuckPerms (recommended)
✅ Fabric Permissions API
✅ Server operator levels (fallback)

Known Issues:

Some permission plugins may not support deep permission hierarchies
Wildcard permissions may not work with all permission plugins

Permissions