社区领袖

社区领袖

一个旨在帮助服务器管理员将社区管理委托给可信“社区领袖”的模组。服务器管理员可以授予主播、内容创作者或社区经理邀请权限……

管理

社区领袖

社区领袖 是一个 Minecraft Fabric 模组,旨在帮助 服务器管理员 将社区管理委托给受信任的 社区领袖。服务器管理员可以授予主播、内容创作者或社区管理员邀请权限,随后他们可以在服务器上管理自己的社区,并将管理任务委托给他们信任的成员。

概念

该模组创建了一个 三级管理层次 :

  1. 服务器管理员 → 向受信任的社区领袖授予邀请权限
  2. 社区领袖 → 管理自己的社区成员并指派管理员
  3. 管理员 → 通过委托权限帮助领袖管理他们的社区

该系统允许服务器管理员通过授权受信任的领袖来扩展社区管理规模,同时保持监督和控制。

功能

管理委托

  • 基于权限的领袖身份:管理员授予受信任的社区领袖 communityleaders.invite 权限
  • 自治社区管理:领袖可以独立邀请和管理其社区成员
  • 可扩展的服务器增长:在单个服务器上支持多个社区,无需管理员微观管理
  • 保持监督:所有操作均被追踪,可由服务器管理员审计

社区管理

  • 个性化邀请:社区领袖可以邀请其粉丝、订阅者或社区成员
  • 集成白名单系统:自动为被邀请的玩家管理服务器白名单
  • 邀请限制:每位领袖可配置的限制(支持管理员覆盖)
  • 成员生命周期管理:完全控制社区成员的邀请、移除和封禁

管理委托

  • 受信任的管理员系统:领袖可以将权限委托给受信任的社区成员
  • 层级管理:管理员代表其指派的领袖行事
  • 自动验证:系统确保管理员不会获得冲突的权限
  • 灵活委托:领袖可以随着社区发展添加/移除管理员

高级管理工具

  • 邀请树可视化:服务器管理员可以查看完整的社区结构
  • 数据一致性监控:自动验证和清理权限关系
  • 实时同步:与 LuckPerms 集成以实现即时权限更新
  • 命令自定义:可配置的别名和消息以匹配服务器品牌

安全与权限

  • LuckPerms 集成:利用企业级权限管理
  • 细粒度访问控制:为每个管理级别精细调整权限
  • 自动验证:实时验证权限和关系
  • 一致性强制执行:当权限变更时自动清理无效数据

要求

  • Minecraft:版本 1.20.1
  • Fabric Loader:版本 0.16.14+
  • Fabric API:版本 0.92.6+1.20.1
  • LuckPerms:版本 5.4+(权限管理所需)

安装

  1. 下载依赖:

  2. 安装模组:

    • 将 CommunityLeaders-1.x.x.jar 文件放入 mods/ 文件夹
    • 同时将 LuckPerms 放入 mods/ 文件夹
  3. 启动服务器:

    • 模组将在首次启动时自动配置
    • 配置文件将在 config/communityleaders/ 中创建

设置指南

1. 创建组

在 LuckPerms 中设置不同层级的社区领袖:

# 创建社区领袖组
/lp creategroup streamer
/lp creategroup trusted_streamer

# 基础社区领袖权限
/lp group streamer permission set communityleaders.invite true
/lp group streamer permission set communityleaders.ban true
/lp group streamer permission set communityleaders.moderator true

# 高级领袖获得额外权限
/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

# 向受信任的成员分配领袖身份
/lp user <streamer_name> parent add streamer
/lp user <premium_creator> parent add trusted_streamer

2. 管理员权限

为了获得完整的服务器监督权限,管理员应拥有所有权限。服务器操作员自动拥有完全访问权限,但您可以为管理员组显式设置权限:

# 授予管理员完全访问权限(可选 - 管理员通常拥有 * 权限)
/lp group admin permission set communityleaders.* true

可用权限

该模组提供可单独分配的细粒度权限:

communityleaders.invite

  • 允许通过 /cl invite 邀请玩家加入服务器
  • 允许通过 /cl uninvite 取消邀请您邀请的玩家
  • 允许通过 /cl list 查看您的邀请列表
  • 受邀请限制约束(除非同时授予 communityleaders.unlimited)

communityleaders.ban

  • 允许通过 /cl ban 永久封禁您邀请的玩家
  • 被封禁的玩家将被断开连接、添加到服务器封禁列表并从白名单中移除
  • 只能封禁您个人邀请的玩家

communityleaders.tree

  • 允许通过 /cl tree 查看完整的服务器邀请结构
  • 显示所有领袖及其受邀社区
  • 对服务器管理员和高级社区领袖有用

communityleaders.moderator

  • 允许通过 /cl mod add/remove/list 管理管理员
  • 可以将受邀玩家提升为管理员身份
  • 管理员可以代表其指派的领袖使用领袖命令
  • 包含自动验证以防止权限冲突

communityleaders.unlimited

  • 绕过配置中设置的邀请限制
  • 无论 max_invitations_per_leader 设置如何,允许无限邀请
  • 通常授予受信任的高级领袖或服务器工作人员

权限组合:

  • 基础社区领袖:communityleaders.invite + communityleaders.ban
  • 高级社区领袖:添加 communityleaders.moderator
  • 高级社区领袖:添加 communityleaders.tree + communityleaders.unlimited
  • 服务器管理员:授予所有权限或使用通配符 communityleaders.*

服务器配置

config/communityleaders/config.yml 文件允许服务器范围的定制:

# 社区领袖配置
# 社区委托系统的管理设置

# 命令配置
command:
  alias: "cl"  # /communityleaders 命令的别名(为您的服务器自定义)

# 社区管理限制
limits:
  max_invitations_per_leader: 10  # 每位领袖的默认限制(-1 为无限制)
  # 注意:拥有 'communityleaders.unlimited' 权限的领袖绕过此限制

# 服务器品牌 - 自定义所有消息
messages:
  # 自定义所有消息以匹配服务器的语气和语言
  invite_success: "欢迎加入我们的社区!'%player%' 已被其社区领袖邀请。"
  ban_reason: "违反社区准则 - 已被社区领袖封禁。"
  # ...(所有其他消息均可自定义)

社区领袖使用指南

社区领袖使用该模组在服务器内管理自己的社区:

核心管理命令

该模组提供两种命令格式:

  • 完整命令:/communityleaders <subcommand>
  • 服务器别名:/cl <subcommand>(可由管理员配置)

成员邀请与管理

  • /cl invite <player> - 邀请社区成员加入服务器
  • /cl uninvite <player> - 移除您邀请的社区成员
  • /cl ban <player> - 永久封禁您邀请的社区成员
  • /cl list - 查看您邀请加入服务器的所有成员

管理委托

  • /cl mod add <player> - 将受邀成员提升为您社区的管理员
  • /cl mod remove <player> - 移除成员的管理员身份
  • /cl mod list - 查看您当前的所有管理员

社区概览

  • /cl tree - 查看完整的社区结构

管理如何运作

  1. 领袖使用 /cl invite 邀请社区成员
  2. 领袖使用 /cl mod add 将受信任的成员提升为管理员
  3. 管理员随后可以使用相同命令管理领袖的社区
  4. 所有操作均归属于领袖 以便管理追踪

管理工具

监控社区增长

服务器管理员可以监控社区发展:

# 查看完整的服务器社区结构
/cl tree

数据存储与备份

该模组将社区数据存储在 JSON 文件中以便于管理:

  • config/communityleaders/config.yml - 服务器配置
  • config/communityleaders/invites.json - 社区邀请关系
  • config/communityleaders/moderators.json - 管理委托结构

管理员提示:定期备份这些文件以保留社区结构。

数据完整性管理

该模组自动维护数据完整性:

  • 权限同步:当领袖失去权限时,其社区将被清理
  • 管理验证:获得领袖权限的管理员将被自动管理
  • 实时更新:通过 LuckPerms 的更改会立即反映在社区结构中
  • 启动验证:每次服务器重启时进行完整的一致性检查

故障排除

常见设置问题

  1. "LuckPerms not found" 警告:

    • 确保 LuckPerms 在 Community Leaders 之前加载
    • 验证 LuckPerms 已正确配置
  2. 社区领袖无法使用命令:

    • 检查 LuckPerms 权限分配:/lp user <leader> permission check communityleaders.invite
    • 验证组继承:/lp user <leader> info
  3. 白名单集成问题:

    • 启用服务器白名单以获得最佳效果:/whitelist on
    • 模组会自动为受邀玩家管理白名单条目

许可证

本项目基于 AGPL-3.0 许可。

作者

DrEmixam - 主要开发者

支持

如需服务器设置协助或报告错误,请在项目仓库中创建问题。