LPChatPrefix

一个服务端 NeoForge 模组,用于在 Minecraft 1.21.1 的聊天消息中显示 LuckPerms 的前缀和后缀。

管理

适用于 NeoForge 的 LuckPerms 聊天前缀

GitHub 发布 下载量 许可证 Minecraft NeoForge

一个服务器端的 NeoForge 模组,用于在 Minecraft 1.21.1 的聊天消息中显示 LuckPerms 前缀和后缀。

功能

  • 🏷️ 在聊天中显示 LuckPerms 前缀和后缀
  • 🎨 支持 Minecraft 颜色代码(& 符号)
  • ⚙️ 高度可配置的消息格式
  • 🖥️ 仅服务端 - 客户端无需安装
  • 🔧 轻量且高效

要求

  • Minecraft 1.21.1(仅限此版本)
  • NeoForge 21.1.0 或更高版本
  • 服务器已安装 LuckPerms 插件
  • Java 21 或更高版本

安装

下载

从 GitHub Releases 下载最新版本

服务器安装

  1. 从发布页面下载最新的 lpchatprefix-1.21.1_1.1.0.jar
  2. 将 JAR 文件放入服务器的 mods 文件夹
  3. 确保 LuckPerms 已安装并配置完成
  4. 启动/重启服务器

客户端安装

无需安装! 这是一个仅服务端的模组。玩家无需安装任何内容即可连接。

配置

该模组会在 config/lpchatprefix-common.toml 创建配置文件,包含以下选项:

[LPChatPrefix Config]
    # 启用/禁用前缀显示
    enablePrefix = true
    
    # 启用/禁用后缀显示
    enableSuffix = true
    
    # 聊天消息格式模板
    # 支持的占位符:{prefix}, {player}, {suffix}, {message}
    messageFormat = "{prefix}{player}{suffix}: {message}"
    
    # 消息文本颜色(Minecraft 颜色代码)
    # 选项:black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, 
    # gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, white
    messageColor = "gray"
    
    # 玩家名称颜色
    nameColor = "white"

使用方法

  1. 在 LuckPerms 中设置前缀/后缀:
# 为组添加前缀
/lp group admin meta setprefix "&c[Admin] "

# 为用户添加后缀
/lp user <player> meta setsuffix " &7[VIP]"
  1. 前缀和后缀将自动显示在聊天消息中

输出示例

未安装模组:<PlayerName> Hello everyone!

安装模组后:[Admin] PlayerName [VIP]: Hello everyone!

颜色代码支持

该模组支持使用 & 符号的 Minecraft 颜色代码:

  • &c - 红色
  • &a - 绿色
  • &b - 青色
  • &e - 黄色
  • &f - 白色
  • 以及所有其他标准 Minecraft 颜色代码

故障排除

前缀/后缀未显示

  • 确保 LuckPerms 已安装并运行
  • 检查玩家/组是否已设置前缀/后缀
  • 验证模组已加载(检查服务器日志中的 "LPChatPrefix initialized")

聊天中出现重复的玩家名称

  • 确保使用的是最新版本
  • 检查是否有冲突的聊天格式化插件/模组

模组未加载

  • 验证是否使用的正是 Minecraft 1.21.1
  • 确保 NeoForge 版本为 21.1.0 或更高
  • 检查 Java 版本是否为 21 或更高

支持

如有问题、疑问或建议,请在 GitHub 仓库中提交 issue。

致谢

  • 为 NeoForge 构建
  • 需要 Luck 的 LuckPerms
  • 为 Minecraft 1.21.1 开发