Events

Announcing an event, running it, and ending it.

Module: events (off unless switched on)

Hosting an event

/event start

Discord will ask you for:

Box	What to put in it	Required?
event_type	What kind of event, e.g. ssu	Yes
game	Which game, e.g. tom_classic	Yes
note	Anything extra people should know	No
publish	Show it on the public website calendar	No — off unless you tick it

The event type and game come from a list your admin set up. Start typing and Discord suggests them. If nothing is suggested, none have been set up yet — that's an admin job, see below.

The bot posts the announcement, pings whichever roles are configured, and puts an End button on it.

Ending it

Press End on the announcement. That's it.

• The post is replaced with "Event Ended" and an Undo button.
• Undo works for a short window in case you hit End by mistake.
• The post deletes itself after a few minutes.

Putting it on the website

Tick publish: True when you start it.

It's off unless you tick it, on purpose. Events go on a public page that anyone can see, and most internal training runs shouldn't be there.

For publishing to actually work, three things all have to be true:

1. The calendar module is on for your server.
2. Your server is mapped to a group on the website.
3. You ticked publish.

If any of them isn't, the bot tells you so straight after posting, and the event still runs normally in Discord. Publishing failing never stops an event.

Cooldowns

Most servers have a cooldown so events can't be started back to back. If you're inside it, the bot says when it ends and offers you two ways forward:

• Request an override — posts to the override channel (events_override_channel); staff click Approve or Deny on it.
• Wait.

Approved once, you skip the cooldown for your next /event start only — it doesn't stay open.

Vote requests

Separate from hosting directly: when a server has events_request_options configured, the bot can post its own message offering a small set of games as buttons, and members vote by clicking one. Once one option reaches the vote threshold, the bot starts that event automatically, as if a host had run /event start themselves. This is a background behaviour, not a command anyone runs — the settings that shape it live in Settings → Event hosting → Vote requests.

Removing someone's override restriction

Bot owner or admin, if someone has been blocked from requesting cooldown overrides:

/eventadmin override unrestrict user: @someone

Admin setup

A server admin does this once.

/config set key: events_channel        value: #where-events-get-posted
/config set key: event_hoster_role     value: @who-can-host
/config set key: events_ping_roles     value: 123456,789012      (optional)
/config set key: events_color          value: #ff8800             (optional)
/config set key: events_delete_minutes value: 10                  (optional)
/config set key: events_cooldown_minutes    value: 60             (optional, default 60)
/config set key: events_override_channel    value: #override-requests (optional, needed for overrides)

Then add at least one event type and one game — both are required before /event start has anything to offer in its dropdowns:

/eventadmin type add key: ssu display_name: "Server Start Up"
/eventadmin game add key: tom_classic display_name: "TOM Classic" game_url: https://... game_type: tom emoji: 🎮 thumbnail_url: https://... (optional)

game_type is one of tom, scpf, or external.

Command	What it does
/eventadmin type add <key> <display_name>	Add or update a type
/eventadmin type remove <key>	Remove a type
/eventadmin type list	See every type
/eventadmin game add <key> <display_name> <game_url> <game_type> <emoji> [thumbnail_url]	Add or replace a game preset
/eventadmin game remove <key>	Remove a preset
/eventadmin game thumbnail <key> <thumbnail_url>	Update just the thumbnail
/eventadmin game list	See every preset

It's not working

When you are stuck

"Module not fully configured"

The message names the missing setting. Run /config set with that name.

"No event types configured"

Run /eventadmin type add first. Same for games.

"You need the event hoster role to start an event."

You don't have the role set in event_hoster_role. Server admins bypass this.

"Configured events channel not found."

The channel was deleted or renamed. Run /config set events_channel again pointing at the current one.

The End button does nothing

Only the host and staff can end an event. If you're neither, nothing happens.

It said "Not published"

One of the three publishing conditions above isn't met. The event itself is fine — this only affects the website.

I ended it by accident

Press Undo. If it's already gone, start a new one.