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": "你的玩家列表样式已更改为：<gold>${style}</gold>",
    "unknown": "<red>该样式不存在！</red>",
    "no_permission": "<red>你没有所需权限！</red>"
  },
  // 修改玩家名称的显示方式
  "player": {
    // 切换此功能。
    "modify_name": false,
    // 从玩家列表中隐藏玩家名称。对命令、建议或实体可见性没有影响！
    "hidden": false,
    // 禁用此格式化，强制使用原版格式。
    "passthrough": false,
    // 玩家名称的默认格式
    "format": "%player:displayname%",
    // 启用玩家发送消息时发送更新
    "update_on_chat_message": false,
    // 启用每指定 tick 数发送更新。-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": "Default",
  // 样式更新间隔（tick）。20 为 1 秒。用于格式化和占位符。
  "update_tick_time": 20,
  // 玩家列表的头部，使用简单/静态定义（也适用于 "list_footer"）。支持格式化。
  "list_header": [
    "...",
    "..."
  ],
  // 玩家列表的底部，使用动画定义（也适用于 "list_header"）。支持格式化。
  "list_footer": {
    // 切换至下一帧所需的变更次数。这意味着它每 (change_rate * update_tick_time) tick 更新一次
    "change_rate": 1,
    // 显示文本的帧。帧数没有限制。
    "values": [
      [
        "<red>..."
      ],
      [
        "<blue>..."
      ]
    ],
  },
  // 在自动补全中隐藏此样式，不改变要求。
  "hidden_in_commands": false
}

内置占位符：

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