Soren Knowledgebase
Full command reference, FAQ, and everything you need to get the most out of Soren.
/setup. Server admins always have access to all commands.
General
/ping
Check bot status, latency, uptime, and version info.
Everyone
/help
Show all available commands in a quick reference embed.
Everyone
/premium
View the free vs. premium feature comparison and pricing.
Everyone
Setup & Config
/setup
First-time server setup. Assigns the Event Creator role.
Admins
/config
View current server configuration and settings.
Admins
/embedcolor
Choose the color for event embeds (3 free, 8 premium).
Admins
/premiumcode
Redeem a premium activation code for your server.
Admins
Events
/newevent
Create a new event via a 4-step guided flow: type → timezone → reminder → details.
Event Creator
/editevent
Edit an existing event by its ID (slash command fallback).
Event Creator
/deleteevent
Permanently delete an event and its embed.
Event Creator
/cancelevent
Soft-cancel an event (marks as cancelled without deleting).
Event Creator
/listevents
View all upcoming events in this server, paginated.
Everyone
/myevents
List events you've RSVPed to (accepted or tentative).
Everyone
/eventbuttons
Customize RSVP button labels and toggle the Tentative button.
Event Creator
Google Calendar Sync
/gcal connect
Connect a primary Google Calendar to push new /newevent events into.
Admins
/gcal verify
Complete the Google Calendar OAuth connection with your auth code.
Admins
/gcal disconnect
Remove the primary Google Calendar connection.
Admins
G-Cal Integrations
/gcalint add
Connect a Google Calendar for automatic weekly digest summaries.
Admins
/gcalint verify
Complete auth and pick which calendar to use from your account.
Admins
/gcalint list
View all connected calendars and their posting schedules.
Admins
/gcalint remove
Disconnect and remove a calendar integration.
Admins
/gcalint pause
Pause or resume auto-posting for a calendar.
Admins
/gcalint post
Manually trigger a summary post for a calendar right now.
Admins
Frequently Asked Questions
Supported Timezones
These timezones are available in the /newevent timezone picker.
The edit modal also accepts any valid
IANA timezone name.
| Label | Timezone ID | Offset |
|---|---|---|
| Eastern Time (ET) | America/New_York | UTC-5 / UTC-4 DST |
| Central Time (CT) | America/Chicago | UTC-6 / UTC-5 DST |
| Mountain Time (MT) | America/Denver | UTC-7 / UTC-6 DST |
| Mountain Time — AZ | America/Phoenix | UTC-7, no DST |
| Pacific Time (PT) | America/Los_Angeles | UTC-8 / UTC-7 DST |
| Alaska Time (AKT) | America/Anchorage | UTC-9 / UTC-8 DST |
| Hawaii Time (HT) | Pacific/Honolulu | UTC-10, no DST |
| Atlantic Time (AT) | America/Halifax | UTC-4 / UTC-3 DST |
| Newfoundland Time (NT) | America/St_Johns | UTC-3:30 / UTC-2:30 DST |
| London (GMT/BST) | Europe/London | UTC+0 / UTC+1 DST |
| Berlin (CET/CEST) | Europe/Berlin | UTC+1 / UTC+2 DST |
| Sydney (AEDT/AEST) | Australia/Sydney | UTC+11 / UTC+10 |
| Tokyo (JST) | Asia/Tokyo | UTC+9, no DST |
| New Delhi (IST) | Asia/Kolkata | UTC+5:30, no DST |
| UTC | UTC | UTC+0 |
Database Overview
Soren uses SQLite stored at data/soren.db.
All tables are created automatically on startup — no manual setup required.
New columns added in updates are applied via ALTER TABLE migrations so you never need to wipe your database.
guild_config
Per-server settings — Event Creator role, premium status, Google Calendar token, and embed color.
events
All events created via /newevent. Includes recurrence rules, reminder config, and button label overrides.
rsvps
One row per user per event. Cascades on event delete. Tracks accepted, declined, and tentative statuses.
gcal_integrations
Connected Google Calendars for the G-Cal Integrations feature. Each has its own OAuth token and posting schedule.
redeemed_codes
Tracks which premium codes have been used. Prevents double-redemption. Valid codes live in premium_keys.txt, not here.