Home

Below is how you can set up and configure Bartholomew, the bot.

Setup

Please note that server.js exists on the repository so that Instatus is able to get active status of the bot. It can be removed.

1. Prerequisites

   • Node.js (v16.11.0 or higher recommended)
   • A Discord Bot Token (from the Discord Developer Portal)
   • The Universe ID of your Roblox game.

2. Installation

   • Clone the repository and install dependencies:

     git clone https://github.com/utgwiki/bartholomew.git
     cd bartholomew
     npm install

3. Running the Bot

   • To start the bot, run:

     node announcer.js

Configuration

• Copy .env.example to .env (this preserves the template for others).

• Open .env and fill in your details:

  Variable	Description
  TOKEN	Your Discord bot token.
  FREQUENCY	How often to announce visit milestones (e.g., 10000).
  UNIVERSEID	The Roblox Universe ID (NOT the Place ID).
  CHANNELID	The Discord channel ID for announcements.

How to find your Universe ID

To get your Universe ID from a Place ID, visit: https://apis.roblox.com/universes/v1/places/{YOUR_PLACE_ID}/universe

Tracking multiple games

You can track additional games by adding numbered environment variables:

UNIVERSEID_2=YOUR_SECOND_UNIVERSEID
CHANNELID_2=YOUR_SECOND_CHANNELID

Important: Numbered pairs must be contiguous (no gaps like UNIVERSEID_2 then UNIVERSEID_4). The bot scans sequentially and will stop at the first missing pair (e.g., if UNIVERSEID_3 is missing, UNIVERSEID_4 will be ignored).