LuckPerms Configuration

Comprehensive permission settings for the UnitedMC family-friendly server

Complete Server Setup

Download all commands as a script or copy them to clipboard

Initialize

Bootstrap commands to set up initial permissions for server administrator

Admin Bootstrap

This command gives the server administrator full LuckPerms access. Replace username with your own administrator account. This must be run first before setting up the rest of the permissions structure.

# Grant full LuckPerms access to administrator
lp user oskarwhiskey69 permission set luckperms.* true

Security Notice

Only grant this permission to trusted server administrators as it provides complete control over all permissions on the server.

Server Console Required

The admin bootstrap command cannot be run from in-game chat. You must use server console access:

  • For itzg Docker container: Access the container console with docker exec -it [container_name] rcon-cli
  • Export Format: Use the "rcon-cli" export format when executing via container console, as it removes the leading slash
  • Vanilla/Direct Server: Use the server console or RCON connection

The bootstrap command must be executed before any other permission commands, as it grants the necessary access to configure the rest of the permissions system.

PostgreSQL/MySQL/Database Storage Users

When using database storage with LuckPerms, executing multiple commands in rapid succession may result in the message:

[LP] Another command is being executed, waiting for it to finish...

This occurs because database operations take time to complete and LuckPerms queues commands during this process.

Recommended approaches:

  1. Use Smaller Batches: Instead of pasting all commands at once, copy and paste smaller groups of 5-10 commands at a time
  2. Add Delays: Wait a moment between batches of commands to allow database operations to complete
  3. Use Web Editor: For complex setups, consider using the LuckPerms web editor with /luckperms editor which handles these database operations more efficiently

Permission Structure

Our hierarchical permission system is designed to provide appropriate access for players of all ages

Group Hierarchy

The UnitedMC server uses a carefully designed permission hierarchy with five groups:

  1. Operators - Full administrative access (inherits Moderator permissions)
  2. Moderator - Trusted adults with moderation powers (inherits Trusted permissions)
  3. Trusted - Regular players with additional privileges (inherits Default permissions)
  4. Child - Restricted permissions for younger players (inherits limited Default permissions)
  5. Default - New players in spectator mode with chat only

Permission Inheritance

Our permission structure uses inheritance to ensure higher-level groups automatically receive all permissions from lower groups. This makes management easier and ensures consistent access as players are promoted.

Setting Up Basic Structure

# Create the required groups
/luckperms creategroup operators
/luckperms creategroup moderator
/luckperms creategroup trusted
/luckperms creategroup child

# Set parent-child relationships for permission inheritance
/luckperms group operators parent add moderator
/luckperms group moderator parent add trusted
/luckperms group trusted parent add default

Group Configurations

Detailed permission settings for each user group

Default Group

The Default group is for new players who haven't been promoted yet. They can only spectate and chat, without the ability to build or interact with the world. This allows you to verify players before granting them gameplay permissions.

Basic Commands Access

# Default group - spectator mode only with chat access
/luckperms group default permission set minecraft.command.me true
/luckperms group default permission set minecraft.command.tell true
/luckperms group default permission set minecraft.command.help true
/luckperms group default permission set minecraft.command.list true

Force Spectator Mode

# Force spectator mode for Default group
/luckperms group default permission set minecraft.gamemode.spectator true
/luckperms group default permission set minecraft.gamemode.survival false
/luckperms group default permission set minecraft.gamemode.creative false
/luckperms group default permission set minecraft.gamemode.adventure false

# Prevent building for Default group
/luckperms group default permission set minecraft.build false

Basic Voice Chat Access

# Basic voice chat permissions
/luckperms group default permission set voicechat.speak true
/luckperms group default permission set voicechat.listen true
/luckperms group default permission set voicechat.join.default true

Basic BlueMap View Access

# Basic BlueMap view-only access
/luckperms group default permission set bluemap.web.map true

Gravestone Access

# Allow default users to see their own gravestones but not interact
/luckperms group default permission set gravestones.see.own true

AFK Detection

# AFK detection basic permissions
/luckperms group default permission set afkdetect.status true

Why Spectator Mode?

New players are placed in spectator mode to prevent griefing before they understand server rules. This is especially important for a family-friendly server where players of all ages participate.

Child Group

The Child group is designed for younger players with safety in mind. They can build and play normally, but have restricted access to features that could be problematic.

Survival Gameplay Access

# Child group - inherit from Default but add building capabilities
/luckperms group child permission set minecraft.gamemode.survival true
/luckperms group child permission set minecraft.build true

Basic Movement Commands

# Basic movement commands
/luckperms group child permission set minecraft.command.spawn true
/luckperms group child permission set minecraft.command.home true
/luckperms group child permission set minecraft.command.sethome true

Land Claims & Party Permissions

# Open Parties and Claims with small claim size
/luckperms group child permission set partiesandclaims.claim.create true
/luckperms group child permission set partiesandclaims.claim.size.16 true
/luckperms group child permission set partiesandclaims.claim.max.2 true
/luckperms group child permission set partiesandclaims.party.create true
/luckperms group child permission set partiesandclaims.party.join true

Child-Appropriate BlueMap Access

# BlueMap child-appropriate permissions
/luckperms group child permission set bluemap.web.login true

Gravestone Interaction

# Gravestone interaction for own gravestones only
/luckperms group child permission set gravestones.interact.own true

Quality of Life Features

# Falling Tree support to prevent frustration
/luckperms group child permission set fallingtree.use true

# OnePlayerSleep access
/luckperms group child permission set oneplaysleep.use true

Voice Chat Restrictions

# RESTRICT private messaging for children
/luckperms group child permission set voicechat.whisper false
/luckperms group child permission set voicechat.music.play false

Safety First

The Child group has specific restrictions on private voice messaging and music playback to ensure a safe environment for younger players.

Trusted Group

The Trusted group is for regular players with additional privileges. These players have demonstrated responsibility and understanding of server rules.

Game Mode Permissions

# Trusted group - regular players with more privileges
/luckperms group trusted permission set minecraft.command.gamemode.survival true
/luckperms group trusted permission set minecraft.command.gamemode.creative true
# Trusted group - - Carpet mod permissions
/luckperms group trusted permission set carpet.spawn true
/luckperms group trusted permission set carpet.spawn.limit.2 true

Enhanced Claim and Party Options

# Enhanced claim and party options
/luckperms group trusted permission set partiesandclaims.claim.size.64 true
/luckperms group trusted permission set partiesandclaims.claim.max.5 true
/luckperms group trusted permission set partiesandclaims.party.invite true
/luckperms group trusted permission set partiesandclaims.party.kick true

Voice Chat Features

# Enable voice chat features
/luckperms group trusted permission set voicechat.whisper true
/luckperms group trusted permission set voicechat.music.play true
/luckperms group trusted permission set voicechat.url true

BlueMap Features

# BlueMap features for trusted players
/luckperms group trusted permission set bluemap.marker.add true
/luckperms group trusted permission set bluemap.marker.remove.own true

AFK Features

# AFK features
/luckperms group trusted permission set afkdetect.command true
/luckperms group trusted permission set afksleep.use true
/luckperms group trusted permission set afksit.use true

Chat Formatting

# Beautified Chat basic formatting
/luckperms group trusted permission set beautifiedchat.format.basic true
/luckperms group trusted permission set beautifiedchat.color.basic true

Balanced Permissions

Trusted players have access to creative mode and larger claim sizes, allowing more building freedom while maintaining server stability and security.

Moderator Group

The Moderator group is for trusted adults who help manage the server. They have significant administrative capabilities while still maintaining some restrictions.

Moderation Commands

# Moderator group - moderation capabilities
/luckperms group moderator permission set minecraft.command.kick true
/luckperms group moderator permission set minecraft.command.ban true
/luckperms group moderator permission set minecraft.command.pardon true
/luckperms group moderator permission set minecraft.command.tp true
/luckperms group moderator permission set minecraft.command.teleport true
/luckperms group moderator permission set minecraft.command.gamemode.spectator true

Build Permissions

# Allow building in spawn chunks
/luckperms group moderator permission set minecraft.build.spawn true

Carpet Mod Access

# Carpet mod - only fake player spawning
/luckperms group moderator permission set carpet.spawn true
/luckperms group moderator permission set carpet.spawn.limit.10 true

Enhanced Claim Management

# Enhanced claim capabilities
/luckperms group moderator permission set partiesandclaims.claim.size.256 true
/luckperms group moderator permission set partiesandclaims.claim.max.10 true
/luckperms group moderator permission set partiesandclaims.claim.manage.others true

Voice Chat Moderation

# Voice chat moderation
/luckperms group moderator permission set voicechat.broadcast true
/luckperms group moderator permission set voicechat.manage.mute true
/luckperms group moderator permission set voicechat.manage.disconnect true

BlueMap Moderation

# BlueMap moderation
/luckperms group moderator permission set bluemap.marker.remove.all true
/luckperms group moderator permission set bluemap.web.manage true

Group Management

# Group management permissions
/luckperms group moderator permission set luckperms.user.parent.add.default true
/luckperms group moderator permission set luckperms.user.parent.add.child true
/luckperms group moderator permission set luckperms.user.parent.add.trusted true
/luckperms group moderator permission set luckperms.user.parent.remove.default true
/luckperms group moderator permission set luckperms.user.parent.remove.child true
/luckperms group moderator permission set luckperms.user.parent.remove.trusted true

Enhanced Groups Management

# Enhanced Groups permissions
/luckperms group moderator permission set enhancedgroups.command true
/luckperms group moderator permission set enhancedgroups.group.modify true

Gravestone Management

# Gravestone management
/luckperms group moderator permission set gravestones.interact.others true

Server Notifications

# Server notifications
/luckperms group moderator permission set servernotify.commands true

Chat Controls

# Extended chat controls
/luckperms group moderator permission set beautifiedchat.format.advanced true
/luckperms group moderator permission set beautifiedchat.color.all true

Moderation Responsibilities

Moderators have the crucial ability to promote and demote players between Default, Child, and Trusted groups, allowing them to manage community membership while Operators retain control over higher permission levels.

Operators Group

The Operators group is for server administrators with full control over all aspects of the server. This group should be reserved for trusted server owners and administrators.

Full Administrative Access

# Operators group - full administrative access
/luckperms group operators permission set luckperms.* true
/luckperms group operators permission set minecraft.command.* true
/luckperms group operators permission set carpet.* true
/luckperms group operators permission set bluemap.* true
/luckperms group operators permission set partiesandclaims.* true
/luckperms group operators permission set voicechat.* true
/luckperms group operators permission set enhancedgroups.* true
/luckperms group operators permission set gravestones.* true
/luckperms group operators permission set servernotify.* true
/luckperms group operators permission set afkdetect.* true
/luckperms group operators permission set beautifiedchat.* true

Operator Security

Assign Operator status only to absolutely trusted individuals, as they have complete access to all server functions. For day-to-day moderation, the Moderator group provides most necessary tools without full administrative access.

UnitedMC Branding

Server branding elements for chat and permissions

Chat Prefixes

These commands set up chat prefixes for different groups, creating a visual hierarchy and server branding in the chat.

# Set server prefix for chat
/luckperms group default meta addprefix 100 "&8[&7UnitedMC&8] "
/luckperms group child meta addprefix 90 "&8[&bUnitedMC&8] "
/luckperms group trusted meta addprefix 80 "&8[&aUnitedMC&8] "
/luckperms group moderator meta addprefix 70 "&8[&6UnitedMC&8] "
/luckperms group operators meta addprefix 60 "&8[&4UnitedMC&8] "

Server-Specific Permission

# Set server-specific permission
/luckperms group default permission set unitedmc.member true

Color Coding

The prefix colors follow a logical progression: Default (gray), Child (light blue), Trusted (green), Moderator (gold), and Operators (dark red). This makes it easy to identify a player's role at a glance.

User Management

Commands for managing player permissions and groups

Group Management Commands

These commands allow moderators and operators to promote or demote users between permission groups.

Promotion Commands

Action Command
Promote to Child group /luckperms user <player> parent add child
/luckperms user <player> parent remove default
Promote to Trusted group /luckperms user <player> parent add trusted
/luckperms user <player> parent remove child
Promote to Moderator /luckperms user <player> parent add moderator
/luckperms user <player> parent remove trusted
Promote to Operator /luckperms user <player> parent add operators
/luckperms user <player> parent remove moderator

Temporary Permissions

You can use these commands to grant temporary permissions or group memberships:

# Add a player to the Trusted group for 7 days
/luckperms user <player> parent add trusted true 7d

# Give a player temporary creative mode
/luckperms user <player> permission set minecraft.command.gamemode.creative true 2h

Pro Tip

For visual permission management, use the LuckPerms web editor with /luckperms editor to get a link to a browser-based permission editor.

Export Commands

Choose the export format and select which command groups to include.

chat: Commands include leading slash (/) - paste directly into Minecraft chat/console

rcon-cli: Commands without leading slash - for use with itzg container's rcon-cli or direct server console

Include command groups:

Monitor Your Server

Now that you've set up your permissions, keep an eye on server performance and explore the world map.

Server Status BlueMap