AstroChatBot
v1.0.01.20+AstroChatBot listens to your server chat for configured keywords and posts an auto-reply. Useful for FAQs like "how do I claim land" or "what is the IP".
Overview
On any reasonably busy server the same handful of questions come up over and over: what is the IP, how do I claim land, where is the shop, how do I rank up. AstroChatBot answers them automatically. It watches public chat for keywords you define and, when it sees one, posts the reply you have written, so newcomers get an instant answer and your staff and regulars are not repeating themselves all day.
Matching is configurable so it stays helpful rather than annoying. You group keywords under named triggers, choose case-sensitive or case-insensitive matching, and for more precise control you can use regular-expression patterns instead of plain words. A per-keyword cooldown stops the bot from firing repeatedly when a topic is being discussed, so it answers once and then stays quiet for a set time rather than spamming the channel.
Replies support hex colours so the bot's messages match your formatting, and staff can be given a bypass permission so their own chat never triggers a response, for example when they are explaining something manually. Because the triggers all live in the config and reload in place, you can add a new FAQ answer the moment a new common question appears, without restarting the server.
Who it is for
Busy public servers fielding the same questions repeatedly, communities that want an always-on FAQ answerer in chat, and admins who want to deflect routine queries (IP, claiming, shop, rank-up) automatically so staff can focus on real issues.
Features
- Keyword detection in chat
- Configurable responses with hex color support
- Per-keyword cooldown (avoid spam)
- Case-sensitive or case-insensitive matching
- Regex pattern support
- Bypass permission for staff
Commands
| Command | Description | Permission |
|---|---|---|
/astrochatbot reload | Reload config | astrochatbot.admin |
/astrochatbot list | List configured keywords | astrochatbot.admin |
Permissions
| Node | Description | Default |
|---|---|---|
astrochatbot.bypass | Skip bot triggers | op |
astrochatbot.admin | Use commands | op |
Example Config
# AstroChatBot Configuration
case-sensitive: false
cooldown-seconds: 30
triggers:
ip:
keywords: ["what is the ip", "server ip", "how to join"]
response: "&6Server IP: &eplay.example.com"
claim:
keywords: ["how to claim", "claim land"]
response: "&6Use &e/claim &6to protect your area!"case-sensitive toggles whether matching respects letter case. cooldown-seconds is the per-keyword quiet period after a trigger fires, which prevents spam. Under triggers, each named entry has a keywords list (or regex patterns) and a response line that accepts colour codes. A message matching any keyword in a trigger posts that trigger's response, subject to the cooldown.
Installation
Drop AstroChatBot.jar into /plugins and restart. It listens to the standard chat event and needs no dependencies. On first start it writes a config.yml with example triggers to edit. If you run a chat-formatting plugin that rewrites or cancels the chat event, make sure AstroChatBot can still see messages, and grant your staff the bypass node so their explanations do not set the bot off.
Download
Frequently Asked Questions
How does the bot decide when to reply?
It listens to public chat and checks each message against the keywords under your configured triggers. When a message contains a matching keyword, the bot posts that trigger's response. You control matching with case sensitivity and optional regex patterns, and a cooldown stops it from replying again too soon.
Can I stop the bot from spamming chat?
Yes. The cooldown-seconds setting gives each keyword a quiet period after it fires, so even if a topic is being discussed heavily the bot answers once and then stays silent for that duration. Tuning the cooldown is the main way to keep the bot helpful rather than noisy.
Does it support regular expressions?
Yes. As well as plain keyword lists, triggers can use regex patterns for more precise matching, which is useful when you want to catch variations of a phrase or avoid false positives. If you only need simple word matching, plain keywords are enough.
How do I keep it from triggering on staff messages?
Grant staff the astrochatbot.bypass permission. Messages from players with that node are ignored by the bot, so when a moderator is explaining something manually the bot will not interrupt with an automated reply. The node is op-only by default.
Can responses use colours?
Yes. Each trigger's response accepts colour codes including hex, so the bot's replies can match your server's chat styling instead of appearing as plain text. Set the response string in the config with the codes you want.
How do I add a new auto-reply?
Add a new entry under triggers in config.yml with its keywords and response, then run /astrochatbot reload to apply it live. You can confirm what is currently loaded with /astrochatbot list. New FAQ answers can go live the moment a new common question appears, without a restart.