Styled Player List

样式化玩家列表

这是一款简单的模组，允许服务器所有者随心所欲地自定义玩家列表样式！

支持完整的权限/条件系统、Placeholder API 集成、多种样式以及玩家列表名称覆盖。

此模组仅适用于 Fabric 和 Quilt！

如有任何疑问，可前往我的 Discord 提问。

也欢迎查看我的其他模组和项目，或许会对您有所帮助！

命令（及权限）：

• /styledplayerlist - 主命令（styledplayerlist.main，默认可用）
• /styledplayerlist reload - 重新加载配置与样式（需要 styledplayerlist.reload 权限）
• /styledplayerlist switch 或 /plstyle - 切换所选样式（styledplayerlist.switch，默认可用）
• /styledplayerlist switchothers - 更改其他玩家的选定样式（styledplayerlist.switch.others）

配置：

配置文件位于 ./config/styledplayerlist/。

部分配置选项支持动态谓词（标记为 {/ PREDICATE /}）。

详见此页面。

格式化使用 PlaceholderAPI 的文本解析器，相关文档见此。

{
  // 配置版本，请勿修改。仅用于版本间更新
  "config_version": 2,
  // 可设置默认玩家列表样式的ID
  "default_style": "default",
  // 可修改本模组命令发送的消息
  "messages": {
    "switch": "您的玩家列表样式已更改为：${style}",
    "unknown": "此样式不存在！",
    "no_permission": "您没有所需权限！"
  },
  // 修改玩家名称的显示方式
  "player": {
    // 启用/禁用此功能
    "modify_name": false,
    // 在玩家列表中隐藏玩家名称。不影响命令、提示或实体可见性！
    "hidden": false,
    // 禁用此格式化，强制使用原版样式
    "passthrough": false,
    // 玩家名称的默认格式
    "format": "%player:displayname%",
    // 当玩家发送消息时发送更新
    "update_on_chat_message": false,
    // 每间隔指定游戏刻发送更新。-1 表示禁用
    "update_tick_time": -1,
    // 自定义样式
    "styles": [
      {
        // 样式应用条件
        "require": {/* PREDICATE */},
        // 应用的格式化，同上
        "format": "...",
        // 可选。禁用此格式化，强制使用原版样式
        "passthrough": false,
        // 可选，在玩家列表中隐藏玩家名称。不影响命令、提示或实体可见性！
        "hidden": false
      }
    ]
  },
  // 使玩家列表在单人游戏（未开启局域网）中显示
  "client_show_in_singleplayer": true
}

样式：

本模组支持多种样式，玩家可自行选择（只需将样式文件放入 ./config/styledplayerlist/styles/ 并使用 /styledplayerlist reload 命令）

{
  // 使用此样式所需的条件（对玩家生效）
  "require": {/* PREDICATE */},
  // 用于显示的样式名称
  "style_name": "默认",
  // 样式更新的时间间隔（单位：游戏刻，20刻=1秒）。用于格式化和占位符更新
  "update_tick_time": 20,
  // 玩家列表顶部内容，使用简单/静态定义（"list_footer" 同理）。支持格式化
  "list_header": [
    "...",
    "..."
  ],
  // 玩家列表底部内容，使用动态定义（"list_header" 同理）。支持格式化
  "list_footer": {
    // 切换到下一帧所需的变化次数。即每间隔（变化率 × 更新游戏刻数）更新一次
    "change_rate": 1,
    // 显示的文本帧序列。数量无限制
    "values": [
      [
        "..."
      ],
      [
        "..."
      ]
    ]
  },
  // 在命令自动补全中隐藏此样式（不改变条件要求）
  "hidden_in_commands": false
}

内置占位符：

支持的占位符列表请参阅 Placeholder API 维基