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

Reply Types

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)

Optional flags for add:

/chatreply add vip &6VIP-only reply --match EXACT --cooldown 60 --perm chatreply.vip

Permissions

Placeholders

Available in replies, commands, and replace text:

Reply prefix (reply-format) example:

defaults:
  reply-format: "&8[Bot] &r{message}"

Hot Reload

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!"