Project

ronimopi

0.0
No commit activity in last 3 years
No release in over 3 years
Ronimopi (or Robot Ninja Monkey Pirate) is a simple IRC bot based on the Isaac framework. It is designed to be extensible, and is useful for e.g. simple bookkeeping and queries.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
 Project Readme

Robot Ninja Monkey Pirate

A minimalistic extensible IRC bot.

Uses Isaac for a framework. Isaac is (C) 2009 Harry Vangberg harry@vangberg.name and can be found at http://github.com/ichverstehe/isaac.

Author: Ilkka Laukkanen ilkka.s.laukkanen@gmail.com Copyright (C) 2010 Ilkka Laukkanen

Installation

This program requires the Isaac bot framework. To install it, e.g. "gem install isaac".

Create the directory $HOME/.config/ronimopi and copy the provided example config.yml file there. You will find it in the examples directory. Customize the file to your liking.

There are also some plugins for handling !-commands in the examples/commands.d directory. Create a commands.d directory under the config directory you created above, and copy the plugins you would like to use to that directory.

After you have done these things, just run it.

Writing more command handlers is easy-peasy: look at the examples. Whatever you do in the plugins gets evaluated in the context of Isaac's helpers, so take a look at Isaac's documentation too.

Usage

When started, the bot will connect to the server you configured, read all available plugins and join the channels you configured. Then it will sit there.

Whenever a public message starts with an exclamation mark ("!"), the bot will react by calling the associated handler helper: e.g. for a public message "!foo bar baz", the bot will see if it has a helper called "handle_foo" defined, and if it does, it will call that and pass the channel name, the nick of the person who gave the command and "bar baz" as arguments.

In short, if you want it to do anything, code.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.