Settings

Every value /config set accepts. Generated from utils/settings.py — edit that, not this page.

General

Roles and access

Who can use the bot's admin and staff commands.

Setting	Key	Type	Default	What it does
Admin role	admin_role	role		Full access to every admin command. Server administrators always have this whether or not the role is set. Required for /config, /moduleadmin, every admin command.
Staff role	staff_role	role		Staff-level commands: tickets, divisions, products. The admin role counts as staff.

Logging

Where the bot reports its own problems.

Setting	Key	Type	Default	What it does
Error log channel	error_log_channel	text channel		Where the bot reports its own failures.

Tickets

Where tickets live

The category tickets open in, and where their records go.

Setting	Key	Type	Default	What it does
Ticket category	ticket_category	category channel		Ticket channels are created inside this category. Required for opening a ticket.
Ticket log channel	ticket_log_channel	text channel		Ticket opens, closes and transcripts.

Unclaim appeals

Staff voting on whether a claimed ticket can be taken back.

Setting	Key	Type	Default	What it does
Unclaim vote channel	ticket_vote_channel	text channel		Where an unclaim appeal is posted for a vote. Required for unclaim appeals.
Inner Circle role	ticket_inner_circle_role	role		Who may vote on an unclaim appeal. Falls back to admin_role when unset.

Product pipeline

Publishing

The forum products are posted to, and the staff thread beside it.

Setting	Key	Type	Default	What it does
Product forum	product_forum_channel	forum channel		The public forum where product posts are created. Required for publishing a product.
Product staff channel	product_thread_channel	text channel		Parent channel for the private staff thread on each product.

Logging

A record of pipeline changes.

Setting	Key	Type	Default	What it does
Product log channel	product_log_channel	text channel		Pipeline changes and checklist completions.

Event hosting

Announcement

Where events are posted, who gets pinged, and what the message looks like.

Setting	Key	Type	Default	What it does
Announcement channel	events_channel	text channel		Where event announcements are posted. Required for hosting an event.
Ping roles	events_ping_roles	role list		Pinged when an event is announced.
Events colour	events_color	colour		Accent colour on event posts. Also the fallback for the other modules' colours.

Who can host

The role required to announce an event.

Setting	Key	Type	Default	What it does
Hoster role	event_hoster_role	role		Who may host an event. Required for hosting an event.

Cooldowns and overrides

How long between events, and how staff approve one during a cooldown.

Setting	Key	Type	Default	What it does
Cooldown between events	events_cooldown_minutes	1–1440 minutes	60	How long after an event ends before another may be hosted.
Override request channel	events_override_channel	text channel		Where a request to host during a cooldown is posted for approval. Without it there is no override at all. Required for cooldown overrides.

Vote requests

Members voting for what gets hosted next.

Setting	Key	Type	Default	What it does
Vote request games	events_request_options	string list		Game preset keys offered when members vote for the next event. Keys not defined on this server are skipped. Required for event vote requests.
Votes to trigger an event	events_request_threshold	1–50 votes	5	Votes needed on one option before it wins.
Votes to trigger during a cooldown	events_request_threshold_during_cooldown	1–50 votes	10	Higher bar while a cooldown is running.
Vote request expires after	events_request_expiry_hours	1–168 hours	12	How long a vote request stays open.

Event log

A record of every event hosted, ended or cancelled, and by whom.

Setting	Key	Type	Default	What it does
Events log channel	events_log_channel	text channel		Hosting, ending, overrides and vote requests.
Delete announcement after	events_delete_minutes	1–60 minutes	10	How long an announcement stays up once the event ends.

Attendance records

Attendance charts

Where charts are posted.

Setting	Key	Type	Default	What it does
Attendance chart channel	activity_chart_channel	text channel		Where attendance charts are posted. Required for attendance charts.

Proof images

Where uploaded images are kept so their links do not expire.

Setting	Key	Type	Default	What it does
Image storage channel	activity_chart_storage_channel	text channel		Uploaded proof images are re-hosted here so their links do not expire. Can be a private channel. Required for attendance images, declaration images.

Diplomacy

Affiliations

Who may edit faction relations, and how the panel looks.

Setting	Key	Type	Default	What it does
Diplomat role	affiliation_diplomat_role	role		May edit faction affiliations.
Leader role	affiliation_leader_role	role		May edit faction affiliations.
Affiliations panel colour	affiliations_panel_color	colour		Accent colour on the relations panel. Falls back to events_color when unset.

Declarations

Where declarations are posted and how they look.

Setting	Key	Type	Default	What it does
Declarations channel	declarations_channel	text or forum channel		Where declarations are posted. A forum channel enables tags. Required for posting a declaration.
Declaration image storage	declaration_storage_channel	text channel		Re-hosts declaration images so their links do not expire. Falls back to activity_chart_storage_channel when unset.
Declarations colour	declarations_color	colour		Accent colour on declaration posts. Falls back to events_color when unset.

Forum tags

Which tags each kind of declaration is filed under.

Setting	Key	Type	Default	What it does
Simple declaration tags	declaration_simple_tags	string list		Forum tag names applied to a simple declaration.
Email declaration tags	declaration_email_tags	string list		Forum tag names applied to an email declaration.
Communiqué declaration tags	declaration_communique_tags	string list		Forum tag names applied to a communiqué.

Divisions directory

The directory

The forum holding one thread per division, and how threads are tagged.

Setting	Key	Type	Default	What it does
Divisions forum	divisions_forum_channel	forum channel		The forum holding one thread per division. Required for publishing a division.
Division forum tags	divisions_forum_tags	tag map		Maps a wing, category or status name to a forum tag ID, so published divisions are tagged automatically.

Limitations

The published limitations post that division threads link to.

Setting	Key	Type	Default	What it does
Limitations thread	divisions_limitations_thread	thread channel		The published limitations post. Set by /division limitations publish; you should not need to set it by hand. Written by the bot.