ChatModifier

插件

· 作者 Dominos111G

ChatModifier 彻底重构了聊天和玩家通信功能——它支持将消息范围限制在可配置的半径内,处理私聊、仅限工作人员的全局广播以及管理员窥视模式。

0 本站下载 0 关注 更新于 4 个月前

最新 0.2.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

注意: 本描述由 AI 生成,欢迎提供您的建议!

? ChatModifier

适用于学校 Minecraft 服务器的聊天插件(PaperMC 1.20.x / 1.21.x)

ChatModifier 彻底重构了聊天和玩家通信功能——它允许将消息范围限制在可配置的半径内,处理私聊、仅限工作人员的全球广播以及管理员间谍模式。它可选择集成 LuckPerms 以显示等级前缀。

✨ 特性

? 带范围的本地聊天

  • 只有配置半径内的玩家才能看到消息
  • 设置为 0 = 无限范围(整个世界)
  • 可配置消息间隔冷却时间
  • 忽略旁观者模式和隐身玩家

? 喊话 (/shout, /s, /krzyk)

  • 向服务器上的所有玩家广播一条消息
  • 可在 config.yml 中配置较长的冷却时间
  • 所有玩家均可使用(无需权限)

? 全局 (/global, /g)

  • 工作人员广播,所有人都可见
  • 需要 chatmodifier.command.global 权限
  • 可在 config.yml 中禁用

? 私聊 (/msg, /reply)

  • 向特定玩家发送私密消息
  • /reply(或 /r)回复上一次对话的伙伴
  • 正确处理隐身/旁观者玩家
  • Tab 补全根据权限过滤隐藏的玩家

?️ 聊天间谍 (/spy)

  • 聊天间谍和私聊间谍有独立的开关
  • 拦截的消息会加上 [SPY] 前缀
  • 需要 chatmodifier.spy 权限

? 消息过滤器

  • 阻止不允许的字符(可配置的正则表达式)
  • config.yml 中的封禁词列表
  • LuckPerms 集成:聊天中显示等级前缀

? 安装

  1. 从 GitHub 下载 .jar 文件
  2. 将其放入服务器的 plugins/ 文件夹
  3. 启动服务器——配置文件会自动生成
  4. 编辑 plugins/ChatModifier/config.yml 和 lang.yml
  5. 使用 /reload confirm 重载或重启服务器

要求:

  • PaperMC 1.20.x 或 1.21.x
  • Java 21+
  • LuckPerms(可选——用于显示等级前缀)

? 命令

命令 别名 描述 权限
/shout <message> /s, /krzyk 向整个服务器广播(应用冷却时间) (无——所有人)
/global <message> /g 工作人员广播 chatmodifier.command.global
/msg <player> <message> /tell, /w, /message 私密消息 (无——所有人)
/reply <message> /r 回复上一条私密消息 (无——所有人)
/spy — 显示间谍状态 chatmodifier.spy
/spy chat — 切换聊天间谍 chatmodifier.spy
/spy msg — 切换私密消息间谍 chatmodifier.spy

? 权限

权限 默认值 描述
chatmodifier.command.global false 访问 /global
chatmodifier.cooldown.bypass false 跳过聊天冷却时间
chatmodifier.spy op 访问 /spy
chatmodifier.seehidden false 在 /msg Tab 补全中看到隐藏/隐身的玩家

LuckPerms 示例

/lp group admin permission set chatmodifier.command.global true
/lp group admin permission set chatmodifier.spy true
/lp group vip permission set chatmodifier.cooldown.bypass true

⚙️ 配置

config.yml

# ------- [ CHAT ] ------- #
chat:
  distance: 32    # 消息半径(方块数)(0 = 无限)
  cooldown: 1500  # 消息间隔时间(毫秒)

# ------- [ BANNED WORDS ] ------- #
banned-words: []
# 示例: ["badword", "spam"]

# ------- [ GLOBAL ] ------- #
global:
  enabled: true

# ------- [ SHOUT ] ------- #
shout:
  enabled: true
  cooldown: 150000  # 冷却时间(毫秒)(默认 2.5 分钟)

# ------- [ COMMANDS ] ------- #
# 启动时注册的额外别名(除内置别名外)。
# 更改这些值后请重启服务器。
# 内置:  shout=[krzyk, s]  global=[g]  msg=[tell, w, message]  reply=[r]
commands:
  shout:
    extra-aliases: []
  global:
    extra-aliases: []
  msg:
    extra-aliases: []
  reply:
    extra-aliases: []
  spy:
    extra-aliases: []

聊天半径参考

distance 值 效果
0 无限(整个世界)
32 32 方块内可见
64 64 方块内可见

喊话冷却参考

shout.cooldown 值 持续时间
60000 1 分钟
150000 2.5 分钟
300000 5 分钟
900000 15 分钟

lang.yml

所有面向玩家的消息都位于 plugins/ChatModifier/lang.yml 中。编辑任何值以自定义文本。颜色代码使用 &(例如 &c = 红色,&a = 绿色,&7 = 灰色)。占位符已在文件内记录。

chat:
  no-recipients: "&c[CM] Nobody heard you - No players within {distance} blocks!"
shout:
  cooldown: "&c[CM] You must wait {minutes}min. {seconds}s. before using this command again."

添加自定义命令别名

要添加自定义别名(例如将 /bc 作为 /shout 的别名),请编辑 config.yml 并重启:

commands:
  shout:
    extra-aliases: [ bc, broadcast ]

? LuckPerms 集成

当安装了 LuckPerms 时,插件会自动获取每个玩家的前缀并将其添加到聊天消息中:

[Admin] Dominik: Hello!

如果没有 LuckPerms,则只显示玩家名称:

Dominik: Hello!

? 版本历史

1.0.0

  • 首次发布
  • 带半径和冷却时间的本地聊天
  • 命令:/shout, /global, /msg, /reply, /spy
  • 在 config.yml 中为每个命令配置额外的别名
  • LuckPerms 集成
  • 支持 Minecraft 1.20.x 和 1.21.x

? 故障排除

插件无法加载

  1. 检查服务器版本——需要 Paper 1.20.x 或 1.21.x(/version)
  2. 检查您是否正在运行 Java 21+(java -version)
  3. 查看服务器控制台中是否有 [ChatModifier] 错误

/global 提示无权限

确保该玩家/组拥有 chatmodifier.command.global 权限。

距离为 0 时聊天无反应

设置 chat.distance: 0 —— 值 0 表示无限范围。

自定义别名无效

请确保已重启服务器(而非仅执行 /reload)。额外别名会在启动时通过 CommandMap 注册。

LuckPerms 前缀未显示

请确保在 ChatModifier 之前安装并加载了 LuckPerms。

? 版本历史

未来路线图

  • 更多自定义选项
  • 从 API 获取黑名单
  • 自定义昵称系统
  • 数据库集成

0.1.0

  • 初始发布,包含核心功能。

? 链接

  • GitHub:
  • Modrinth:
  • 问题反馈:

? 许可证

MIT License — 可自由修改和分发

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源