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