everestmcarthur 627e5a426d v3.3.0 — Phase 4: hardened command filter, anonymous mode, polls, AFK, analytics, bridging, 15+ new features

Phase 4 additions:
- Hardened 4-layer command filtering (bot prefix, common prefixes, slash commands, context validation)
- Anonymous mode (hashed usernames, default avatars)
- One-way mirror channels (receive-only)
- Network-wide polls with reaction voting and auto-expiry
- AFK system with auto-clear on message send
- Personal ignore lists (per-user DM relay blocking)
- Staff auto-responses (word + regex triggers)
- Ephemeral messages (auto-delete after configurable seconds)
- Media-only mode (only relay attachments/images)
- Network analytics dashboard (hourly activity, peak hours, top users)
- Relay health monitor (15-min background check for channel accessibility)
- Message bookmarks (saved to DM)
- Per-user vanity embed colours
- Quiet hours (DM relay pause during configurable hours)
- Inter-network bridging (one-way or two-way)
- Updated README with full command reference (70+ commands)
- 3,376 lines in wormhole.py

2026-05-07 22:53:20 +00:00

6.3 KiB

Raw Blame History

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.3.0

The ultimate cross-server message relay for Red-DiscordBot.

Connect Discord channels across unlimited servers into named networks. Messages, edits, deletes, reactions, replies, stickers, pins, typing indicators, and files are all relayed in real-time.

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
Auto-Mod	Anti-spam, anti-raid, anti-caps, anti-invite, anti-link, anti-zalgo, anti-spoiler, anti-emote-spam, anti-newlines
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

Command Reference

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 <name> <webhook\|embed\|compact>`	Relay mode
`set colour <name> <hex>`	Embed colour
`set icon <name> <url>`	Custom network icon
`set freeze <name> <bool>`	Freeze/unfreeze
`set nsfw <name> <bool>`	NSFW gate
`set ratelimit <name> <msgs> <secs>`	Rate limit
`set slowmode <name> <secs>`	Per-user slowmode
`set welcome <name> <msg>`	Welcome message
`set motd <name> <msg>`	Message of the day
`set rules <name> <text>`	Network rules
`set mention <name> <key> <bool>`	Mention control
`set log-channel <name> <ch>`	Log channel
`set max-filesize <name> <bytes>`	Max file size
`set delay <name> <secs>`	Relay delay
`set anonymous <name> <bool>`	Anonymous mode
`set ephemeral <name> <secs>`	Auto-delete timer
`set media-only <name> <bool>`	Media-only mode

Sync Toggles

Command	Description
`set edits / deletes / replies / reactions / stickers / threads / typing / pins`	Toggle sync features

Staff & Moderation

Command	Description
`staff add/remove/list`	Manage staff
`transfer <name> <user>`	Transfer ownership
`mod ban/unban/mute/unmute <name> <user>`	User moderation
`mod ban-server/unban-server/mute-server/unmute-server`	Server moderation
`mod allowlist-add/allowlist-remove`	Server allowlist
`mod purge <name> [count]`	Purge relayed messages

Filters

Command	Description
`filter add-word/remove-word`	Word filters
`filter add-regex/remove-regex`	Regex filters
`filter list`	List all filters

Auto-Moderation

Command	Description
`automod enable/disable`	Toggle auto-mod
`automod anti-spam/anti-caps/anti-invite/anti-link`	Toggle protections
`automod anti-zalgo/anti-spoiler/anti-emote-spam/anti-newlines`	More protections
`automod anti-mentions <name> <bool> [max]`	Mention spam
`automod anti-raid <name> <bool> [threshold] [window]`	Raid protection
`automod status`	View auto-mod status

Invites

Command	Description
`invite create <name> [uses] [mins]`	Create invite
`invite vanity <name> <word>`	Set vanity URL
`invite use <code>`	Join via invite
`invite revoke/list`	Manage invites

DM Relay

Command	Description
`dm enable/disable <name>`	Toggle DM relay
`dm sub/unsub <name>`	Subscribe/unsubscribe
`dm send <name> <msg>`	Send via DM
`dm list`	List subscriptions

Command	Description
`karma enable/disable/check/leaderboard`	Karma system
`starboard enable/disable`	Cross-network starboard
`highlight add/remove/list`	Keyword notifications
`profile [user]`	View user profile

Phase 4 — New in v3.3.0

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/cooldown/list`	Staff auto-responses
`bookmark save/list/clear`	Save messages for later
`colour <name> <hex>`	Personal embed colour
`quiet <name> <start> <end> [offset]`	Quiet hours (DM mute)
`quiet-off <name>`	Disable quiet hours
`analytics <name>`	Activity dashboard
`health <name>`	Channel permission audit
`bridge add/remove/list`	Network-to-network bridging

Utility

Command	Description
`announce <name> <msg>`	Broadcast to all channels
`schedule <name> <mins> <msg>`	Schedule a message
`search <name> <query>`	Search message history
`discover`	Browse public networks
`backup <name>` / `restore`	Backup & restore
`debug [name]`	Diagnostic info

Architecture

EveCogs/
├── README.md
├── LICENSE (MIT)
├── info.json
└── wormhole/
    ├── __init__.py
    ├── info.json
    ├── utils.py       (403 lines — embeds, filters, automod, helpers)
    └── wormhole.py    (3,376 lines — main cog, 70+ commands, relay engine)

License

MIT — see LICENSE.

6.3 KiB Raw Blame History