ChatReply
Minecraft 关键词自动回复插件 — 当玩家在聊天中发送特定消息时,服务器会自动发送配置好的回复。支持 Paper / Spigot / Folia 1.20+,并支持热重载(无需重启)。
概述
ChatReply 专为需要聊天互动、自动引导、规则提醒和 VIP 专属回复的生存、RPG 和小游戏服务器设计。
典型使用场景:
- 玩家在公共聊天发送
Hello -> 自动回复:hi, player!
- 玩家发送
help -> 发送包含规则/帮助提示的私聊消息
- 新玩家加入 -> 自动欢迎消息
- VIP 玩家发送
vipkit -> 私有回复 + 后台执行 give 命令
- 正则匹配如
price diamond -> 自动回复物品价格
所有关键词和回复文本均存储在 replies.yml 中。编辑后,只需运行 /chatreply reload 即可立即应用更改(无需重启服务器)。
功能
关键词匹配
| 功能 |
描述 |
| 精确匹配 |
仅在输入完全匹配时触发 (Hello) |
| 包含匹配 |
当消息包含关键词时触发 (aaahelpbbb) |
| 正则匹配 |
支持捕获组,在回复中使用 {1} {2} |
| 大小写选项 |
区分大小写或不区分大小写 |
| 优先级 |
当规则重叠时,数值较高的优先级获胜 |
回复类型
| 类型 |
描述 |
CHAT |
公共广播 |
PRIVATE |
向触发者发送私聊消息 |
ACTION_BAR |
底部动作栏消息 |
TITLE |
大标题 + 副标题 |
MULTI |
多行分段回复 |
回复目标受众也可配置:SELF、ALL、WORLD、RADIUS:20。
触发规则与限制
- 公共 / 私聊 / 双频道触发
- 世界白名单/黑名单及游戏模式限制
- 在线玩家数量、时间段、权限条件
- 三级冷却时间:全局 / 每位玩家 / 每个关键词
- 每日和终身触发次数限制
- 隐藏或替换原始玩家消息
- 音效、后台命令、Webhook 通知
管理与操作
- 游戏内命令 + GUI 管理面板 (
/chatreply gui)
- 模块级热重载 (
config / replies / lang)
- 配置导入/导出备份
- 触发日志(支持按日轮转)
兼容性
- 完整支持 Folia
- PlaceholderAPI(软依赖,可选)
- EssentialsX 私聊事件钩子(软依赖,可选)
命令
主命令:/chatreply(别名:/cr, /autoreply)
| 命令 |
权限 |
描述 |
/chatreply reload [all|config|replies|lang] |
chatreply.admin.reload |
热重载 |
/chatreply add <keyword> <reply> [options] |
chatreply.admin.add |
快速添加关键词 |
/chatreply remove <keyword> |
chatreply.admin.remove |
移除关键词 |
/chatreply list |
chatreply.admin.list |
列出所有关键词 |
/chatreply info <keyword> |
chatreply.admin.info |
查看规则详情 |
/chatreply group enable/disable <group> |
chatreply.admin.group |
启用/禁用分组 |
/chatreply test <keyword> [message] |
chatreply.admin.test |
模拟触发(不消耗冷却) |
/chatreply toggle |
chatreply.admin.toggle |
启用/禁用插件 |
/chatreply export |
chatreply.admin.export |
导出备份 |
/chatreply import <file> |
chatreply.admin.import |
导入备份 |
/chatreply gui |
chatreply.admin.gui |
打开 GUI 管理面板 |
/chatreply help |
— |
显示帮助 |
add 命令的可选标志:
/chatreply add vip &6VIP-only reply --match EXACT --cooldown 60 --perm chatreply.vip
权限
| 权限 |
默认值 |
描述 |
chatreply.trigger |
everyone |
允许触发自动回复 |
chatreply.blacklist |
false |
如果授予此权限,玩家将永远无法触发回复 |
chatreply.vip |
OP |
用于 VIP 关键词的示例权限 |
chatreply.admin.* |
OP |
所有管理员权限 |
占位符
可在回复、命令和替换文本中使用:
| 占位符 |
描述 |
{player} |
玩家名称 |
{world} |
当前世界 |
{time} |
服务器时间 |
{online} |
在线玩家数量 |
{x} {y} {z} |
玩家坐标 |
{1} {2} ... |
正则捕获组 |
%placeholder% |
PlaceholderAPI 占位符(需要 PAPI) |
回复前缀 (reply-format) 示例:
defaults:
reply-format: "&8[Bot] &r{message}"
热重载
| 命令 |
重载内容 |
/chatreply reload |
所有内容 |
/chatreply reload config |
config.yml |
/chatreply reload replies |
replies.yml(编辑关键词后使用此项) |
/chatreply reload lang |
lang/*.yml |
编辑 replies.yml 后,运行 reload replies,更改将立即生效。
配置快速参考
config.yml
settings:
enabled: true # 插件总开关
language: zh # UI 语言 (zh / en)
update-check:
enabled: true
modrinth-slug: chat-reply
bstats:
enabled: true # 本插件的 bStats 开关
cooldown:
global-seconds: 0 # 全局冷却时间
player-seconds: 3 # 每位玩家的冷却时间
notify: true # 冷却期间是否通知
replies.yml 中的常见规则字段
keywords:
Example:
match-type: EXACT # EXACT | CONTAINS | REGEX
pattern: "regex here" # 用于 REGEX
priority: 10
reply-type: CHAT # CHAT | PRIVATE | ACTION_BAR | TITLE | MULTI
reply-audience: ALL # SELF | ALL | WORLD | RADIUS:20
permission: chatreply.vip
cooldown: 60
daily-limit: 3
replies:
- "&aReply content {player}"
- text: "&6Weighted random reply"
weight: 10
commands:
- "give {player} diamond 1"
hide-original: false # 隐藏原始玩家消息
更多示例请参阅随附的 replies.yml。
加入欢迎
在 replies.yml 中配置:
join-welcome:
enabled: true
delay-ticks: 40
reply-type: PRIVATE
replies:
- "&a欢迎 &f{player} &a加入服务器!"
ChatReply
Minecraft keyword auto-reply plugin — when players send specific messages in chat, the server automatically sends configured replies. Supports Paper / Spigot / Folia 1.20+ with hot reload (no restart required).
Overview
ChatReply is designed for survival, RPG, and minigame servers that need chat interaction, automatic guidance, rule reminders, and VIP-only responses.
Typical use cases:
- Player sends
Hello in public chat -> auto reply: hi, player!
- Player sends
help -> private message with rule/help tips
- New player joins -> automatic welcome message
- VIP sends
vipkit -> private response + backend give command
- Regex match like
price diamond -> auto reply with item price
All keywords and reply texts are stored in replies.yml. After editing, just run /chatreply reload to apply changes immediately (no server restart needed).
Features
Keyword Matching
| Feature |
Description |
| Exact Match |
Triggers only on exact input (Hello) |
| Contains Match |
Triggers when message contains keyword (aaahelpbbb) |
| Regex Match |
Supports capture groups, use {1} {2} in replies |
| Case Option |
Case-sensitive or case-insensitive |
| Priority |
Higher numeric priority wins when rules overlap |
Reply Types
| Type |
Description |
CHAT |
Public broadcast |
PRIVATE |
Private message to trigger player |
ACTION_BAR |
Bottom action bar message |
TITLE |
Big title + subtitle |
MULTI |
Multi-line segmented reply |
Reply audience is configurable too: SELF, ALL, WORLD, RADIUS:20.
Trigger Rules & Limits
- Public / private / both channel triggers
- World whitelist/blacklist and gamemode limits
- Online-player count, time-range, permission conditions
- 3-level cooldown: global / per-player / per-keyword
- Daily and lifetime trigger limits
- Hide or replace original player message
- Sound effects, backend commands, webhook notifications
Management & Operations
- In-game commands + GUI admin panel (
/chatreply gui)
- Hot reload by module (
config / replies / lang)
- Config import/export backups
- Trigger logs (supports daily rotation)
Compatibility
- Full Folia support
- PlaceholderAPI (soft dependency, optional)
- EssentialsX private message event hook (soft dependency, optional)
Commands
Main command: /chatreply (aliases: /cr, /autoreply)
| Command |
Permission |
Description |
/chatreply reload [all|config|replies|lang] |
chatreply.admin.reload |
Hot reload |
/chatreply add <keyword> <reply> [options] |
chatreply.admin.add |
Quickly add a keyword |
/chatreply remove <keyword> |
chatreply.admin.remove |
Remove a keyword |
/chatreply list |
chatreply.admin.list |
List all keywords |
/chatreply info <keyword> |
chatreply.admin.info |
View rule details |
/chatreply group enable/disable <group> |
chatreply.admin.group |
Toggle a group |
/chatreply test <keyword> [message] |
chatreply.admin.test |
Simulate trigger (no cooldown cost) |
/chatreply toggle |
chatreply.admin.toggle |
Enable/disable plugin |
/chatreply export |
chatreply.admin.export |
Export backup |
/chatreply import <file> |
chatreply.admin.import |
Import backup |
/chatreply gui |
chatreply.admin.gui |
Open GUI admin panel |
/chatreply help |
— |
Show help |
Optional flags for add:
/chatreply add vip &6VIP-only reply --match EXACT --cooldown 60 --perm chatreply.vip
Permissions
| Permission |
Default |
Description |
chatreply.trigger |
everyone |
Allows triggering auto replies |
chatreply.blacklist |
false |
If granted, player will never trigger replies |
chatreply.vip |
OP |
Example permission for VIP keywords |
chatreply.admin.* |
OP |
All admin permissions |
Placeholders
Available in replies, commands, and replace text:
| Placeholder |
Description |
{player} |
Player name |
{world} |
Current world |
{time} |
Server time |
{online} |
Online player count |
{x} {y} {z} |
Player coordinates |
{1} {2} ... |
Regex capture groups |
%placeholder% |
PlaceholderAPI placeholders (requires PAPI) |
Reply prefix (reply-format) example:
defaults:
reply-format: "&8[Bot] &r{message}"
Hot Reload
| Command |
What it reloads |
/chatreply reload |
Everything |
/chatreply reload config |
config.yml |
/chatreply reload replies |
replies.yml (use this after keyword edits) |
/chatreply reload lang |
lang/*.yml |
After editing replies.yml, run reload replies and changes apply instantly.
Config Quick Reference
config.yml
settings:
enabled: true # plugin master switch
language: zh # UI language (zh / en)
update-check:
enabled: true
modrinth-slug: chat-reply
bstats:
enabled: true # bStats switch for this plugin
cooldown:
global-seconds: 0 # global cooldown
player-seconds: 3 # per-player cooldown
notify: true # notify when on cooldown
Common rule fields in replies.yml
keywords:
Example:
match-type: EXACT # EXACT | CONTAINS | REGEX
pattern: "regex here" # used for REGEX
priority: 10
reply-type: CHAT # CHAT | PRIVATE | ACTION_BAR | TITLE | MULTI
reply-audience: ALL # SELF | ALL | WORLD | RADIUS:20
permission: chatreply.vip
cooldown: 60
daily-limit: 3
replies:
- "&aReply content {player}"
- text: "&6Weighted random reply"
weight: 10
commands:
- "give {player} diamond 1"
hide-original: false # hide original player message
See bundled replies.yml for more examples.
Join Welcome
Configure in replies.yml:
join-welcome:
enabled: true
delay-ticks: 40
reply-type: PRIVATE
replies:
- "&aWelcome &f{player} &ato the server!"
评论 0
登录后参与评分
还没有评论,来抢沙发吧