How do I install AstroChatBot?

Download AstroChatBot-1.0.0.jar and place it in your server's plugins/ folder. Restart the server.

What Minecraft versions does AstroChatBot support?

AstroChatBot supports Paper 1.20+.

Documentation

Complete guide for AstroChatBot v1.0.0.

Installation

1
Download the plugin
Get AstroChatBot-1.0.0.jar from the download page.
2
Upload to your server
Place AstroChatBot-1.0.0.jar in your server's plugins/ folder.
3
Restart the server
Run /stop to shut down, then start the server again. Do not use /reload.
4
Verify installation
Check the console for "[AstroChatBot] Enabled" or run /plugins.
5
Configure
Edit plugins/AstroChatBot/config.yml. Use the reload command to apply changes.

Requirements: Paper, Purpur, or Folia server running Minecraft 1.20+. Java 21+.

Configuration

The default config.yml is generated on first run. Edit and reload to apply changes.

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

Config location

plugins/AstroChatBot/config.yml

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

Tip: Use LuckPerms to manage permissions per player or group.

Examples

Basic setup

Drop AstroChatBot-1.0.0.jar into your plugins folder and restart. The default settings work for most servers.

Permission setup with LuckPerms

# Grant permission to a group
/lp group default permission set astrochatbot.bypass true

# Grant permission to a player
/lp user <player> permission set astrochatbot.bypass true

Troubleshooting

Plugin does not load

Make sure you are running Paper (or Purpur/Folia) 1.20+.
Check that the JAR is in the correct plugins/ folder.
Look at the server console for errors during startup.
Make sure you have Java 21 or higher.

Config changes not applied

Use the reload command instead of restarting.
Check for YAML syntax errors — missing colons, wrong indentation.
Use a YAML validator to check your config file.

Permission denied errors

Make sure the correct permission nodes are assigned via LuckPerms.
OP players bypass permissions by default — test with a non-OP account.
Check that your permissions plugin loads before this plugin.

FAQ

Is AstroChatBot free?

Yes, completely free and open source under the MIT License.

Does it work with Spigot?

AstroChatBot is built for Paper API. It may work on Spigot but is not officially supported.

What versions does AstroChatBot support?

Currently supports 1.20+. We update for new versions as they release.

How do I get support?

Join our Discord, email [email protected], or submit a bug report on the issues page.

Can I modify the source code?

Yes. AstroChatBot is MIT-licensed. Fork the repo and build your own version.

← Back to AstroChatBot ✎ Edit on GitHub