Discord bot Configuration

Chronos is a Discord bot that automatically turns Trello cards into Discord scheduled events. It is designed for production use, multi-server setups, and long-running deployments. This is a free extension to Chronos Roblox.

Below is a full documentation-style guide you can paste directly onto a docs page or README. It does not talk about scripts or internals — only what Chronos is, how it works, and how to use it.

---

Invite the Bot

Invite the bot to your discord by running in your Browser

https://discord.com/oauth2/authorize?client_id=1458894097363369994&scope=bot%20applications.commands&permissions=8

After inviting the bot, you are set to configure it and intergreate it with your Roblox Trello Board.

---

What Chronos Bot Does

• Converts Trello cards into Discord Scheduled Events

• Automatically updates events when Trello cards change

• Automatically removes events when cards are archived or moved out

• Supports all timezones automatically

• Uses Discord’s native timestamp system so times appear correctly for every user

• Works across multiple servers (guilds)

• Requires setup once per server

---

How Chronos Works (High Level)

1. You create or move a card into a Upcoming list on your Trello board

2. Chronos reads the card

3. Chronos creates or updates a Discord scheduled event

4. When the event is near, Chronos sends a reminder

5. When the card is removed or archived, the event is removed

No polling. No manual syncing. Everything stays in sync.

---

One-Time Setup (Required)

Chronos must be configured once per Discord server.

Run Setup

In your Discord server, run:

/setup

This command can only be used once. After setup is complete, /settings replaces it.

---

Trello Configuration

You will be prompted to configure Trello.

You will need four things from Trello:

1. Trello API Key

• Go to https://trello.com/power-ups/admin

• Create a new Power-Up

• Open the Power-Up settings

• Copy the API Key

Do not do this if you already have a API key from your Roblox configuration

Trello Token (Write Access Required)

Open this URL in your browser (replace YOUR_KEY with your API key you have just got):

https://trello.com/1/authorize?expiration=never&name=Chronos&scope=read,write&response_type=token&key=YOUR_KEY

Copy the token shown.

The Trello account used must have write access to your Trello board

Do not do this if you already have a Token from your Roblox configuration

---

Trello Board ID (Your trello board)

• Open your Trello board

• On the URL at the end of it type .json

• Do Ctrl + F (⌘ + F) and search for idBoard

• Copy the 24 character long random number and letter text

Example:

695fd76a20dd3c62ea4e2e2e

---

Trello List ID (Upcoming list)

This must be the list you want to use for events.

From Trello card JSON:

"idList": "695fd76a20dd3c62ea4e2e5d"

That value is your Trello List ID.

Only cards in this list become events.

---

Alert Channel

Select the Discord channel where Chronos should send reminders.

This channel will receive:

• 30-minute warnings

• Event notifications

---

Allowed Roles (Optional)

You may select roles allowed to:

• Create events

• Remove events

If no roles are selected, everyone can use the commands.

---

Finish Setup

Once saved:

• /setup becomes locked

• /settings becomes available

• Chronos begins syncing immediately

---

Settings Command

After setup is complete, use:

/settings

This lets you:

• Edit Trello credentials

• Change the Upcoming list

• Change the alert channel

• Change allowed roles

Settings are saved instantly and persist until the bot is removed from the server.

---

Creating Events

There are 2 methods to do this

Trello (Recommended)

Create or move a card into the Upcoming list on the Chronos board.

Card format (description):

start: 14/01/2026 22:45
end: 14/01/2026 00:00
location: XStage Arena

Chronos will:

• Read the card

• Create a Discord scheduled event

• Automatically update it if the card changes

---

Discord Command

Use:

/eventcreate

You will be asked for:

• Event name

• Start time

• End time

• Location

Time Format (Required)

D/M/YYYY HH:mm

Examples:

14/1/2026 22:45
01/12/2026 09:00

Timezone Behavior (Important)

• You enter time in your local timezone

• Chronos converts it to UTC internally

• Discord automatically shows the correct time for every user

No timezone selection required. Ever.

---

Removing Events

There are 2 methods to do this

Trello

• Archive the card or

• Move it out of the Upcoming list

Chronos will automatically remove the Discord event.

---

Discord Command

/removeevent <event name>

Chronos will:

• Remove the Discord scheduled event

• Archive the Trello card (if applicable)

---

Help Command

Use:

/help

This shows:

• All available commands

• Short explanations

• Current usage rules

---

Persistence & Reliability

• Configuration is stored permanently per server

• Events survive restarts and redeploys

• Chronos will resync automatically after downtime (if downtime happends)

• Events are never duplicated intentionally (might accidently happen but are quickly identified)

---

Important Notes

• Chronos only reads one list (your selected list)

• Only cards in that list become events

• Trello tokens must have write permission

• If permissions change, re-run /settings

---

Completed

You have now hopefully successfully configured the Discord bot, we are simuntalesly working on a simper way to configure this, please give us time 🙏, Scripting discord bots is very hard and even harder if you have to intergrate systems to it which you have not created.

Thank you for using Chronos.

---