Ample Chat Bot
View the documentation
View the source code on Github
Download the latest version on Github
Report issues and request features on Github
Aid in translating this project to your language on Crowdin
What is this plugin?
Ample Chat Bot is a chat robot that responses to key phrases people say in chat. By doing this, it eliminates the need to answer common questions people ask like "can I be op?".
- Localized for English
- Simple Commands
- Database Support:
- Bukkit
- SQLite
- MySQL
- Bukkit
- API for developers
Requirements
- Bukkit
- Some form of permissions
Commands and Permissions
Command | Permission | Description |
---|---|---|
/ample | Displays commands for this plugin | |
/question <question or keyphrase> | ample.edit | Adds a question or keyphrase |
/answer <question id> <answer> | ample.edit | Sets the answer to a question or keyphrase |
/qlist | ample.qlist | lists questions |
/delquestion | ample.delete | Removes a question from the database |
/amplesay <message> | ample.say | Sends a message as the bot |
Additional Permissions
Permission | Description |
---|---|
ample.* | Gives access to all commands |
ample.invoke | Allows a user to invoke responses |
ample.allowabuse | Allows a user to bypass abuse routines |
Message Format
Ample can not only respond with text, but can also execute commands in chat. Ample can also run commands and send private messages to the player. In order to do this, you use one of the following as a prefix to the message
In addition, you can also have ample do combinations of these by separating them with a ";". For example, the response No you shut up - muted lol;cmd:mute %player
will say the first
part in chat, as well as mute the player.
Prefix | Effect |
---|---|
cmd: | Runs a command as console |
pcmd: | Runs a command as the player |
pm: | Send a private message to the player |
This plugin utilizes Plugin Metrics for collecting statistics about this plugin and usage. These stats can be viewed here.
The bukkit implementation of this plugin uses Updater for automatic updating from the project page at dev.bukkit.org
Yea thanks a bunch bro, this thing is kick @zz! I cant use sql, like you said my sql version is out of date :( . If you can add my server into your servers list. We are on a dedicated host and its a professional server! mc.bigdogspvp.com:25641 link to our MC forum thread: here
@Joe_Schmo2840
I released 1.2.6 (beta version) to weed out the bugs in the newer version of response system I totally rewrote it so it has a bit more power to it. I admit java is not my first computer language I know and it is not one I specialize in but have an understanding of what I am doing. :P It is funny I have no problem with essentials on dev servers and plugins. When I do kick as example: I did a question/key phrase of "kick me" and answer/response "cmd:kick %player you asked for it". Also the id has to be included infront of the response like /answer <id> <response>
Thanks for your input I appreciate your help making the plugin better.
Man this thing is absolutely amazing BUT your coding is somewhat less. :( Im no coder but when I set it up properly with SQL I get errors -get java.sql.SQLException: Before start of result set-. Updated to 1.2.6 and CB-1.2.5R3.0 and get could not pass event to player exceptions. Some commands for essentials/bukkit i.e. kick %player <reason> I get Could not pass event expetions. Soo buggy, but like I said this will be on the top of my lists of plugins to get if you get it working 100% without errors.
@ConFire77
I forgot to say that in 1.2.6+ it has better recognition and it is no longer entirely exact words but still it might not pick it up on long sentences.
@ConFire77
I could add a contains: prefix that will allow it to bypass any checks I do on key phrases. I made it the bot the way it is so it won't print on stuff that was not even related.
@matthewl6970
Can I ask if you're working on doing keywords? Like if I want the plugin to reply to all sentences with the word "help" in it, and not only if the player types exactly: "help"?
@Mirmulniir
It is because you need to add the ample.invoke permission to the permission group(s). I cannot help with bPermissions since I never used it but I can with PermissionsEx.
in PEX you will run /pex group default add ample.invoke
Why only OP's can use bot, when the player typing the keyword or sentence - nothing happens
@Hamnils5
what is not working?
OK, you should definitely make an editor ;) Its a bit weird ingame, plus not everything works.
@Hamnils5
Thank you for your comment. the main reason have not did a flatfile is because of you use some sort of program to access the database directly. The good news for you I planned to do import and export commands on the plugin so you can manage the questions via file and/or move to a new database type in 1.4. Unfortunately I will not be able to place it in 1.3.
Hey, I do love your plugin, though you should definitely program a config.yml or something. Its a bit annoying to manage a lot at once ingame ;) Thanks again for a great plugin!
@PorpoiseBrock
uh I spoke to soon. there is no way I can get around it but I have changed the logging so it is less annoying.
@PorpoiseBrock
I just fixed it in 1.3! say good by annoying errors. lol
As the error I mentioned previously continues to happen, the responses from the Bot become slower and slower to react.
@ConFire77
I agree with this. It would be awesome if a response could be triggered by any use of a word in a sentence.
@matthewl6970
Ok, just giving you the heads up. Thanks for the reply.
Do keywords actually work? I want to have it setup so that if someone types any sentence with "help" in it it will reply. How its setup now if I set it to reply to "help", them saying "help" will work but if they go "help me" nothing. If you do that it will make this amazing. Thank you for such a great plugin.
Also something else I thought of: Deleting a question will delete it, but creating a new question starts from the next number ignoring the delete. For example if I set a question + response on question id 1 then delete it, creating a new question should be number 1, not just ignore the empty space and go to 2.
@PorpoiseBrock
Thank you for sharing. The bug is related to single quotes in the question, answer, or player message. This error is not fatal. I understand it is an annoyance sorry.
I have tried to correct it in 1.2 and will try again in 1.3!
Getting this error from SQLite
http://pastebin.com/ftW2V3PF