Taako's Cogs

A growing collection of cogs for Red-DiscordBot, focused on practical server operations, support workflows, community health, privacy, event attendance, roleplay immersion, and admin tooling.

Documentation: taakoofficial.github.io/TaakosCogs/latest

This repo includes everything from forum resolution, staff scheduling, incident response, link monitoring, access reviews, retention policy, sponsor roles, digests, community analytics, and event check-ins to tickets, role automation, RP world tracking, games, and WHMCS support tooling.

Quick Install

Run these commands in Discord with your Red bot prefix:

[p]load downloader
[p]repo add taakoscogs https://github.com/TaakoOfficial/TaakosCogs
[p]cog install taakoscogs <cogname>
[p]load <cogname>

Example:

[p]cog install taakoscogs toolz
[p]load toolz

To update installed cogs:

[p]cog update

Dashboard Support

Every configurable cog includes its own purpose-built Red-Web-Dashboard page with labeled fields, Discord channel and role selectors, validation, and cog-specific actions. Stateless utilities use focused operation or live-status pages instead of showing an empty settings editor. No cog relies on the generic JSON configuration fallback.

Cog Catalog

Cog	Best For	Highlights
forumflow	Help forums	Persistent claim/state controls, accepted answers, workflow tags, stale queues, resolution metrics, and CSV exports.
staffops	Staff coordination	Clocked shifts, availability, leave requests, on-call rotations, handoffs, coverage visibility, and hour reports.
opsroom	Incident response	Dedicated incident channels, severity/status, commanders, timelines, stakeholder updates, actions, and postmortems.
linksentinel	Resource monitoring	Scheduled HTTP checks, redirect and recovery alerts, TLS expiry, channel discovery, and CSV results.
communitydigest	Community recaps	Provider-free scheduled text/forum digests with activity counts, discussion highlights, and popular links.
sponsorsync	Membership roles	Provider-neutral tier mappings, expirations, grace periods, CSV bridges, and audited role reconciliation.
communitypulse	Community health	Content-free onboarding funnels, activation, retention cohorts, churn, inactivity queues, and role adoption.
accessreview	Access certification	Sensitive-role snapshots, reviewer attestations, separately confirmed enforcement, evidence logs, and exports.
datasteward	Privacy operations	Dry-run-first channel retention, bounded confirmed enforcement, pinned protection, audits, and privacy requests.
eventcheckin	Event attendance	Persistent RSVP/check-in controls, capacity, FIFO waitlists, reminders, no-shows, rewards, and attendance exports.
messagestudio	Rich message building	EmbedUtils-compatible commands, embeds and Components V2, stored messages, webhooks, JSON/YAML, and a standalone visual dashboard builder.
toolz	Role and user utilities	Role/user info, role audits, role comparison, CSV exports, bot/no-role audits, role-triggered messages with {user} placeholders.
rolemanager	Role automation	Audited role policies, advanced targeting/jobs, panels, resilient autoroles, sticky/temp roles, and verified migrations with rollback.
yalc	Server logging	Exact role-delta/field audit attribution, 71 routed events, uncached reactions and polls, fail-closed delivery, diagnostics, and an optional journal.
applications	Staff applications	Configurable forms, application panels, DM questionnaires, review buttons, role actions, CSV exports, polls, and dashboard setup.
welcome	Join messages	Configurable welcome messages, placeholders, JSON embeds, cached welcome images, avatar overlays, and dashboard setup.
captcha	Member verification	Persistent verification buttons, per-click random modal codes, existing-message attachment, configurable success roles, and dashboard setup.
invitetracker	Invite tracking	Invite-use detection, join sources, fake joins, leaver counts, leaderboards, log embeds, CSV exports, and dashboard controls.
suggestionbox	Community feedback	Suggestions with persistent voting buttons, discussion threads, review states, comments, review logs, CSV exports, and dashboard controls.
repboard	Community reputation	Member kudos, public rep board posts, cooldowns, daily limits, profiles, leaderboards, moderation removal, and CSV exports.
reviewhub	Reviews and vouches	reviewhub-style reviews, vouches, review requests, stats, leaderboards, reports, useful votes, templates, and CSV exports.
tickethub	Support tickets	Ticket panels, private channels, claim/close controls, AAA3A Tickets profile imports, HTML transcripts, and owner transcript DMs.
slashlink	Prefix/slash compatibility	Red-managed application-command gateways for loaded prefix-only cogs, with permission-aware autocomplete and normal [p]slash controls.
commandhub	Command organization	Guild slash-command hubs with categories, pagination, search, modal arguments, confirmation gates, and safe prefix/native routing.
tempvoice	Voice channel automation	Join-to-create temporary voice channels, embedded owner controls, rename/lock/limit/transfer buttons, claiming, cleanup, and dashboard setup.
giveaway	Community events	Timed giveaways, reaction entry, rerolls, cancellation, attached giveaways, prefix/slash commands, and dashboard controls.
spinwheel	Decisions and party games	Animated secure-random wheels, saved presets, themed/custom colors, optional winner removal, slash commands, and a visual dashboard.
uppercase	Channel setup	Create and rename text channels with uppercase-style names using /createchannel and /renamechannel.
emojiporter	Server migration	Copy emojis and stickers between servers, list emoji/sticker inventory, skip duplicates automatically.
rolekit	Community roles & levels	Curated identity/interest role packs, cooldown-limited activity XP, rank cards, leaderboards, milestone roles, and dashboard setup.
fivemstatus	FiveM communities	Live server status panel with player counts, Join Server button, restart countdowns, uptime tracking, images, and link buttons.
cfxstatus	Cfx.re service checks	Auto-updating panel that checks the official Cfx.re Statuspage API, with Rockstar's service-status page as a fallback.
randomweather	RP atmosphere	Seasonal weather simulation, extreme weather events, automatic updates, role notifications, timezone-aware generation.
rpcalander	RP timekeeping	Daily RP calendar posts, custom timelines, moon phases, blood moon events, separate moon channels.
fable	RP worldbuilding	Character profiles, relationships, locations, timelines, visualizations, lore tracking, export tools.
deepdelve	Living text RPG	Branching campaign, puzzles, companions, professions, town growth, world events, tactical combat, deep loot, endgame, and Red bank support.
paranoia	Social games	Discord version of paranoia with secret DM questions, custom questions, status tracking, and Tupperbox support.
flipper	Simple fun	Lightweight coin flip command with embeds.
whmcs	Hosting/business support	WHMCS clients, billing, support tickets, role permissions, API configuration, and Discord ticket channels.

Recommended Sets

Staff and Server Management

Install these if you want better moderation visibility, invite attribution, feedback workflows, community reputation, support tickets, and role operations:

[p]cog install taakoscogs forumflow staffops opsroom linksentinel communitydigest communitypulse accessreview datasteward eventcheckin toolz rolemanager yalc applications welcome captcha invitetracker suggestionbox repboard reviewhub tickethub commandhub tempvoice giveaway spinwheel

• toolz gives staff role/user lookup, audit, export, and role-triggered message tools.
• forumflow manages help-forum claiming, accepted answers, state tags, stale queues, and resolution metrics.
• staffops coordinates shifts, availability, leave, on-call coverage, and handoffs.
• opsroom runs operational incidents with dedicated channels, timelines, status updates, and postmortems.
• linksentinel monitors important resource links, redirects, failures, recoveries, and TLS expiry.
• communitydigest publishes scheduled provider-free recaps of selected text and forum channels.
• communitypulse measures onboarding, activation, retention, churn, and role adoption without storing message content.
• accessreview runs auditable periodic certification of sensitive role access.
• datasteward provides dry-run-first retention policies and privacy request workflows.
• eventcheckin adds RSVP, waitlist, check-in, no-show, and reward-role workflows to events.
• rolemanager handles audited self/policy roles, advanced targeting and jobs, reaction/button/select panels, resilient autoroles, sticky/temporary roles, lifecycle reports, and verified imports with rollback.
• YALC gives detailed server logging.
• applications handles staff applications, review workflows, and approval roles.
• welcome handles onboarding messages.
• captcha verifies new members with randomized modal codes and assigns a configured role.
• invitetracker tracks invite joins, fake joins, leavers, join sources, and leaderboards.
• suggestionbox collects community suggestions with voting, optional discussion threads, staff review states, comments, and exports.
• repboard gives members a lightweight kudos and reputation leaderboard system.
• reviewhub collects structured reviews and vouches with request buttons, reports, useful votes, stats, and leaderboards.
• tickethub handles support tickets with panels, private channels, staff controls, imports, and transcripts.
• commandhub groups loaded commands behind configurable guild slash commands with a searchable browser and normal permission checks.
• tempvoice gives members self-managed temporary voice channels with embedded controls.
• giveaway supports events and community rewards.
• spinwheel turns choices, drawings, and party-game prompts into colorful animated wheels.

Roleplay Servers

Install these for immersive RP communities:

[p]cog install taakoscogs fivemstatus cfxstatus fable randomweather rpcalander paranoia

• fivemstatus posts a live FiveM status panel with player counts, connect command, restarts, and buttons.
• cfxstatus posts an auto-updating panel for the official Cfx.re service status.
• fable tracks characters, relationships, locations, and lore.
• randomweather adds seasonal weather and extreme events.
• rpcalander keeps your in-world calendar and moons moving.
• paranoia gives players an easy social game between scenes.

Games and Community Fun

Install these for interactive events, persistent progression, and party games:

[p]cog install taakoscogs deepdelve paranoia flipper giveaway

• deepdelve is a living old-school text RPG with a branching solo campaign, puzzles, companions, professions, server town development, daily world events, tactical combat, advanced itemization, NPC stories, endgame challenges, and optional Red bank integration.
• paranoia is a social party game built around secret questions and public reveals.
• flipper provides quick coin flips.
• giveaway runs timed community giveaways and rerolls.

Server Setup and Migration

Install these when building or moving a server:

[p]cog install taakoscogs emojiporter rolekit toolz rolemanager uppercase tempvoice

• emojiporter copies emojis and stickers from another server the bot can access.
• rolekit creates curated community role packs and can run lightweight activity ranks with automatic milestone roles.
• toolz helps audit role counts, hierarchy, empty roles, bots, and permissions.
• rolemanager turns those roles into self roles, reaction/button/select roles, autoroles, sticky roles, temporary roles, or policy-linked role sets.
• uppercase creates and renames text channels with uppercase-style names.
• tempvoice sets up join-to-create voice channels for member-managed voice spaces.

Hosting and Support Teams

Install these if your Discord supports a hosting, membership, or operational support service:

[p]cog install taakoscogs whmcs opsroom linksentinel sponsorsync staffops

• whmcs connects Discord staff workflows to clients, invoices, support tickets, and optional per-ticket Discord channels.
• opsroom coordinates outages and generates durable postmortems.
• linksentinel monitors documentation, control panels, and service links.
• sponsorsync reconciles provider-neutral membership exports to Discord roles.
• staffops keeps shifts, on-call coverage, and handoffs visible.

Featured Cog: toolz

toolz is the general-purpose staff utility cog for larger servers.

Key commands:

Command	Purpose
[p]roleinfo <role> or /roleinfo	Show role info with mobile-copyable role ID and mention text.
[p]memberinfo [member] or /memberinfo	Show user/member details, join date, roles, and elevated permission summary.
[p]rolecompare <role_a> <role_b>	Compare role overlap and member differences.
[p]roleaudit [mode]	Audit elevated, empty, managed, or mentionable roles.
[p]rolehierarchy	Review role order, counts, and IDs.
[p]rolemessage setup	Show setup help for messages posted when a role is given.

Role message example:

[p]rolemessage channel @Verified #welcome
[p]rolemessage add @Verified Welcome {user}, you now have {role} in {server}!
[p]rolemessage mode @Verified random

Requirements

Most cogs require:

• Red-DiscordBot V3.
• Discord permissions appropriate to the cog, usually Send Messages and Embed Links.
• Extra permissions for specific features, such as Manage Roles, Manage Channels, Manage Emojis and Stickers, or Attach Files.

Some cogs have Python package requirements that Red's downloader installs automatically:

Cog	Requirements
messagestudio	PyYAML>=6.0 and Red 3.5.21+
randomweather	pytz
rpcalander	pytz
welcome	aiohttp
emojiporter	aiohttp
fivemstatus	aiohttp
cfxstatus	aiohttp
linksentinel	aiohttp>=3.8.0
whmcs	aiohttp>=3.8.0
spinwheel	Pillow>=10.0.0

Some features also need Discord privileged intents:

• Invite join and leave tracking in invitetracker needs Server Members intent.
• Role-triggered messages in toolz need Server Members intent.
• External role-change rules in rolemanager require Server Members intent; autoroles, sticky roles, and bulk member targeting also use it.
• Member logging and member update features in logging cogs may also need Server Members intent.
• Complete join/leave and role-adoption reporting in communitypulse needs Server Members intent. It never stores message content.
• Role assignment features in applications need Manage Roles and a bot role above the target roles.
• Captcha role assignment needs Manage Roles and a bot role above the verification role.
• Temporary voice creation in tempvoice needs Manage Channels and Move Members.

Data and Privacy

Each cog includes its own data statement in info.json. In short:

• flipper, randomweather, emojiporter, uppercase, and slashlink do not persistently store end user data.
• rolekit stores per-server XP, counted-message totals, and level-up ping preferences; it never stores message content.
• messagestudio stores saved message payloads, author IDs, lock settings, and usage counts when its storage commands are used.
• toolz stores per-guild role-message settings such as role IDs, channel IDs, and message templates.
• rolemanager stores role configuration, role-policy and role-change-rule settings, role costs, reaction/button/select message/channel IDs, emoji keys, temporary-role expiry timestamps, and Discord user IDs for sticky and temporary role assignment.
• captcha stores panel message/channel IDs, role IDs, and button labels; verification challenges are transient in memory.
• yalc stores logging settings, routes, filters, ignore-rule user IDs, and limited voice history. Its optional retained event journal stores event metadata and only stores message content when explicitly enabled.
• applications, welcome, invitetracker, suggestionbox, repboard, reviewhub, tickethub, commandhub, tempvoice, giveaway, spinwheel, fivemstatus, fable, deepdelve, paranoia, rpcalander, and whmcs store the settings or records needed for their features.
• forumflow, staffops, opsroom, sponsorsync, communitypulse, accessreview, datasteward, and eventcheckin store the workflow records and Discord IDs described in their individual info.json files and support Red data-deletion requests.
• linksentinel stores URLs and network check results but no Discord end-user data. communitydigest stores scheduling metadata and aggregates but does not retain message content or author IDs.
• datasteward starts disabled and protects pinned messages. Enforcement requires explicit command confirmations; its dashboard can only choose disabled or dry-run mode.
• deepdelve stores persistent characters, builds, inventory, campaign decisions, puzzles, companions, professions, town contributions, world-event discoveries, social records, progression, encounters, stories, endgame and seasonal data, and Discord user IDs. In bank mode it reads and changes Red bank balances for game transactions.
• spinwheel stores server-created wheel names, entry labels, colors, winner-removal preferences, last winners, and aggregate spin counts; it does not store Discord user IDs.
• invitetracker stores invite cache metadata, inviter stats, tracked member join-source records, Discord user IDs, invite codes, timestamps, fake-join flags, and unknown join counts.
• suggestionbox stores suggestion text, author IDs, voter IDs, staff reviewer IDs, message/channel/thread IDs, votes, statuses, staff notes, review reasons, and timestamps.
• repboard stores reputation settings, giver/receiver/moderator IDs, reasons, message/channel IDs, timestamps, active/removed state, cooldown metadata, daily limit metadata, and aggregate reputation statistics.
• reviewhub stores review settings, request records, review/vouch records, reviewer/reviewed/reporter/useful-voter/moderator IDs, review text, ratings, message/channel IDs, timestamps, and deletion metadata.
• tickethub stores ticket profiles, panel IDs, channel/category/role IDs, ticket records, owner/staff/participant IDs, reasons, timestamps, and lifecycle events. Transcripts are generated on demand from channel history.
• commandhub stores guild hub configuration and can optionally store each member's last routed command when repeat persistence is enabled.
• tempvoice stores temporary voice settings, active temporary channel IDs, owner IDs, permitted user IDs, control panel message/channel IDs, creation timestamps, lock state, and user limits.
• cfxstatus stores Cfx.re status panel settings, including enabled state, channel IDs, message IDs, polling interval, and last poll timestamp.
• rpcalander also uses a local post_tracker.json file to prevent duplicate daily posts.

No cog is intended to share stored data with external services unless the feature explicitly requires an external integration, such as WHMCS API access or optional fable export workflows.

Support and Docs

Start with each cog's README:

• forumflow README
• staffops README
• opsroom README
• linksentinel README
• communitydigest README
• sponsorsync README
• communitypulse README
• accessreview README
• datasteward README
• eventcheckin README
• toolz README
• messagestudio README
• rolemanager README
• yalc README
• applications README
• welcome README
• captcha README
• invitetracker README
• suggestionbox README
• repboard README
• reviewhub README
• tickethub README
• slashlink README
• commandhub README
• giveaway README
• spinwheel README
• uppercase README
• emojiporter README
• rolekit README
• fivemstatus README
• cfxstatus README
• randomweather README
• rpcalander README
• fable README
• deepdelve README
• paranoia README
• flipper README
• whmcs README

For command help inside Discord, use:

[p]help <cogname>

Contributing

Development and CI use Python 3.11 with the dependencies pinned in uv.lock. Install uv, then create the exact environment and run the same checks as CI:

uv sync --locked --all-groups
uv run --locked pre-commit run --all-files
uv run --locked python -m pytest -q -p no:cacheprovider
uv run --locked mkdocs build --strict

To enable the local commit hooks:

uv run --locked pre-commit install

GitHub runs pre-commit, lint, tests, strict documentation, Python 3.10/3.11 imports, dependency review, CodeQL, and cog release-policy checks for pull requests. Live Cog Load automatically installs, loads, and unloads only the cogs changed by a push to main or by a pull request from a branch in this repository. Fork and Dependabot pull requests never receive DISCORD_BOT_TOKEN and therefore skip the live job; they still receive the full tokenless CI suite. Changes to the lockfile or live-test tooling conservatively exercise all cogs, as does a manual run on main. A dedicated CI bot token is strongly recommended so test sessions cannot interrupt a production bot using the same token.

Dependabot checks the locked Python environment, GitHub Actions, and pre-commit hooks every Monday morning. Its pull requests run the same tokenless CI as other automated contributions; after a dependency update is reviewed and merged, the main push runs Live Cog Load against all cogs affected by the shared lockfile.

See CONTRIBUTING.md for the review and versioning policy. Report vulnerabilities privately through the process in SECURITY.md.

License

This repository is licensed under the GNU AGPLv3 unless an individual cog states otherwise. The LICENSE file contains the complete, verbatim AGPLv3 text.

Project copyright information is in COPYRIGHT. Artwork attribution, preserved third-party license notices, compatibility acknowledgements, and dependency notes are centralized in THIRD_PARTY_NOTICES.md.

Contributors

Thanks to Evanroby for their repository contributions. Git history remains the authoritative record of individual authorship.