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.
@prizna123
If you compare it to the current default configuration here, they are on lines 77-86. The default formatting lines makes every line coming from IRC start with "#>".
If the plugin not displaying lines that way, then either you're using an old version of the plugin or for some reason the IRC server is telling the bot that each nick begins with a #.
@prizna123
Most older versions do that by default. The newest version (and even a few before that) allows you to change the way each line looks in order to remove the # from the start of each line and even change how the entire line is displayed.
Disabling the message shown when using !players - yes, there'll be an option for that added soon as well as a few other options.
@Wolfdogmp
I was afraid of that happening again sooner or later... Which OS are you running the plugin on?
If it's being used in Linux (or anything else that vim on it), you could try doing this: http://dev.bukkit.org/server-mods/irc-minecraftbot/?comment=47
On Windows, you could open it in Notepad
++
and go to Encoding -> Convert to ANSI.Java has this flaw where it will read files differently depending on which system it's on. The section symbol is encoded in files differently on Windows systems and on everything else that uses UTF-8 as the default file encoding.
At the moment if someone talks in the IRC, they have a "#" in front of their name when it comes thru on Minecraft, is there a way that I can change this?
Also is there a way to stop it telling in game that somone in the irc asked for the player list?
thanks,
@Rafa652
I'm getting this error on 2.0.1 http://pastie.org/3764649
@nipper4369
Some questions:
Edit: And by new version, do you mean 2.0.0 or 2.0.1? 2.0.1 fixes the issue you're looking at (I hope - I've tested it only on two machines) but right now it doesn't look like it's been approved yet so it doesn't appear in the sidebar right now.
new version I get this error http://pastebin.com/bApmJHfd
I put up a fix. It generates the right type of file depending on the system now. Sorry it took so long.
the character encoding on the default file is borked. So if you're on linux open the config.yml with vim and do this command:
:write enc=utf-8 config.yml
then restart.. and things should work again.
@MightyFlyRudy
I don't know of any. Sorry for the late reply.
@Rafa652
Ah, thanks. It might be easier to just switch. Do you know of any death message plugins that would work with yours?
@MightyFlyRudy
Looks like LoginMessage deletes the death message instead of editing it so that other plugins can use it. Nothing I can do about it. You could try bringing this issue up with them.
As for the '10' showing up in messages, I'm not sure what could be causing that. Could it be that your IRC client doesn't support color codes?
@MightyFlyRudy
I'll look into it soon enough. These next few days are going to be busy for me. Thanks for letting me know. That 10 is the color code for the whole message. If it gets annoying, you can just set the color for event messages to "normal" instead of "teal" for now.
@ViscousSummer88
I should have added what the control code is. The Minecraft Wiki shows that the control code is a &, but I think that's only for classic servers. The actual control code is the section sign ยง which you can put in place of the &.
@benlundquist
I don't believe it supports it. :/
I was looking for how to do that too >.<
Could you show an example of using color codes in the config?
I'm trying this: mc: '&8cvbot &8%name% &7%message%'
But the colors aren't substituted, the string comes through as is :/
Any advice? Thanks in advance.
SOLUTION: Use ยง not & for the color codes
@Rafa652
Thanks for the update, Rafa652. The good news is that the plugin no longer throws errors upon death. The bad news is that the death messages aren't showing up on IRC. Also, when showing the join/quit messages in IRC, the number '10' seems to show up for some reason.
10[MC] rudedoggx10 joined the game10 10[MC] rudedoggx10 left the game10
I have the irc_me set up like this:
irc_me: '[MC] %name% %message%'
@MightyFlyRudy
That's probably it. It appears that LoginMessage deletes the death message and this plugin doesn't expect the death message to be blank. I'll put up a fix for it in a few minutes.
@Rafa652
Okay, I've updated by CB build to the latest dev version, it's still having an error with death events. Could it be because I'm using a plugin to modify the death messages (LoginMessage)?
I have been using this plugin for about 2weeks now. This is the type of plugin i have been looking for we have IRC but i wanted to simply relay the chat both ways! This works like dream, perfect.
@Rafa652
seems there was an issue somewhere between the VPS that relays the IRC traffic and the ircd. asked the opers to look into it + tweaked the firewall some and issue seems to have been resolved. thanx for your time tho :) if I figure out what resolved it exactly I will post.