Vellum docs

One bot for your community — Discord and ER:LC. Everything is free and configured from the dashboard. This guide covers the automation builder (Blueprints), AI, ER:LC, and Credits. Jump to the full node reference any time.

Getting started

  1. 1Invite Vellum and open the dashboard. Pick your server.
  2. 2Open Automations. A flow is a Trigger → Actions graph: something happens, then Vellum does things.
  3. 3Click Create flow to open the full-screen builder. Drag nodes from the right rail, wire their pins together, then Test and Publish.
Create your first flow — demo coming soon

Building a flow

Nodes have two kinds of connections. Execution wires (the ▷ wedges) decide the order things run. Data wires (the round colored dots) pass values — a message’s author, a number, some text. Colors show types; you can only connect compatible pins.

Pure value nodes (conditions and transforms) have no execution pins — they’re pulled on demand when something reads them. Use Branch to take different paths, For each to loop a list, and Wait to pause.

Every run is bounded by safety limits (messages, ER:LC commands, AI calls, loop iterations) so a flow can never run away. Hit a limit and the run stops with a clear message — raise the limit with Credits.

Values & variables

Type a value straight into a node’s field, or hit “↗ Make this a value node” to turn it into its own Text / Number / Toggle value node and wire it in — handy when you reuse the same value in several places.

For memory, use the State nodes. Set / Get variable hold a value for one run. Save / Load value persist between runs, per server or per member. Add to counter is an atomic number — the building block for points, XP, balances and warns. Leaderboard ranks members by any number. Cooldown gate and Only once gate how often something runs.

Recipe: reaction roles

Give a role when someone reacts, take it back when they un-react — no extra module needed:

  1. 1Trigger: Reaction added. Add a Compare (Emoji = 🎮) → Branch.
  2. 2On the true path, Add role (pick the role) to the reaction’s member.
  3. 3Make a second flow with Reaction removedRemove role to take it back.
Reaction roles — demo coming soon

Recipe: economy & XP (it’s just a variable)

There’s no “economy node” — an economy is just a number you store. To pay people for chatting:

  1. 1Trigger: Message sent. Add a Cooldown gate (per member, 60s) so it can’t be farmed.
  2. 2On ready, Add to counter → scope A member, key balance, amount 5.
  3. 3Anywhere else, Load value balance to show it, or Leaderboard balance for a richest-members list. XP/levels work the same way with a key called xp + the Math node.

Recipe: AI auto-reply & triage

Turn on AI first. Then: Message sentClassify (labels: question, spam, other) → Branch. For question, Ask AI with the message content and Reply with the answer. For spam, Delete message.

AI / Groq setup

AI powers the Ask AI, Summarize, Classify and Extract nodes. It’s off by default. Open Automations → Settings:

  1. 1Choose a provider. Groq is free and fast — get a key at console.groq.com → API Keys. You can also bring an OpenAI or Anthropic key.
  2. 2Paste the key (encrypted at rest, never shown again) and optionally set a model. Toggle Enable AI.
  3. 3Each run is capped on AI calls and tokens (raise with Credits). AI prompts and replies are kept out of run logs by default.
Connect Groq — demo coming soon

ER:LC linking & commands

Link your ER:LC private server from the dashboard ER:LC tab (you’ll need its server key from the in-game API settings). Then flows can read the server — Server status, Players in-game, Staff in-game — and react to Player joined / left and Player count crossed triggers.

Commands (kick, ban, jail, teleport, weather, time, peacetime) are off by default. Turn on ER:LC commands in flows in Automations → Settings. They’re tightly rate-limited (1 every 5s) and capped per run, with a queue guard so a flow can’t flood the server. Hints, announcements and PMs work without enabling commands.

Credits & limits

Credits are an earned currency — never bought with real money. You earn them by being active and by sharing good flow templates in the marketplace. Spend them to raise your own limits: more flows, more messages/ER:LC commands/AI calls/tokens per run, more storage keys. Everything is free; Credits just lift ceilings. See your balance on the wallet page.

Premium

Vellum never feature-gates. Premium is a one-time, per-server purchase that simply raises limits (and adds cosmetics) — the same ceilings Credits raise, reachable by everyone for free through activity. No feature is ever locked behind it.