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.


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.


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.


  • '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.


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



  • !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


Please send me any screenshots that demonstrate this plugin in a PM.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of therennon therennon Nov 10, 2014 at 01:01 UTC - 0 likes

    Work perfect in minecraft Spigot 1.7.10


  • Avatar of leiger leiger Jul 08, 2013 at 23:27 UTC - 0 likes

    Carlo - It might work in the main channel, but definitely won't show custom Herochat channels in IRC. Perhaps test it out.

    If you donate, you are awesome :)

    Plugins: LDLogger, KeepItems, PluginWall, contributor to MinecraftBot

    Public test server: s.mcleiger.com

  • Avatar of carlgo11 carlgo11 Jul 01, 2013 at 23:29 UTC - 0 likes

    Does it work with HeroChat?

    Owner of The PortalCraft.Se Servers
    Mail: [email protected]
    IRC: http://tiny.cc/carlgo11-irc

  • Avatar of PurpleShyGuy PurpleShyGuy Jun 13, 2013 at 22:24 UTC - 1 like

    Is it possible to disallow messages to pass from IRC to MC, and instead use a command to chat with people ingame?

    Example: !say [message here] *sends message to everyone in MC*

  • Avatar of Ghaelito Ghaelito May 15, 2013 at 09:12 UTC - 0 likes

    Is a best IRC plugin, I try 10 or 15 but none of them is better than yours.

    Works Perfect in 1.5.2-R0.1

    Thanks You.

  • Avatar of jairagwani jairagwani May 06, 2013 at 09:40 UTC - 0 likes

    Works perfect on 1.5.2 beta release, nice job! :) Hope we get an update soon!

  • Avatar of jakja2 jakja2 Apr 30, 2013 at 23:38 UTC - 0 likes

    Can you please add a permission node for /irc ignore and /irc unignore.

  • Avatar of Crazdale Crazdale Apr 18, 2013 at 16:13 UTC - 0 likes

    Running this on the newest Bukkit 1.5.1 Beta release. Your plugin works perfectly, installed easily, and basically, runs like a champ! Great job! ;)

    Plan on running this one for awhile. No errors, no complaints, it just does what it is suppose to do. Good luck on your future releases! ^-^

  • Avatar of Zombine911 Zombine911 Apr 04, 2013 at 07:06 UTC - 0 likes

    I don't get any errors, but the bot doesn't send any chat to my IRC channel, nor can I get it registered with NickServ.

    Any tips?


  • Avatar of qwertyjl qwertyjl Mar 30, 2013 at 05:30 UTC - 0 likes

    @leiger: Go

    I'm using essentials 2.10.1 and MinecraftBot 2.3.0. Both of them are the same on both servers I have. The plugin works perfect on my MCPC+ server, but not on my Bukkit server.



Date created
Oct 03, 2011
Last update
Feb 28, 2013
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files