Configuration
If you start the server it will generate a config that doesn't do anything but create the default config.
Default config link if you prefer to do it yourself, put it in ./plugins/AnHeroBridge/config.yml
Now read this page to get it working.
AnHeroBridge side of the config
Just give names to the craftirc tags that represent herochat channels, like this:
AnHeroBridge:
bridges:
bridge-global: Global
bridge-admin: Admins
#some-tag: SomeHerochatChannel
Here "bridge-global", "bridge-admin" and "some-tag" are names of craftirc tags, which represent craftirc's side of the bridge (Sometimes called "endpoint"). CraftIRC tags can be any valid word as long as they aren't in use already (For example, you can't use "minecraft"). If this happens you'll get a warning at startup.
"Global" and "SomeHerochatChannel" are herochat channel names.
The config file also allows you to add a player list command, read this page for instructions on how to configure it
CraftIRC side
On the CraftIRC config.yml file you have to do a few extra things.
Find the parts of the config equivalent to the following code blocks and do the specified changes.
auto-paths
Disable auto-paths, otherwise the plugin will just refuse to work. Trust me, it's better for everyone.
auto-paths: false
IRC Channel config
Let's suppose you have a channel called "#anherocraft" and another called "#anherocraft-admin". I'll be skipping most of the channel settings, but here's what you need to change:
channels:
- name: '#anherocraft'
tag: 'irc-anherocraft'
- name: '#anherocraft-admin'
tag: 'irc-anherocraft-admin'
Again, tag names are arbitrary, and MUST be different to the others.
Paths config
Paths connect the tags we defined in the bridges list (such as "bridge-global") and the tags defined for each channel (such as "irc-anherocraft"). Since each path goes in a single direction, you must define two paths for each bridge. Example:
paths:
# two paths for the global bridge
- source: 'irc-anherocraft'
target: 'bridge-global'
- source: 'bridge-global'
target: 'irc-anherocraft'
# another two paths for the admin bridge
- source: 'irc-anherocraft-admin'
target: 'bridge-admin'
- source: 'bridge-admin'
target: 'irc-anherocraft-admin'
Each path can also have additional settings, such as filters or custom formatting. Check the default CraftIRC config for details on that, it's full of comments.
Joins/quits/kicks/deaths
These events are not handled by herochat, you can only get the global ones, that is, joining the minecraft server instead of joining a herochat channel.
To send global joins/quits/kicks/deaths to the "irc-anherocraft" channel, do this:
- source: minecraft
target: irc-anherocraft
It looks like a normal minecraft path, but it's everything except chat.
Also, if you want /say to get sent to irc:
- source: console
target: irc-anherocraft
Problems?
If you've read this whole page, checked that the YAML syntax of both config files is correct, and still have issues, you can join #craftirc on irc.esper.net, ask your question, and wait patiently for an answer. Here's a webchat link for the lazy