Community Leaders

The Community Leaders mod for Minecraft Fabric provides server administrators with a powerful tool for distributed community management. The system allows delegating invitation and moderation authority to trusted community leaders such as streamers, content creators, and community organizers.

Hierarchical Management System

The mod implements a three-level management structure:

• Server Administrators — grant invitation rights to trusted leaders
• Community Leaders — manage their own members and appoint moderators
• Moderators — assist leaders in community management with delegated permissions

This system allows administrators to effectively scale community management by transferring some authority to verified leaders while maintaining overall control.

Key Features

Management Delegation

The system allows administrators to grant the communityleaders.invite permission to trusted community leaders. Leaders gain autonomy in inviting and managing their members, promoting natural server growth without constant administrative intervention.

Community Management

Leaders can personalize invitations for their followers and community members. The system automatically integrates with the server whitelist and allows configuring invitation limits for each leader with the option for administrators to disable restrictions.

Moderation System

Leaders can delegate some authority to trusted members by appointing them as moderators. The system automatically checks for conflicting permissions and ensures hierarchical management where all moderator actions are tracked as actions of their leader.

Administrator Tools

Administrators gain access to community structure visualization through the /cl tree command, data integrity monitoring, and automatic synchronization with the LuckPerms permission system. All messages and commands can be customized to match the server's brand.

Technical Requirements

• Minecraft: Version 1.20.1
• Fabric Loader: Version 0.16.14+
• Fabric API: Version 0.92.6+1.20.1
• LuckPerms: Version 5.4+ (required for permission management)

Installation and Setup

1. Install Fabric Loader and download LuckPerms for Fabric
2. Place the CommunityLeaders-1.x.x.jar file and LuckPerms in the mods/ folder
3. On first server startup, the mod will automatically configure itself, creating configuration files in config/communityleaders/

Setting Up Groups in LuckPerms

# Create community leader groups
/lp creategroup streamer
/lp creategroup trusted_streamer

# Basic permissions for leaders
/lp group streamer permission set communityleaders.invite true
/lp group streamer permission set communityleaders.ban true
/lp group streamer permission set communityleaders.moderator true

# Premium leaders get additional rights
/lp group trusted_streamer parent add streamer
/lp group trusted_streamer permission set communityleaders.tree true
/lp group trusted_streamer permission set communityleaders.unlimited true

# Assign leadership to trusted members
/lp user <streamer_name> parent add streamer
/lp user <premium_creator> parent add trusted_streamer

Available Permissions

Basic Rights

• communityleaders.invite — invite players via /cl invite, remove invitations, and view list
• communityleaders.ban — ban invited players via /cl ban
• communityleaders.moderator — manage moderators via /cl mod add/remove/list
• communityleaders.tree — view complete community structure via /cl tree
• communityleaders.unlimited — disable invitation limits

Typical Permission Combinations

• Basic Leader: invite + ban
• Advanced Leader: add moderator
• Premium Leader: add tree + unlimited
• Administrator: all permissions or wildcard communityleaders.*

Server Configuration

The config/communityleaders/config.yml file allows configuring:

# Community Leaders Configuration
# Administrative delegation system settings

# Command settings
command:
  alias: "cl"  # Alias for /communityleaders command

# Community management limits
limits:
  max_invitations_per_leader: 10  # Invitation limit per leader (-1 to disable)

# Server branding - customize all messages
messages:
  invite_success: "Welcome to our community! '%player%' has been invited by their leader."
  ban_reason: "Community guidelines violation - banned by community leader."

Usage for Community Leaders

Core Management Commands

Leaders use /communityleaders or /cl commands (configurable alias):

• Member Invitation and Management:

  • /cl invite <player> — invite a member
  • /cl uninvite <player> — remove invitation
  • /cl ban <player> — ban a member
  • /cl list — view invited list

• Moderation Delegation:

  • /cl mod add <player> — appoint moderator
  • /cl mod remove <player> — remove moderator
  • /cl mod list — list moderators

• Community Overview:

  • /cl tree — view community structure

Moderation Process

1. Leader invites members via /cl invite
2. Leader appoints trusted members as moderators via /cl mod add
3. Moderators manage the leader's community with the same commands
4. All actions are tracked as leader actions for administrative control

Administrative Tools

Monitoring Community Development

Administrators can track community structure through the /cl tree command.

Data Storage and Backup

The mod stores data in JSON files for convenient administration:

• config/communityleaders/config.yml — server configuration
• config/communityleaders/invites.json — invitation relationships
• config/communityleaders/moderators.json — moderation structure

Admin Tip: Regularly backup these files to preserve community structures.

Data Integrity Management

The system automatically maintains data integrity:

• Permission synchronization: when leaders lose permissions, their communities are automatically cleaned up
• Moderation validation: moderators who gain leader permissions are automatically managed by the system
• Real-time updates: changes via LuckPerms are immediately reflected in community structure
• Startup validation: complete consistency check on each server restart

Troubleshooting

Common Setup Issues

1. "LuckPerms not found" warning:

   • Ensure LuckPerms loads before Community Leaders
   • Verify LuckPerms is properly configured

2. Leaders cannot use commands:

   • Check permission assignments in LuckPerms: /lp user <leader> permission check communityleaders.invite
   • Verify group inheritance: /lp user <leader> info

3. Whitelist integration issues:

   • Enable server whitelist for best results: /whitelist on
   • The mod automatically manages whitelist entries for invited players