MinecraftBot
MinecraftBot is 1.5 Compatible
The latest version of MinecraftBot should work with 1.5 with no changes. If however you find a bug, please file a ticket.
MinecraftBot is a plugin that joins an IRC channel as a bot. The bot displays messages coming from Minecraft and sends messages to Minecraft that come from IRC.
The goal of this plugin is to be simple to set up and use. It doesn't have any extra features other than passing messages back and forth. If you are looking for something that does more than just relay messages, you may want to look at MonsterIRC or CraftIRC.
- Bukkit forums: http://forums.bukkit.org/threads/65448/
- Source code: https://github.com/TerrorBite/MinecraftBot
Features
The following events can be relayed by this plugin:
- MC/IRC chat and actions (/me)
- MC/IRC joins and leaves (including IRC part and quit, with quit reasons)
- MC/IRC kick, including kick reasons
- MC deaths
- MC server broadcast messages
- IRC nick changes
- IRC mode changes
- IRC topic changes
Individual events can be disabled in the configuration by simply deleting the appropriate formatting line.
Installation
Simply drop the JAR file into the plugins folder. The plugin will generate a blank configuration file with instructions and then disable itself.
Click here to view the default configuration file.
Permissions
- 'minecraftbot.op' - Equivalent to being a channel op. Allows use of the /irc command.
- 'minecraftbot.manage' - Allows use of the /minecraftbot command to manage the bot. Also allows use of /irc.
- 'minecraftbot.*' - Same as 'minecraftbot.manage'.
Permissions are not required to use this plugin. A Minecraft server op has access to all of these commands.
Metrics
This plugin contains PluginMetrics, which collects and anonymously sends data about how this plugin is being used. It creates a folder named PluginMetrics with a file inside named config.yml. That file gives you the option to opt-out of metrics tracking. This will also opt you out of metrics tracking for other plugins that use PluginMetrics.
More detailed data can be seen at: http://mcstats.org/plugin/MinecraftBot
Commands
In IRC:
- !players - Lists the people connected to the server.
- !time - Shows the time of each regular world (if your server has multiple worlds)
In Minecraft:
- /names and /n - Lists the people that are in the same channel as the bot.
Admin commands:
- /irc - Causes the bot to do something. Some of these commands require the bot to be a channel op.
- /irc say (message) - Causes the bot to say something on IRC
- /irc do (action) - Causes the bot to do something (using /me) on IRC
- /irc op/deop (nick) - Gives or takes the given nick's op status on the channel
- /irc voice/devoice (nick) - Gives or takes the given nick's voice status on the channel
- /irc kick (nick) [reason] - Kicks a nick from IRC. A kick reason may also be entered.
- /irc ban (nick) - Bans a nick on the IRC channel. Does not kick the nick.
- /irc unban (hostmask) - Removes the hostmask from the channel's ban list.
- /irc ignore (nick) - Ignores a nick on IRC
- /irc unignore (nick) - Stops ignoring a nick on IRC
- /minecraftbot - Manages the bot itself
- /minecraftbot connect - Connects to the IRC server
- /minecraftbot disconnect [message] - Disconnects from the IRC server. A quit message may be used.
- /minecraftbot join - Joins the channel defined in the configuration file.
- /minecraftbot part - Parts the channel defined in the configuration file.
- /minecraftbot reload - Reloads all settings except connection settings from the configuration file
Screenshots/Examples
Please send me any screenshots that demonstrate this plugin in a PM.
Hi Rafa,
Is your most recent build compatible with Bukkit #1818 (for MC 1.1)? Thanks.
@CandlejackZA
To get around it, open the MinecraftBot jar and replace the file me/rafa652/minecraftbot/IRCHandler.class with this file: http://dl.dropbox.com/u/5171669/IRCHandler.class
It looks like that server is blocking clients that identify themselves as "PircBot," which is the default IRC bot name. That class file up there changes the name to "MinecraftBot" and that should be enough to let it connect.
Unless the server bans anything that has "bot" in the name...
Edit: I should mention the next version of this bot will have a different GECOS by default.
16:07:43 [WARNING] Could not log into the IRC server: :dante.shadowfire.org 465 MrAwesome:* Your GECOS (real name) is not allowed on this server (unwelcome bot) Please change it and reconnect
Is there any way to get around this?
@allbad1
I haven't thought of that. I'll put those commands in along with a few other useful ones as soon as I can. Thanks for the suggestion!
I have a feature request: can you add an /op or /kick command? Often I find the bot is the only op left after the admins have reconnected. Thanks!
@magicpat2010
I'll look into it. There may be a way to fix it, but at the moment the forums are down so I can't do too much right now.
Edit: I uploaded a new version (0.93-1) that might fix the issue between these two plugins. If this doesn't fix the problem, then the problem could be with Factions not hiding chat messages properly. Let me know if it ends up working.
I'm not sure if there is a way to fix this, but Factions alliance/faction chat appears in the IRC channel, when it is supposed to be hidden.
Any clues as to how to fix this would be great.
also can be configured that only certain irc nickname would be displayed in minecraft chat and can send messages to server?
Hey just a suggestion, maybe instead of <#Kei>, We could make it [IRC] <Kei>
@virology
Are you saying only some groups in Minecraft can see messages? If so, which other plugins do you have installed?
Is there a reason that only some groups can see messages from my irc bot?
It would be nice to see this actively updated, CraftIRC still works but it's no longer supported, plus its color support sucks. ;)
@bigkevin112
I'm very sorry for replying so late. It looks like you forgot to add a # in front of the channel name. Another thing... I don't think SwiftIRC uses a password to let you into their servers. You might have meant to put that password in nickpass instead of password.
I'm having some problems with using this. I'm new to IRC and I would like to use this on my server. I'm using the swiftirc servers. I have created my channel. Put the MinecraftBot.jar into the plugin folder. Set my config.yml to
bot:
nickpass: ''
name: MinecraftBot
server:
port: 6667
server: irc.swiftirc.net
channel:
channel: PixelCrafters
key: ''
password: **********
What am I doing wrong? Do I have to setup a bot on my irc channel? If so what irc channel do I use because swiftirc doesn't allow custom bots.