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
- 1Invite Vellum and open the dashboard. Pick your server.
- 2Open Automations. A flow is a Trigger → Actions graph: something happens, then Vellum does things.
- 3Click Create flow to open the full-screen builder. Drag nodes from the right rail, wire their pins together, then Test and Publish.
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:
- 1Trigger: Reaction added. Add a Compare (Emoji = 🎮) → Branch.
- 2On the true path, Add role (pick the role) to the reaction’s member.
- 3Make a second flow with Reaction removed → Remove role to take it back.
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:
- 1Trigger: Message sent. Add a Cooldown gate (per member, 60s) so it can’t be farmed.
- 2On ready, Add to counter → scope A member, key
balance, amount5. - 3Anywhere else, Load value
balanceto show it, or Leaderboardbalancefor a richest-members list. XP/levels work the same way with a key calledxp+ the Math node.
Recipe: AI auto-reply & triage
Turn on AI first. Then: Message sent → Classify (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:
- 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.
- 2Paste the key (encrypted at rest, never shown again) and optionally set a model. Toggle Enable AI.
- 3Each run is capped on AI calls and tokens (raise with Credits). AI prompts and replies are kept out of run logs by default.
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.