feat: ServerWhitelist — Ultimate owner-only server management cog #3

Merged

everestmcarthur merged 1 commit from feat/serverwhitelist into main

2026-05-12 23:07:11 -04:00

everestmcarthur commented

2026-05-12 23:04:21 -04:00

(Migrated from github.com)

ServerWhitelist v2.0

Owner-only hybrid commands to control which Discord servers the bot may operate in. All current servers are auto-whitelisted on cog load.

Commands

Command	Description
`[p]join <id>`	Whitelist a server
`[p]join remove <id>`	Un-whitelist & leave
`[p]join whitelist`	Paginated whitelist view
`[p]join blacklist <id>`	Blacklist a server (auto-leave & never rejoin)
`[p]join unblacklist <id>`	Remove from blacklist
`[p]join blacklisted`	View blacklisted servers
`[p]join servers`	Interactive server browser with leave dropdown
`[p]join info <id>`	Detailed server info embed
`[p]join search <query>`	Search servers by name
`[p]join leave <id>`	Leave a server immediately
`[p]join purge`	Leave all non-whitelisted servers (with confirmation)
`[p]join lock`	Reject ALL new joins (even whitelisted)
`[p]join unlock`	Resume normal whitelist behaviour
`[p]join log <channel>`	Set event log channel
`[p]join stats`	Server footprint overview
`[p]join settings`	View current config
`[p]join export`	Export server list as .txt

Features

Whitelist — only whitelisted servers are allowed; bot auto-leaves anything else
Blacklist — explicitly blocked servers, auto-leave + never rejoin
Lock mode — reject ALL new joins including whitelisted (emergency brake)
Interactive browser — paginated embeds with ⏮◀▶⏭ navigation and a leave dropdown per page
Purge — bulk leave all non-whitelisted servers with a danger-confirm button
Detailed logging — every join/leave/block event logged to a configurable channel with timestamps
Export — full server list dumped as a formatted .txt file
Stats — total servers, members, largest/smallest, whitelist/blacklist counts
All commands are hybrid (prefix + slash) and owner-only

## ServerWhitelist v2.0 Owner-only hybrid commands to control which Discord servers the bot may operate in. All current servers are auto-whitelisted on cog load. ### Commands | Command | Description | |---------|-------------| | `[p]join <id>` | Whitelist a server | | `[p]join remove <id>` | Un-whitelist & leave | | `[p]join whitelist` | Paginated whitelist view | | `[p]join blacklist <id>` | Blacklist a server (auto-leave & never rejoin) | | `[p]join unblacklist <id>` | Remove from blacklist | | `[p]join blacklisted` | View blacklisted servers | | `[p]join servers` | Interactive server browser with leave dropdown | | `[p]join info <id>` | Detailed server info embed | | `[p]join search <query>` | Search servers by name | | `[p]join leave <id>` | Leave a server immediately | | `[p]join purge` | Leave all non-whitelisted servers (with confirmation) | | `[p]join lock` | Reject ALL new joins (even whitelisted) | | `[p]join unlock` | Resume normal whitelist behaviour | | `[p]join log <channel>` | Set event log channel | | `[p]join stats` | Server footprint overview | | `[p]join settings` | View current config | | `[p]join export` | Export server list as .txt | ### Features - **Whitelist** — only whitelisted servers are allowed; bot auto-leaves anything else - **Blacklist** — explicitly blocked servers, auto-leave + never rejoin - **Lock mode** — reject ALL new joins including whitelisted (emergency brake) - **Interactive browser** — paginated embeds with ⏮◀▶⏭ navigation and a leave dropdown per page - **Purge** — bulk leave all non-whitelisted servers with a danger-confirm button - **Detailed logging** — every join/leave/block event logged to a configurable channel with timestamps - **Export** — full server list dumped as a formatted .txt file - **Stats** — total servers, members, largest/smallest, whitelist/blacklist counts - **All commands are hybrid** (prefix + slash) and owner-only