Bukkit

About PurpleIRC

PurpleIRC is an IRC to Minecraft bridge plugin. This plugin supports running multiple bots on multiple channels. This plugin utilizes the PircBotX Java IRC framework (included in the plugin jar).

Wiki

• For additional information see the PurpleIRC Wiki.

Features

• Relay chat from game to IRC and vice versa.
• Relay game events to IRC.
• Relay IRC events to game.
• Translate colors from game to IRC and vice versa.
• Fully configurable message templates.
• Enable or disable any chat feature to and from the game.
• Most of the configuration options are per bot and per channel.
• Each bot can join multiple channels.
• Automatically op IRC users based on user masks.
• Control and protect the IRC topic.
• Manage IRC channel modes.
• Automatically reconnect to the IRC server on disconnect.
• Respond to commands in IRC chat.
• Send any command to the game via the console.
• Supports prefixes and suffixes. (see sample config for details)
• Displays IRC users in the tab list. (requires ProtocolLib)
• Monitor player command usage.
• Great for cross server chatting.
• Update checker will make external HTTP connections to check for new versions.
• SSL/TLS support.

CraftBukkit Versions

• If you are running CraftBukkit version 1.7.2 or older then stick to PurpleIRC version v2.1.14-174 and older.
• If you need a version that supports Spigot visit the Spigot Resource Page.

How to install

1. Drop the PurpleIRC.jar file into your plugins directory.
2. Restart the server. (Please don't use /reload)
3. Copy plugins/PurpleIRC/sample bot to plugins/PurpleIRC/bots/NewBotName.yml
4. Edit the bot yml file as needed. Each option is documented.
5. Use /irc load bot.yml command to load and start the new bot.
6. Configure permissions.

Configuration

• Configuration - Use /irc reloadconfig to load your changes while the bot is running.
• Sample Bot - Use /irc reloadbotconfigs to load your changes while the bot is running.

Frequently Asked Questions

• FAQ

Links

• Dev Builds
• PircBotX
• Source
• Configuration
• Sample Bot
• Spigot Resource Page

Chat Hooks

• Supports mcMMO admin and party chats.
• Supports FactionChat chat modes. (public, ally and enemy)
• Supports HeroChat Global, all channels or specific channels.
• Supports TitanChat chat manager.
• Supports TownyChat chat manager. See FAQ.
• Supports Dynmap web chat.
• Supports AdminPrivateChat

Other Hooks

• Supports CleverNotch bot messages.
• Supports ReportRTS ticket notifications.
• Supports VanishNoPacket. Prevents IRC from announcing vanished players.
• Supports Shortify URL shortener. 1.8 and newer only
• Supports RedditStream notifications.
• Supports SuperVanish

Dependencies

• PircBotX: The PircBotX classes are included in the plugin jar file.
• Vault. If you need to use the %GROUP% token then install Vault.
• ProtocolLib. If you need to use the custom tab list then install ProtocolLib.

Permissions (see plugin.yml)

Commands

IRC User Modes

Change Log

• Change Log

Known Issues

• AuthMe: If you are running the AuthMe plugin you will need to set enableAntiBot to false.

Additional Help

• Tickets: Please reports bugs using the ticket tracker.
• IRC: I'm usually hanging out in #PurpleIRC on irc.esper.net. If I'm awake you can chat with me there.
• PM: Feel free to send me private messages here.

Other

Bitcoin: 1P44sYgXLejo35vANvNfPTY56ANSC5w4dg