/wanshitong

Discord bot for collecting items

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

Wan Shi Tong

Discord bot for collecting items

Installation

Create a file config.json with informations as shown in config.json.example.

Execute node dbInit.js to initialize the database and populate it with predefined characters (courtesy of Realms of Fantasy).

Execute node deploy-command.js -g to deploy the commands for all guilds of your bot. If you execute node deploy-command.js this will only deploy the commands for the guild defined in config.json

Help

Use /help to view all commands, and /help <command> to view every subcommand an options for <command>.

Permissions

Permissions to use a slash command are handled in Settings > Integrations > Wan Shi Tong (or the bot's name you used when you hosted it). There you can allow or deny the usages in specific channels, for specific roles or users, of specific commands or all of them.

It is recommended to allow only the usage of /inventory, /leaderboard and /help for players.

Game master

You can (and must) configure the bot by using /configuration (every action is describe in the command data).

After having set a channel (using /configuration dropchannel) and an chance to spawn (using /configuration occurancedrop), you need to load characters to allow them to spawn. You can do so by using /game load to load all characters from a serie or character load to load a specific character.

Players

Gameplay

Whenever a message is posted in a channel where the bot can listen, there is a chance (defined by /configuration occurancedrop) to spawn a character in a channel (defined by /configuration dropchannel). The first user to give the correct phrase (defined by /configuration commandclaim) is rewarded with an item for the character.

When a user has collected all the items, they are awarded a special role (defined by /configuration rolecomplete) and a fox emoji is added on the leaderboard.

Inventory

Users have an inventory where all their items are, and then can display it whith /inventory. This command will display all items from characters that are available on the guild, and are not event characters.

To display the inventory for a specific serie, use the command /inventory <serie> and to view the inventory of event characters, use /inventory event.

Leaderboard

A leaderboard is available with the command /leaderboard. Every users that have acquired an item are in the leaderboard.