Misc Functions Cog

The Misc Functions cog bundles utility commands, small quality-of-life moderation tools, and a few optional server features.

Features

Utility Commands

  • Bot status and information via ping and vor subcommands
  • Timestamp generation for Discord formatting
  • Built-in calculator UI
  • Send-as-bot helper command for moderators
  • Close thread helper for staff

Moderation Helpers

  • Touchgrass timeout workflow with human-friendly durations
  • Remove timeout helper (untouchgrass)
  • Moderator timeout command for other users (gotouchgrass)

Optional Config-Driven Features

  • Deals relay (monitor source channels and repost deal messages)
  • PC Help Hub mascot event controls and submission flow
  • Temporary voice channel creator
  • Link cleaner (automatically strips tracking/affiliate parameters from URLs in messages)

Commands

Command Description Usage
/ping or !ping Check latency and heartbeat /ping
/vor uptime or !uptime Show process and host uptime /vor uptime
/vor info or !info Show bot stats and environment info /vor info
/vor credits or !credits Show credits and libraries /vor credits
/vor getstarted or !getstarted Show quick-start message /vor getstarted
/timestamp short Create relative timestamp /timestamp short hh:mm dd-mm-yyyy
/timestamp long Create long timestamp /timestamp long hh:mm dd-mm-yyyy
!touchgrass <duration> Timeout yourself !touchgrass 30m
!untouchgrass <user> Remove timeout from a user !untouchgrass @user
!gotouchgrass <user> <duration> Timeout another user (manage messages required) !gotouchgrass @user 2h
/say <channel> <message> or !say Send a message as the bot /say #announcements Hello
/close_thread Archive the current non-forum thread /close_thread
/event submit <attachment> <comment> Submit mascot event entry (when enabled) /event submit
/event end End mascot event (admin only) /event end
/calculator Open interactive calculator UI /calculator
/linkcleaner <enabled\|disabled> Enable or disable link cleaning (manage server required) /linkcleaner enabled

Configuration

Configure this cog through the config UI:

/config cog MiscFunctions
Setting Description
Deals Enabled Toggle deal relay workflow
Deals Channel Destination channel for relayed deals
Deals Ping Role Optional role ping for posted deals
Deals Source Channels Source channels to monitor for deals
Event Enabled Toggle mascot event commands
Event Channel Destination channel for submissions/results
Event Ping Role Optional role ping on submission
Create a VC channel Voice channel that spawns temporary VCs when joined
Link Cleaner Enabled Toggle automatic link cleaning on messages
Link Cleaner URL Mode any — clean all URLs; custom — only clean URLs from specified domains
Link Cleaner URLs Comma-separated list of domains to clean when mode is custom (e.g. amazon.com, youtube.com)
Link Cleaner Delete Original When enabled, the original message is deleted after posting the cleaned URL reply; when disabled (default), both the original and the reply have their embeds suppressed instead

Notes

  • The old confession system is disabled in current code.
  • Touchgrass commands are currently prefix-first in implementation.
  • Timestamp commands expect input in format hh:mm dd-mm-yyyy.
  • Temporary voice channels are deleted automatically when empty.
  • Link cleaner uses an allowlist strategy (based on corbindavenport/link-cleaner): all query parameters are stripped and only known-functional ones are re-added. Supported domains include Amazon, YouTube, Best Buy, Walmart, Lenovo, Macy’s, Google Play, Facebook, Webtoon, and more. When a URL is cleaned, the bot replies to the message with the cleaned version.
  • The /linkcleaner command is a quick toggle for the feature. For full settings (URL mode, custom domain list, delete-original behaviour) use /config cog MiscFunctions.
  • When Delete Original is off (default), embed previews are suppressed on both the original message and the bot reply. When Delete Original is on, the original message is deleted outright after the cleaned reply is posted.