the all-in-one wiki bot

Add to server

Setup

Requirements

• Node.js 17.3 or newer
• A Discord application and bot token from the Discord Developer Portal

Installation

1. Clone the repository and enter its directory:

   git clone https://github.com/utgwiki/derik.git
   cd derik

2. Install the dependencies:

   npm install

3. Create your environment file from the example:

   cp .env.example .env

4. Open .env and replace your_discord_token_here with the bot token from the Discord Developer Portal. The web server uses port 3000 by default; set PORT to a different value if needed.

5. Start the bot:

   npm start

Configuration

Most bot behavior is configured in config.js. Restart the bot after making changes.

• WIKIS — Define the wikis supported by the bot. Each entry contains the wiki name, MediaWiki API endpoint, article URL, message prefix, and emoji.
• WIKI_MAP — Map Discord channel or category IDs to a wiki. This controls which wiki is used when a message does not include a wiki prefix.
• STATUS_OPTIONS — Customize the bot’s rotating Discord status messages and activity types.
• STATUS_INTERVAL_MS — Set how often the bot rotates its status. The default is five minutes.
• PAGE_CACHE_MS — Set how long page lookups stay cached in memory. The default is 30 minutes.
• COMMANDS — Enable or disable individual slash commands. Set a command to false to prevent it from being registered with Discord. Available slash commands are speedrun, contribs, wiki, parse, user, random, and cosmetic; tracker controls the background Roblox tracker.
• SPEEDRUN_EMOJI and CONTRIBSCORES_SCORE_EMOJI — Set the custom emoji IDs used by those features.
• TRACKER — Configure the Roblox tracker. Set roleId to the role that should be pinged, distribution to map Discord channel IDs to one or more Roblox universe IDs (not place IDs), and frequency to the visit milestone interval. intervalMs controls how often Roblox is checked and defaults to three minutes.

The tracker announces visit milestones, game updates, and newly added subplaces. It stores its last-seen values in tracker/visitchecker.json. Set COMMANDS.tracker to false to disable all tracker checks and role pings; the tracker will not start at all in that mode.

When adding a wiki, add its configuration to WIKIS and update WIKI_MAP or the relevant status messages as needed. Discord channel, category, and emoji IDs can be copied using Discord’s Developer Mode.

Web server and Instatus

bot/server.js starts a small web server so Instatus can check whether the bot is active. It listens on 0.0.0.0 and uses the PORT value from .env (or port 3000 when it is unset). The file is part of the bot’s normal startup through index.js; it can be removed if Instatus monitoring is not needed, provided the corresponding require("./bot/server") line is also removed from index.js.