A Discord bot that monitors Roblox client versions and sends notifications when new updates are detected.

TypeScript 100%

Find a file

theo 88d0ba9f15 All checks were successful Build / build (node-20) (push) Successful in 1m7s Details Build / build (node-22) (push) Successful in 11s Details fix event detection & command detection		2026-07-16 14:55:46 +01:00
.forgejo/workflows	add build workflows	2026-07-13 20:32:28 +01:00
.github/workflows	add build workflows	2026-07-13 20:32:28 +01:00
src	fix event detection & command detection	2026-07-16 14:55:46 +01:00
.env.example	add CLIENTSETTINGS_BASE as an env var because i keep forgetting to change it back	2026-07-16 13:30:05 +01:00
.gitignore	initial commit	2026-07-13 20:14:23 +01:00
LICENSE	fix typo	2026-07-13 20:48:42 +01:00
package-lock.json	initial commit	2026-07-13 20:14:23 +01:00
package.json	refactor structure and make stuff more modular	2026-07-16 14:46:17 +01:00
README.md	forgot a newline	2026-07-14 22:12:07 +01:00
tsconfig.json	initial commit	2026-07-13 20:14:23 +01:00

README.md

Roblox Update Tracker

A Discord bot that monitors Roblox client versions and sends notifications when new updates are detected. The bot monitors Roblox client version channels, detects future releases through ZBeta.

Add to your server

If you do not want to host your own instance of the bot, you can use the one hosted and managed by me! The bot should have 100% uptime so don't worry.

-> Authorization Link

Features

Monitors Roblox client version channels
Detects upcoming updates through ZBeta
Sends Discord embeds for new releases
Detects version reverts
Supports multiple Discord servers and alert channels
Custom notification messages per alert channel
Uses Discord slash commands for configuration

Requirements

Node.js 20+
A Discord bot application

Installation

Clone the repository:

git clone https://git.imtheo.lol/theo/RobloxUpdateTracker.git
cd RobloxUpdateTracker

Install dependencies:

npm install

Create your .env:

cp .env.example .env

Edit .env
Register slash commands:

npm run register-commands

Start the bot:

npm run build && npm run start

Commands

`/alert add`

Adds update alerts to the current channel.

Options:

channel
- The Roblox channel to monitor
message
- Optional custom message sent with the alert

Example:

/alert add channel:LIVE message:@everyone

`/alert remove`

Removes alerts from the current channel.

Example:

/alert remove channel:LIVE

`/alert list`

Lists configured alerts.

Development

Run in development mode:

npm run dev

Note

Pull requests and issues should be created on git.imtheo.lol, not GitHub.

License

This project is licensed under the MIT License.