Note

TheOracle2 has been merged into the existing TheOracle github repository. You can find it here: https://github.com/XenotropicDev/TheOracle

About

TheOracle2 is a complete rework of TheOracle using new discord bot features, and more integrated data features

1. This is very much a beta product. Expect things to not work.
2. If you run into any bugs, have an idea, or want to contribute please make an issue here, or post in the Ironsworn #bot-discussion channel.

Joining the bot to your discord server

To add TheOracle to a discord server click this link and then select the server you wish to add the bot to.

If you need a discord server for your game you can use this link to get started with a preexisting discord server template.

Other features

Recreate message:

You can recreate a message, similar to the old ⏬ reaction method by right clicking a bot message and selecting recreate message from the apps menu. Unfortunately this isn't supported by discord on mobile (at the time of writing this). In the mean time adding an ⏬ reaction should still work on all messages.

Running the bot yourself

note: This is for people that want to change the source code and run their own instance of the bot. It's not something most users will want/need to do.

• Install PostgreSQL Server
• Create a new database and db user for the bot to use
• Create a database settings file named dbSettings.json so the bot knows how to connect. It should have a structure similar to this:

{
    "dbConnectionString":"Host=localhost;Port=5432;Database=NameOfDbYouCreated;Username=BotDbUser",
    "dbConnectionStringWithPort":"host=127.0.0.1 port=5432 dbname=NameOfDbYouCreated connect_timeout=10 user=BotDbUser",
    "dbConnectionStringOff":"postgresql://BotDbUser@localhost:5432/NameOfDbYouCreated",
    "dbPassword":"YourDbUserPassword"
}

• Get a discord bot token from the discord developer portal
• Start the bot server, paste your token when prompted. (If you need to change the token it's stored in the token.json file in your server's folder)

Privacy

TheOracle bot doesn't store any user data of any kind, except for commands that are explicitly handled by the bot. Any data collected will not be sold or used for anything other than further developing and improvement of the bot.