The Discord adapter implements MessagingPort using discord.js. It is the default adapter (ADAPTER=discord).
The Discord adapter uses two channels:
| Channel |
Type |
Purpose |
| Announcement channel |
Text channel |
Receives the ride announcement with a “Join” button |
| Forum channel |
Forum (GUILD_FORUM) |
One thread is created per ride |
/newride — a modal collects the ride details (or imports them from a Komoot/Strava/Garmin URL)- The bot creates a forum thread and pins the ride summary in the starter message
- If no GPX was provided yet, the bot asks the proposer to post the ride’s
.gpx file in the thread
- An announcement is posted in the main channel with a Join this ride button
- When a member clicks Join, they are added to the thread and the pinned summary updates
- If the proposer posts a
.gpx attachment in the thread, the bot parses it, sets the route’s start point (used for weather), reposts the map, and posts the forecast
- The bot sends a day-before reminder (between 9am and 10pm local time) and an hour-before reminder on the day of the ride
| Command |
Description |
/newride |
Open the ride creation modal |
/rides |
List upcoming rides with a join button |
/weather |
Get the weather forecast for a ride (use inside its thread) |
/help |
Show how the bot works (ephemeral) |
All buttons are handled via Discord’s interaction system:
| Custom ID |
Action |
join:<rideId> |
Add the user to the ride and thread |
leave:<rideId> |
Remove the user from the ride and thread |
cancel:<rideId> |
Cancel the ride (proposer only) |
edit:<rideId> |
Open the edit modal |
participants:<rideId> |
Show the current participant list |
| Event |
Behaviour |
guildMemberAdd |
Sends a welcome DM explaining how to use the bot (falls back to the system channel if DMs are closed) |
guildMemberRemove |
Removes the member from all active rides they had joined |
| Event |
Behaviour |
messageCreate |
If the ride’s proposer posts a .gpx file in the ride’s thread, the bot parses it, sets the route’s start point (for weather), reposts the map, and posts the forecast. Ignored for anyone else or outside an active ride thread. |
| Permission |
Why |
Send Messages |
Post announcements and thread messages |
Manage Threads |
Create and archive forum threads |
Read Message History |
Fetch the starter message to edit the pinned summary |
Attach Files |
Post route map images and weather forecast images |
Privileged Gateway Intents required: Server Members Intent (to detect member leaves) and Message Content Intent (to read .gpx attachments posted in ride threads).
