DSH105's IRC bot. A versatile, modular Java IRC bot using the PircBotX library.
According to Latin (C17
), Nexus can be defined as a binding together
(from nectere
- to bind
). Therefore, Nexus is the bot that brings everyone together.
I like contributions ;D
We're very early in development, but we have the features below in place:
- Modular commands system
- Built-in help system
- Users can PM the bot for info on all commands or to request extended information on a command.
- A few useful commands offering the following functionality:
- A reminder command to ping a user (or yourself) after a set amount of time with a customisable message.
- Currency converter
- GitHub user/repo info retrieval
- IP geolocation with google maps support
- Channel statistics
- Jenkins build info
- Currently hardcoded to our CI server. We hope to make this configurable.
- Temperature converter
- Dogecoin/USD currency converter
- Bukkit user profile info
- Weather lookup command
- 7 day weather forecast
- Actions
- Punch
- Slap
- Whip
- And more..
- Time command
- Some unit testing! We're still working on expanding coverage but the basics are in place.
You can grab the latest builds from our Jenkins instance.
JavaDocs are available on the Jenkins instance. Contributing
See here for contributing guidelines.
You don't really need to worry about that though. The only thing I really want you to follow on that document is the PR formatting.
We'll happily work with you on any PRs to ensure they can be pulled ASAP. 😄
The most common contributions will be in the form of adding a new command. This is a relatively painless procedure. The general steps for doing so are outlined below:
- Fork the repository and clone your fork
- Navigate to the
com.dsh105.nexus.command.module package
in your IDE (in thesrc/main/java/com/dsh105/nexus/command/module/
directory) - Choose the right category for your command, if not create one
- Create a new class that extends the
com.dsh105.nexus.command.CommandModule
class - Add the @Command (
com.dsh105.nexus.command.Command
) annotation to your class and implement the interface - Implement the onCommand method
- In general returning true signifies a valid command (i.e. args were valid)
- Returning false will result in a help message on command usage
You can take a look at the channel stats command to give you a head-start.
We use Maven 3 to build Nexus. Simply run the mvn
command in the project root to compile the code and run the unit tests. You'll get a complete JAR in the target/ directory with the dependencies appropriately shaded for you.
- Allow disabling of certain commands per channel
- Custom command prefix for each channel
- More hooking into GitHub
- Currently per-user authentication with GitHub is implemented (see
ghkey
command). Maybe there's a nicer way to do this instead of having to post Nexus the link?
- Currently per-user authentication with GitHub is implemented (see
- Plenty more commands
- Travis integration (Click for more information)
- See #41 for a list of possible new commands