Como usar o Logic Builder
Hi there! I'm Ayami. I'll explain everything nice and slow, from scratch — no programming knowledge needed. Promise!
"Take it step by step, at your own pace. I'll be right here with you until it all clicks." — Ayami
Before you start
Hi! First of all, take a deep breath — you don't need to know how to code. Really! The Logic Builder is made entirely of buttons, clicks, and menus. You'll never need to write code.
Think of it as a little building-block game. You pick a block here, snap another one there, and boom — you've built a whole automation by yourself.
This page will teach you one thing at a time, in the right order. Take your time — there's no rush at all. If you want to jump straight to a topic, just use the menu on the side (or, on mobile, the menu up top)!
What is a Flow?
A Flow is a little automatic rule you create once, and from then on I take care of everything, forever. You don't need to do anything each time — I do it for you!
Imagine you have a lamp that turns on by itself when someone walks into the room. You don't flip the switch — it just knows the right moment to turn on. A Flow works exactly the same way, just on your Discord server:
(on Discord: someone sends a message, joins the server, clicks a button...)
(on Discord: if the person has a certain role, if the message contains a certain word...)
(on Discord: I send a message, give a role, save a number...)
That's it! Every Flow, no matter how complicated it looks, is always this same 3-step recipe. Let's go through each step slowly now.
The 3 parts of a Flow
Every Flow you create has these 3 little parts. They even have "technical" names, but don't worry — they're just 3 words, and I'll explain each one in depth right after:
The moment that kicks everything off. Without it, nothing happens.
A check before doing something. You might not have any at all.
What I actually do once everything checks out.
You don't need to memorize the words "Trigger", "Condition" and "Action" right now — they'll come up naturally as you use the Logic Builder. They'll feel familiar to you in no time!
And look — these 3 parts show up as 3 buttons inside the panel, on Discord. Just click each one to configure it:
Welcomes people who join the server
This is the configuration panel — it shows up when you open a Flow. Each button takes you to set up one of the 3 parts.
1. The When (Trigger)
The When is the starting point. It's the only required part of a Flow — every Flow has exactly one When, and it decides the right moment for everything to start.
Think of it as the "alarm going off". While the alarm hasn't rung, nothing happens — as soon as it rings, the sequence begins.
Here are a few "alarms" you can pick from (you select one from a small list, no typing needed):
Someone sent a message
Every time anyone writes in a channel.
A new person joined
The exact instant someone joins the server.
Someone clicked a button
You create a button, and when it's clicked, the Flow starts.
The message had a link
Only starts if the message sent contains a website address.
Joined a voice call
When someone joins a voice channel to chat.
Reacted to a message
When someone adds an emoji reaction to a message.
There are more "When" options than these — but don't worry about memorizing them all. When it's time to build your Flow, just scroll the list and pick the one that fits what you want to do.
Here's what the selection screen looks like: you click the " Trigger" button in the Flow Menu, and this list opens for you to choose from:
Choose the category below, then the exact event:
2. The If (Condition)
After the When happens, I can check one or more little things before moving on. It's like a doorman in front of a door: he only lets in whoever's on the list.
The If is completely optional. If your Flow doesn't need to check anything, just don't add any — I'll go straight to the Then!
If you add more than one If, all of them need to be true for me to continue. If one fails, I stop right there and skip the rest.
A few examples of "If" you can pick from:
The person has a specific role
E.g.: only continue if the person has the @VIP role.
It's not a bot
So I don't react to other bots on the server.
A saved number is greater than X
E.g.: only continue if the person already has 100 points or more.
It's in a specific channel
E.g.: only works inside the #chat channel.
By luck (random chance)
E.g.: only continue with a 30% chance — great for surprises!
In this example, the person was a Moderator — so I stopped at the "If" and didn't delete their message. That's exactly how it should work!
To add an If, click " Conditions" in the Flow Menu. This screen opens:
No condition added yet — with none, the Flow always goes straight to the Then!
Clicking " Add Condition" opens another list — just like the Trigger one — for you to choose what to check.
3. The Then (Action)
The Then is the fun part — it's what I actually do once everything checks out! You can request several things in a row, and I do them one at a time, in the order you set.
Send a message in a channel
I write something in any channel on the server.
Send a private message
I send a DM straight to the person, privately.
Give someone a role
I add a role to the person automatically.
Delete the message
I remove the message that started it all.
Store or change a number
I save, add, or subtract some value — like XP or coins.
Wait a little bit
I pause for a few seconds before doing the next thing.
And that's it! When = If = Then. The 3 parts together form a complete Flow. From here on, we'll look at extra things that make your Flows even smarter.
To add an Action, click " Actions" in the Flow Menu, then " Add Action", pick "Send message", and fill in this little box:
Important, here's the difference to know: the configuration screen you see (the dark cards with buttons) is just the panel where you set things up. The message that goes out in the end, once the Flow runs, is a normal Discord message — no dark cards involved. Here's what it actually looks like:
See? Simple as that — plain text, just like any message anyone sends on Discord.
Storing information (Variables)
Sometimes you want me to remember a number or piece of text even after the Flow finishes — like how many points each person has. That's what Variables are for.
Think of a variable as a sticky note with a name written on it. You write "XP" on the note and stick the number 340 to it. Whenever you want to know someone's XP, you just check their note.
There are only 2 types you really need to know to get started:
For storing amounts you want to add up or compare — like XP, coins, level.
For storing words or phrases — like a name or an item's name.
When you create a variable, you decide whether it's per person (everyone has their own number, like XP) or for the whole server (a single shared number, like a message counter). You don't need to decide this now — it's just an option that shows up when creating one.
With a variable, you can ask me to:
Set a value
E.g.: set XP to zero.
Add
E.g.: give +25 XP.
Subtract
E.g.: take away 100 coins.
Roll a random number
E.g.: a random value between 10 and 50.
Custom messages (Placeholders)
When you write a message in an Action, you can use some magic words in curly braces — like {user} — that I swap for the real value when sending. That way, each person gets a different message, with their own name!
Here are the most-used magic words — no need to memorize them all, just come back to this table when you need it:
| You write | I insert | Example |
|---|---|---|
| About the person | ||
| {user} | Their username | Ayami Hoshiori |
| {user_mention} | A mention that pings the person | @Ayami Hoshiori |
| {user_nickname} | Their server nickname | Ayami ⭐ |
| {user_avatar} | The link to their profile picture | https://cdn.discordapp.com/... |
| About the server | ||
| {guild} | Server name | Jardim da Ayami |
| {guild_members} | How many people are in the server | 1.842 |
| About the channel | ||
| {channel} | Where it happened | #geral |
| Your variables | ||
| {var:nome} | The value you stored in a variable | 340 |
| Miscellaneous | ||
| {date} | Today's date | 19/06/2026 |
| {aleatorio:a,b,c} | Randomly picks one of these values | b |
Cute tip: use {random:Hi,Hey,Yo,Hiya} to have me pick a different greeting every time — so your welcome messages don't get repetitive!
Pretty messages (Publications)
When an Action sends a message, it can come in 3 different flavors. You choose which one to use in the panel, and each looks a bit different on Discord. Let's look at all 3:
These 3 flavors below are different from the dark panel shown in the other sections! That dark panel is just the screen where you set things up. The messages below are what the person on the server actually sees once the Flow runs.
Plain text
The most basic option — just plain text, like any message anyone sends:
Great for quick, direct notices. You just can't add color or an image inside it.
Embed (colored card)
If you want something prettier — with a title, a colored side bar, a description, and an image — choose an Embed:
In the panel, you fill out each part of the Embed separately:
The color of the bar that shows up on the left side of the card.
The highlighted phrase at the top of the card.
The main text, right below the title.
A large photo inside the card itself.
Buttons and menus
In either of the two options above (text or embed), you can also add clickable buttons below the message:
These real buttons can become the When (Trigger) of another Flow — remember "Someone clicked a button" up above? This is exactly that kind of button!
You choose Plain text or Embed right in the panel, and you can use the magic words ({user_mention}, {guild}...) in either of them!
The Logic Builder panel, step by step
Now I'll show you the real panel that opens inside Discord when you use the /setup command. All you need to do is click the buttons — I'll guide you screen by screen!
Open the main panel
Use the /setup command in any channel. This panel shows up — it's the Logic Builder's home screen:
Hi! I'm Ayami and I'm here to help you build amazing automations in Ayami's Garden!
With the Logic Builder you create automatic rules — no coding required!
Total: 0 · None created yet
Total: 0 commands
Click the green " New Flow" button to start creating your first one!
Give your Flow a name
A little text box (called a "modal") will open. Just fill it in and submit:
Write any name that'll help you remember what this Flow does — like "Welcome" or "Anti-Link". The description is just to help you stay organized, so you can even leave it blank.
Choose the When (Trigger)
As soon as you submit the name, I'll take you straight to choosing the When. Just open the little list and select a category:
What's a Trigger? It's the "spark" that starts your Flow!
Current Trigger: none set
Choose, for example, "Members" — a second little list appears with only member events, like "A new member joined". Click that option and the Trigger is set!
The Flow Menu — your command center
Once you've set the When, I take you to the Flow Menu. This is where you add Conditions, Actions, and turn your Flow on or off whenever you like:
Welcomes people who join the server
Cooldown: None
This screen is the "command center" for your Flow. Any time you want to change something — swap the Trigger, add a Condition, create an Action — you always come back here.
Add an Action
Click " Actions" in the Flow Menu, then " Add Action". Choose the category (e.g. "Message") and then the exact type (e.g. "Send message"). Finally, just fill in where and what will be sent:
Done! Your Flow is now complete: When someone joins Ayami's Garden, I'll automatically send this welcome message. You can go back to the Flow Menu and add as many Actions and Conditions as you like!
Connecting two Flows (Custom Event)
Sometimes you want two Flows to work together — like earning XP and, once it hits a certain number, automatically leveling up. That's what the Custom Event is for: one Flow "calls" the other.
In one Flow you use the "Call another flow" Action. In the other Flow, you use "Custom event" as its When — it sits there waiting to be called.
Flow 1 runs every time someone sends a message and keeps stacking up XP. Once it's done, it calls Flow 2 — which checks whether it's time to level up. Each one taking care of its own part!
Ready-to-copy examples
Enough explaining — now let's look at complete Flows you can build right now! Click each one to open it up and see the step-by-step.
If they're a moderator, I do nothing — they can send links freely.
First, create a variable called xp (number, starts at 0).
Ready to build your own?
Add Ayami to your server, use /setup, and the Logic Builder will already be waiting for you!