🧩 Pieces

Talks back! On spells, replies under the slash command (optionally private). On message triggers, replies in a thread under the message that fired the flow.

Sends an additional message under the same slash command. Discord only allows one initial reply per spell — use Reply for the first message, then Follow-up for every message after.

Drops a message anywhere in your server. Unlike Reply, it doesn't need to be a response to anything — it can post in #announcements while the trigger happened in #general.

Sends a fancy embed card with a title, body text, and accent color. Embeds stand out in chat and look way more polished than plain text. Great for leaderboards, announcements, and summaries.

Sends a private DM directly to a specific user. No one else sees it. Perfect for sending private results, warnings, or personalized info. Note: some users have DMs disabled — that's what the Error port is for.

The decision maker! Checks if something is true or false, then sends the flow down one of two paths. It's how your bot becomes smart — 'if this user is an admin, do X, otherwise do Y'.

A visual hub for converging flows. Wire both Condition outputs (or any parallel paths) into this piece, then connect one output to your shared downstream chain. The runner already supports multiple incoming edges — Merge makes that pattern obvious on the canvas.

Sets a spark from a primary template, or falls back when the primary is empty. Perfect for /profile user_p: use the mentioned user's ID when provided, otherwise the invoker's ID — without duplicating Save Sparks on each branch.

Pumps the brakes! Pauses the flow for a set number of milliseconds before continuing. Useful for adding a dramatic pause before a big reveal, or spacing out multiple messages so they don't all appear at once.

Creates or updates a named spark that holds a typed value — text, number, yes/no, list, or object. Update existing sparks in place: numbers use Add/Subtract/Multiply/Divide, text uses append/prepend, lists use Add to list / Prepend to list (single items or rows), booleans support toggle. The spark is then available everywhere downstream.

Repeat after me! Takes a list and runs the connected flow once for each item in it. Great for sending messages to multiple users, processing a list of scores, or doing anything that needs to happen more than once.

Ends the custom piece's flow and hands named values back to whoever called it. The fields shown here come from the returns you defined on this custom piece.

Fetches rows from one of your Vault tables. Pick a table, choose which column to match on (like user_id), and give the result a name — it becomes a ✨ Spark you can drop into any later piece.

Saves a row to one of your Vault tables. Pick a table, fill in each column's value, and optionally turn on 'update if exists' to avoid duplicate rows — perfect for tracking coins, XP, or anything per-user.

Permanently removes rows from one of your Vault tables. Pick the table, choose which column to match on, and only those rows get deleted. No filter? The whole table is wiped — so be careful!

Reaches into a bag and pulls out one random item. Great for random jokes, quotes, prizes, challenge assignments, or anything where variety is the spice of life.

Writes a message to your bot's Activity log. Use info for breadcrumbs, warn for odd-but-okay moments, and error when something went wrong but you handled it in the flow. Great for debugging without spamming Discord.

Constructs a piece of text by filling in a template with live values. Combine static text with Sparks to build dynamic messages, labels, or anything that needs to be assembled from parts.

Formats a date/time spark into human-readable text, ISO, a custom pattern, or Discord's native `<t:unix:style>` timestamps (t, T, d, D, f, F, R). Leave the input empty to use the current time when the flow runs.

Runs an arithmetic expression and stores the answer as a Spark. Add scores, calculate percentages, multiply rewards — if numbers are involved, this piece does the work.

Takes a list and sorts it ascending or descending. If the list came from a Vault read, it auto-detects the table schema and lets you pick which column to sort by — no guessing field names. The sorted result becomes a ✨ Spark you can loop over or show directly.

Splits text into a list using a delimiter — comma, space, newline, or any string. Great for parsing command arguments, CSV-style data, or multi-line input.

Joins list items into a single string with a separator between each item. Perfect for building comma-separated lists, bullet lines, or one big message from many sparks.

Replaces every occurrence of a find string with another value. Handy for sanitizing input, swapping placeholders, or cleaning up user text.

Transforms text casing or whitespace. Use trim before comparing strings, uppercase for shouty replies, or title case for display names.

Returns how many characters are in a piece of text. Useful for validating message length, word-count style games, or limits before sending.

Returns how many items are in a list spark. Pair with Condition to branch on empty lists or check leaderboard size.

Returns the item at a zero-based index — 0 is first, 1 is second, and so on. Great for showing the top scorer or a random pick you already stored.

Returns a slice of a list from a start index up to (but not including) an end index. Use it for top-10 boards, paging, or trimming edges.

Deduplicates a list while keeping the first occurrence of each value. Handy after merges, user submissions, or tag lists.

Checks whether a list contains an item (string match). Routes to Found when present, Empty when not — like a mini condition for lists.

Searches your server for text channels by name — or grabs however many the bot has permission to write to. Set limit to 1 for a single channel, or higher to get a list. Results become a ✨ Spark for use in Send Message.

Branches based on whether a server member has a specific Discord permission (like Ban Members or Manage Messages). Use it in message flows to skip filters for mods, or to gate logic on someone other than the command invoker.

Hands out a Discord role to a user. Perfect for level-up rewards, verifications, unlock systems, or any time someone earns access to something. The bot needs Manage Roles permission for this to work.

The flip side of Add Role — takes a role away from a user. Use it for role rotation, timed access, punishments, or when someone no longer meets the criteria for a role.

Finds a member of your server by their Discord user ID and loads their info — username, roles, join date, and more — as a Spark you can use anywhere. Useful when you need data about someone other than whoever triggered the flow.

Removes a member from the server — they can still rejoin with an invite. A lighter touch than a ban; great for first offences or automated flows. Always pair with a Condition to confirm the boot is warranted.

Permanently bans a user. Unlike Kick, they cannot rejoin. Optionally deletes their recent messages (1–7 days). Use with care — you can always Unban later if needed.

Removes a ban by user ID. They won't automatically rejoin — they'll need a fresh invite. Perfect for /unban commands where a mod reinstates a previously banned member.

Puts a member in Discord's native timeout. While timed out they can't send messages, add reactions, or join voice. Perfect for automated cool-downs. Requires Moderate Members permission. Max duration is 28 days.

Clears an active timeout and restores a member's ability to chat. Handy for manual override commands — a mod can un-mute someone before their timeout would naturally expire.

Deletes one specific message from a channel. Use in message-event flows where bad content needs to go immediately. The message ID and channel ID are available as Sparks in message triggers.

Deletes up to 100 messages from a channel in one sweep. Discord only allows bulk-deleting messages under 14 days old. Perfect for cleaning up spam raids, accidental leaks, or bot noise.

Sets a channel's slowmode cooldown — from 0 (off) to 21600 seconds (6 hours). Users can only send one message per cooldown. Great for calming heated chats, preventing raid spam, or managing high-traffic events.

Removes @everyone's Send Messages permission in a channel — effectively locking it. The channel remains visible and readable; nobody can post until you Unlock it. Great for announcements-only mode or emergency lockdowns.

Re-enables @everyone's Send Messages permission, reversing a Lock Channel. When the dust settles, unlock and get the conversation flowing again.