A friendly general-purpose Discord bot
Go to file
Beatrice DellacĂ  7f73d4fb23
All checks were successful
continuous-integration/drone/push Build is passing
Fix shutdown method no longer shutting down when invocated directly
2023-01-16 02:11:16 +01:00
src/main Fix shutdown method no longer shutting down when invocated directly 2023-01-16 02:11:16 +01:00
.deepsource.toml Add .deepsource.toml 2023-01-14 19:16:58 +00:00
.drone.yml Enable arm64 for Drone CI 2023-01-16 01:47:58 +01:00
.gitignore Ignore SQLite database 2022-11-21 00:28:29 +01:00
pom.xml Add info about random.org 2023-01-15 23:02:41 +01:00
README.MD Update repo URLs 2023-01-16 00:33:52 +01:00
settings.xml Update DroneCI configuration, include settings.xml 2023-01-15 21:38:50 +01:00

HidekoBot

Reliability Rating Maintainability Rating Security Rating Build Status Lines of Code

Hideko is a general-purpose Discord bot.

Download

The latest stable version is always uploaded automatically to the Maven repository.
You can download the JAR directly by clicking here.

Startup

Download a prebuilt JAR file or build it from source, then run it with:

java -jar HidekoBot.jar [additional parameters]

Where HidekoBot.jar is the executable archive and [additional parameters] are arguments that you can add to make the bot change its behavior.

Additionally available parameters are:

  • verbose: log every message that the bot receives, plus additional debugging messages. Very spammy and performance heavy.
  • refresh: force refresh the slash commands. This is useful in case there was a simple update to a command that did not drastically change it, so no changes are found at bootup (eg: fixing a typo in the command description).

Note: Java 16 or later is required.

Initial setup

Run the startup command once. The bot will generate a config.yml file in your current directory ($PWD on GNU/Linux).

Edit the configuration file and set all values according to your needs.

Save the file and start the bot again. If there are no issues, everything will load and it will print an invite-link in your console. Click on the link to add your bot to any server with the correct permissions already set-up. The bot supports both slash commands and message commands, with prefix hideko. Most commands support both systems, but some of them are limited in one way or another.

The bot currently supports SQLite as a database backend. A database file will be created after the first boot in your current directory. Do not delete the database file to avoid corruption and unpredictable behavior.

Development

Versioning

This project uses the x.y.z-releaseType schema for releases.
Development builds are tagged as x.y.z-SNAPSHOT and sometimes pushed to the snapshots Maven repository.
Stable builds are tagged as x.y.z and always pushed to the releases Maven repository, by promoting the build on Drone. Currently, promoting stable builds is a manual process.