EveCogs
A premium cog repository for Red-DiscordBot.
Installation
[p]repo add EveCogs https://github.com/everestmcarthur/EveCogs
[p]cog install EveCogs wormhole
[p]load wormhole
Wormhole v3.4.0
The ultimate cross-server message relay for Red-DiscordBot.
Connect Discord channels across unlimited servers into named networks. All commands work as both slash commands and prefix commands (hybrid). Messages, edits, deletes, reactions, replies, stickers, pins, typing indicators, and files are all relayed in real-time.
What's New in v3.4.0
- Hybrid Commands — every command works as both
/wh and [p]wh
- Context Menu Actions — right-click messages/users for Report, Bookmark, Delete, Profile
- Granular Mention Policy — control @user, @role, @everyone, @here per-network AND per-server, with per-user exemptions
- Terms of Service Gate — require users to accept legal ToS before messaging, with built-in prosecution-ready legal template
- Mod Edit/Delete Across Network — staff can edit or delete a message from every server at once
- Report System — users can report messages (prefix command or right-click), staff review/action/resolve, with DM warnings and auto-ban/mute
Feature Highlights
| Category |
Features |
| Relay |
Webhook / embed / compact modes, edit & delete sync, reply threading, sticker forwarding, pin sync, typing indicators, file relay |
| DM Relay |
Bidirectional DM ↔ network messaging, quiet hours, personal ignore lists |
| Moderation |
Ban/mute users & servers, word + regex filters, attachment filters, global blocklist, purge, network-wide edit & delete |
| Auto-Mod |
Anti-spam, anti-raid, anti-caps, anti-invite, anti-link, anti-zalgo, anti-spoiler, anti-emote-spam, anti-newlines |
| Mentions |
Per-network + per-server policy for @user, @role, @everyone, @here with exemptions |
| ToS/Rules |
Acceptance gate, legal template, consent tracking with timestamps, force re-accept |
| Reports |
Report via command or context menu, staff review, resolve, action (ban/mute/warn/dismiss) |
| Staff |
Staff system, ownership transfer, audit log, announcements |
| Invites |
Invite codes, vanity URLs, expiry, max uses, allowlists |
| Social |
Karma/reputation, starboard, user profiles, keyword highlights |
| Scheduling |
Scheduled messages, blackout windows, relay delay, slowmode |
| Phase 4 |
Anonymous mode, mirror channels, polls, AFK, auto-responses, ephemeral messages, media-only, analytics, health monitor, bookmarks, user colours, quiet hours, network bridging |
| Context Menus |
Report to Wormhole, Wormhole Bookmark, Wormhole Delete (staff), Wormhole Profile |
Command Reference (85+ commands)
Core
| Command |
Description |
[p]wh create <name> |
Create a new network |
[p]wh delete <name> |
Delete a network |
[p]wh open <name> |
Link current channel |
[p]wh close |
Unlink current channel |
[p]wh list |
List all networks |
[p]wh info <name> |
Network info & stats |
[p]wh portal [name] |
Create/refresh portal embed |
Settings ([p]wh set)
| Command |
Description |
set mode |
Relay mode (webhook/embed/compact) |
set colour/icon/description |
Network identity |
set freeze/silent/nsfw-gate |
Toggles |
set ratelimit/slowmode/relay-delay |
Flow control |
set anonymous/ephemeral/media-only |
Special modes |
set sync-* |
Toggle edit/delete/reaction/reply/sticker/thread/pin/typing sync |
set strip-everyone/roles/users |
Legacy mention stripping |
set channel-override |
Per-channel setting overrides |
Mention Policy ([p]wh mentions) — NEW
| Command |
Description |
mentions set <name> <type> <bool> |
Network-wide policy (users/roles/everyone/here) |
mentions server-set <name> <type> <bool> |
Per-server override |
mentions exempt <name> @user |
Allow user to bypass policy |
mentions unexempt <name> @user |
Remove exemption |
mentions status <name> |
View current policy |
Terms of Service ([p]wh tos) — NEW
| Command |
Description |
tos enable <name> |
Require acceptance before messaging |
tos disable <name> |
Remove requirement |
tos set <name> <text> |
Custom ToS text |
tos template <name> |
Reset to legal template |
tos accepted <name> |
View who accepted |
tos reset <name> |
Force everyone to re-accept |
[p]wh accept <name> |
View the ToS |
[p]wh agree <name> |
Accept the ToS |
Reports ([p]wh report) — NEW
| Command |
Description |
report message [msg_id] [reason] |
Report a message (or reply to one) |
report list <name> [show_resolved] |
View reports (staff) |
report resolve <name> <id> |
Mark as resolved |
report action <name> <id> <action> |
Take action: ban, mute, warn, dismiss |
Mod Tools ([p]wh mod)
| Command |
Description |
mod ban/unban/mute/unmute |
User moderation |
mod ban-server/unban-server/mute-server/unmute-server |
Server moderation |
mod edit <name> <msg_id> <new_text> |
Edit across entire network — NEW |
mod nuke <name> <msg_id> |
Delete from entire network — NEW |
mod purge <name> [count] |
Purge relayed messages |
| Action |
Description |
| Report to Wormhole |
Right-click any message → opens report modal |
| Wormhole Bookmark |
Right-click any message → saves to DM |
| Wormhole Delete |
Right-click any message → deletes from all servers (staff) |
| Wormhole Profile |
Right-click any user → view their network stats |
DM Relay / Invites / Staff / Filters / AutoMod / Starboard / Karma / Highlights / Blackout / Backup / Global
See [p]wh help for the full interactive reference (4 pages).
Phase 4 Features
| Command |
Description |
mirror add/remove/list |
One-way receive-only channels |
poll create/close/list |
Network-wide polls with voting |
afk <name> [reason] |
Set AFK status |
ignore add/remove/list |
Personal ignore list (DM relay) |
autoreply add/add-regex/remove/list |
Staff auto-responses |
bookmark save/list/clear |
Save messages for later |
colour <name> <hex> |
Personal embed colour |
quiet/quiet-off |
Quiet hours (DM mute) |
analytics <name> |
Activity dashboard |
health <name> |
Channel permission audit |
bridge add/remove/list |
Network-to-network bridging |
GhostWipe
Auto-deletes a departing member's messages server-wide, with a full HTML audit-log viewer.
Fires only on on_member_remove — covering voluntary leaves, kicks, and bans alike (Discord delivers all three through that single event). GhostWipe then classifies why the member left via the audit log, purges every message they ever sent across text channels, voice-channel chats, and threads (including archived ones), and produces a complete audit trail: a summary embed plus a self-contained, dark/light-themed HTML report with sidebar channel switching, search, and attachment previews.
Feature Highlights
| Category |
Features |
| Deletion |
Server-wide purge across text channels, voice chats, active + archived threads |
| Triggers |
Independently toggle leave / kick / ban as purge triggers |
| Exemptions |
Whitelist specific users, ignore specific roles or channels |
| Safety |
Dry-run/simulation mode, grace-period delay that auto-cancels on rejoin, rate-limited scanning |
| Reporting |
Self-contained HTML viewer (channel switching, search, attachment previews), per-channel breakdown embed, content redaction for privacy, configurable retention |
| Review |
history and viewreport to revisit and re-send past purge events, lifetime stats |
| Manual |
purge command to backfill a departure GhostWipe missed |
Command Reference ([p]ghostwipe, aliases gw/wipe)
| Command |
Description |
enable / disable |
Toggle GhostWipe for this server |
logchannel [#channel] |
Set/clear where purge reports are posted |
trigger <leave|kick|ban> <bool> |
Toggle which departure types trigger a purge |
whitelist add/remove/list |
Users who are never purged |
ignorerole add/remove/list |
Roles that exempt a member from being purged |
ignorechannel add/remove/list |
Channels/threads never scanned |
scanlimit <messages|none> |
Per-channel scan depth (or unlimited) |
threads / archivedthreads |
Toggle scanning active/archived threads |
dryrun <bool> |
Simulate and report without deleting |
delay <seconds> |
Grace period before purging (cancelled if the member rejoins) |
report content/attach <bool> |
Redact report content / attach the HTML file |
retention <days> |
Auto-delete saved reports after N days (0 = forever) |
settings |
Full configuration summary |
history [page] |
Recent purge events |
viewreport <event_id> |
Re-send a past report |
stats |
Lifetime purge counters |
purge <user> [confirm] |
Manually trigger a purge |
Affiliates
Ping-on-Join, a persistent affiliate-server board, and a separate DM-affiliates list — all in one cog.
POJ (Ping on Join) mentions new human members in configured channels, then auto-deletes the ping after a few seconds — enough to trigger a push notification without leaving clutter behind. Affiliates is a staff-configured channel holding a persistent, auto-updating plain-text board listing partner servers (name + invite), 10 per message and numbered 1..x, managed entirely through Discord UI — no raw IDs to remember, no manual message editing. DM Affiliates mirrors the same add/remove/list management on a completely separate list that isn't posted anywhere; instead every new member gets it as a DM the moment they join.
Feature Highlights
| Category |
Features |
| POJ |
Multiple configurable ping channels, configurable delay (1–60s), configurable {member} message template |
| Affiliate Board |
Modal-based add (Server Name + Server Invite), select-menu + confirmation removal, always-contiguous 1..x numbering, 10 entries per plain-text message (a new message per additional 10, up to 100 total) |
| Persistence |
Each board page is stored by message ID and automatically recreated if deleted — survives every bot restart |
| DM Affiliates |
Identical add/remove/list management on a fully separate list, sent as a DM on join, independently toggleable |
| Access |
Management commands are admin-only; list previews are open to any member |
Command Reference
| Command |
Description |
[p]poj enable / disable |
Toggle Ping on Join |
[p]poj channel add/remove/list |
Channels that ping new members |
[p]poj delay <seconds> |
Delete-delay for the ping |
[p]poj message <template> |
Ping message template (must include {member}) |
[p]aff channel #channel |
Set the affiliate board channel |
[p]aff add |
Add an affiliate (button → modal) |
[p]aff remove |
Remove an affiliate (select → confirm) |
[p]aff list |
Preview the current board |
[p]aff refresh |
Force-recreate the persistent message |
[p]aff dm add/remove/list |
Same management, separate DM-only list |
[p]aff dm enable/disable |
Toggle DMing new members the list |
ImageVault
Auto-deletes posted images and re-hosts them in a private vault channel so they can be retrieved on request.
Watches configured channels for image attachments, silently reposts each image (plus the message's text and full attribution) into a staff-only vault channel, then deletes the original — keeping channels clean without anything actually being lost. Because images are re-hosted on Discord rather than linked directly, there's no link-expiry problem: retrieval always fetches a fresh copy straight from the vault message. Spoilered images stay spoilered when they're sent back.
Feature Highlights
| Category |
Features |
| Archiving |
Re-uploads images into a private vault channel before deleting the original; preserves spoiler tags round-trip |
| Scope |
Watch specific channels (or everything), ignore specific channels, ignore bots/webhooks, max file size |
| Behavior |
Archive-only mode (skip deletion), optional text-content repost after removal |
| Retrieval |
show/get <id> re-sends the image; permission modes: anyone / original poster / staff only |
| Browsing |
list and mine to browse the archive, forget to drop an index entry |
Command Reference ([p]imagevault, aliases iv/vault)
| Command |
Description |
enable / disable |
Toggle ImageVault (requires a vault channel first) |
vaultchannel #channel |
Set the private channel images get archived into |
watchchannel add/remove/list |
Channels to watch (empty = all channels) |
ignorechannel add/remove/list |
Channels to never touch |
deleteoriginal <bool> |
Toggle actually deleting the original vs. archive-only |
repost <bool> |
Toggle reposting text content after an image is removed |
ignorebots <bool> |
Toggle processing bot/webhook messages |
maxsize <mb> |
Max image size to archive |
retrieve <anyone|author|staff> |
Who can retrieve archived images |
settings |
Full configuration summary |
show/get <id> |
Retrieve an archived image |
list [page] / mine [page] |
Browse the archive |
forget <id> |
Drop an index entry (staff only) |
stats |
Lifetime archive count |
Architecture
EveCogs/
├── README.md
├── LICENSE (MIT)
├── info.json
└── wormhole/
├── __init__.py
├── info.json
├── utils.py (419 lines — embeds, filters, automod, mention policy, helpers)
└── wormhole.py (4,196 lines — main cog, 85+ commands, relay engine, context menus)
License
MIT — see LICENSE.
93e759794f