Reference

All commands

All 43, generated from what the bot registers with Discord, so this page cannot list a command Guaca does not have. Who is the Discord permission a member needs by default; server owners can change it in Server Settings → Integrations. Where says whether the channel allowlist applies.

Economy

Cash, bank, transfers and the leaderboard. How it works →

/balance

Who:
Everyone
Where:
Your own: any channel · someone else’s: allowed channels

Your own balance is a private hub: cash, bank, farm, net worth and rank, every switched-on income command with whether it is ready, the games that are on, one tip, and buttons for Daily, Work, Deposit all and your farm.

Someone else’s balance shows only their total, never how it is split between cash and bank.

The hub buttons only work in the server’s allowed channels, because Work, Daily and the farm card post in the channel.

  • user
    member
    Whose balance to show

/deposit

Who:
Everyone
Where:
Allowed channels only

Moves cash into the bank, where /rob cannot reach it. Leave the amount empty, or type "all", to deposit everything.

  • amount
    text
    How much, or "all"

/withdraw

Who:
Everyone
Where:
Allowed channels only

Takes money out of the bank into cash. Games and the shop spend cash. Empty or "all" withdraws everything.

  • amount
    text
    How much, or "all"

/give

Who:
Everyone
Where:
Allowed channels only

Sends some of your cash to another member. You cannot pay yourself or a bot.

  • user required
    member
    Who receives it
  • amount required
    whole number · min 1
    How much to send

/leaderboard

Who:
Everyone
Where:
Allowed channels only

The richest members, ten per page. Sort by total (net worth: cash + bank + farm reserve), cash or bank.

Bots and anyone the server excluded (Dashboard → Server) are left off.

  • sort
    text
    Which balance to rank by
    totalcashbank
  • page
    whole number · min 1
    Page number

Income

Daily rewards, jobs with risk, and robbery. How it works →

/work

Who:
Everyone
Where:
Allowed channels only

An honest job. Always pays, never fails: 20 to 250 by default.

Cooldown: 4 hours by default (Dashboard → Income).

/hustle

Who:
Everyone
Where:
Allowed channels only

A side hustle: 100 to 400 by default, but it fails 35% of the time. A failure costs the larger of half the rolled payout or 15% of your net worth.

Cooldown: 4 hours by default (Dashboard → Income).

/crime

Who:
Everyone
Where:
Allowed channels only

High risk: 300 to 900 by default, and it fails half the time. A failure costs the larger of 60% of the rolled payout or 30% of your net worth.

Cooldown: 4 hours by default (Dashboard → Income).

/rob

Who:
Everyone
Where:
Allowed channels only

Tries to take another member’s cash. Only cash is at risk, never the bank or the farm. Every reply is private.

The richer you are compared with their cash, the likelier you fail: your net worth ÷ (their cash + your net worth), kept between 20% and 80%. Success takes the rest of that percentage of their cash; failure fines you 30% of your net worth.

Refused while you are in debt, against bots, and against someone with no cash.

Cooldown: 4 hours by default (Dashboard → Income).

  • user required
    member
    Who to rob

/daily

Who:
Everyone
Where:
Allowed channels only

Claims the daily reward and extends your streak. The day resets at midnight in the server’s time zone, not 24 hours after your last claim.

Pays 250, plus 50 for every day of streak, growing for 14 days. Milestones pay 1,500 at 7 days, 8,000 at 30, 35,000 at 100 and 200,000 at 365.

A streak freeze (bought as a shop item) covers a missed day.

Shop and items

Buying, using, wearing and creating items. How it works →

/shop

Who:
Everyone
Where:
Allowed channels only

Lists what is for sale, cheapest first, six per page: price, stock, what each item does and what it requires.

  • page
    whole number · min 1
    Page number

/buy

Who:
Everyone
Where:
Allowed channels only

Buys an item with your cash and runs its purchase actions: roles, timed roles, streak freezes and so on. The item box suggests names as you type.

If your money is in the bank, the refusal tells you to /withdraw first.

  • item required
    text
    Item name — suggestions appear as you type
  • quantity
    whole number · min 1
    How many

/use

Who:
Everyone
Where:
Allowed channels only

Uses an item you own and runs its on-use actions. Only usable items you hold are suggested.

  • item required
    text
    Item name — suggestions appear as you type
  • quantity
    whole number · min 1
    How many

/inventory

Who:
Everyone
Where:
Any channel

Privately lists what you own, what you are wearing, and when anything temporary expires.

/item

Who:
Manage Server
Where:
Any channel

Creates, deletes and lists shop items from Discord. /item create attaches at most one role; requirements and multi-step actions are made in Dashboard → Shop items.

/item create

Creates an item. Give it a role and a duration (7d, 12h) and the role comes off on schedule. Stock caps total copies; limit caps copies per member.

  • name required
    text
    Item name
  • price required
    whole number · min 0
    Price
  • role
    role
    Role to grant on purchase
  • duration
    text
    How long the role lasts, e.g. 7d or 12h
  • stock
    whole number · min 0
    Total copies available
  • limit
    whole number · min 1
    Max per member
  • emoji
    text
    Icon
  • description
    text
    Shown in the shop

/item delete

Deletes an item by name.

  • name required
    text
    Item name

/item list

Lists up to 50 items, hidden ones included.

/color

Who:
Everyone
Where:
Allowed channels only

Switches which of your owned role items you wear, for free. Items in the same exclusive group can be owned together but worn one at a time. Leave it empty to list them.

  • item
    text
    Leave empty to see what you own — suggestions appear as you type

Games

Six games with published odds. How it works →

/coinflip

Who:
Everyone
Where:
Allowed channels only

Call heads or tails. A correct call pays 1.95× your bet, a 97.5% return to player.

Minimum bet 100 by default. One play every 120 seconds per game. The stake leaves your cash before the result exists.

  • bet required
    whole number · min 1
    How much to stake
  • side
    text
    Heads or tails
    headstails

/slots

Who:
Everyone
Where:
Allowed channels only

Spins three reels. Three of a kind and pairs pay by symbol; the measured return to player is 89.8%.

A server can change the reel emoji in Dashboard → Games, never the odds.

Minimum bet 100 by default. One play every 120 seconds per game. The stake leaves your cash before the result exists.

  • bet required
    whole number · min 1
    How much to stake

/roulette

Who:
Everyone
Where:
Allowed channels only

European roulette with a single zero. Bet on red, black, even, odd, low, high, a dozen (1st12, 2nd12, 3rd12) or one number from 0 to 36, which pays 35:1. Spanish words work too: rojo, negro, par, impar, bajo, alto, docena1.

Minimum bet 100 by default. One play every 120 seconds per game. The stake leaves your cash before the result exists.

  • bet required
    whole number · min 1
    How much to stake
  • on required
    text
    red, black, even, odd, low, high, 1st12/2nd12/3rd12, or 0-36

/russian

Who:
Everyone
Where:
Allowed channels only

Six chambers; you choose how many are loaded, 1 to 5. Fair odds minus a 5% house edge: 1.14×, 1.425×, 1.9×, 2.85× or 5.7×.

Minimum bet 100 by default. One play every 120 seconds per game. The stake leaves your cash before the result exists.

  • bet required
    whole number · min 1
    How much to stake
  • bullets required
    whole number · 1–5
    Bullets in the cylinder (1-5). More pays more

/blackjack

Who:
Everyone
Where:
Allowed channels only

Real drawn cards with Hit and Stand buttons. A natural pays 3:2, a win pays 2×, a push returns your bet. Three decks by default (Dashboard → Games).

Only the player who bet can press the buttons.

Minimum bet 100 by default. One play every 120 seconds per game. The stake leaves your cash before the result exists.

  • bet required
    whole number · min 1
    How much to stake

/higherlower

Who:
Everyone
Where:
Allowed channels only

Guess whether the next card is higher or lower. A right guess pays 1.95×, an equal card returns your bet, and aces are low.

Minimum bet 100 by default. One play every 120 seconds per game. The stake leaves your cash before the result exists.

  • bet required
    whole number · min 1
    How much to stake

Leveling

Levels, rankings and XP adjustments. How it works →

/rank

Who:
Everyone
Where:
Any channel

A card with a member’s level, progress to the next one, total XP, message count and board position.

  • user
    member
    Whose rank to show

/levels

Who:
Everyone
Where:
Any channel

The highest levels, ten per page.

  • page
    whole number · min 1
    Page number

/xp

Who:
Manage Server
Where:
Any channel

Adjusts a member’s XP.

/xp add

Adds XP the same way chatting does, so level-up rewards are handed out.

  • user required
    member
    Who receives it
  • amount required
    whole number · min 1
    How much XP

/xp set

Sets XP to an exact figure and recalculates the level.

  • user required
    member
    Whose XP
  • amount required
    whole number · min 0
    Exact XP

Moderation

Actions that open numbered cases, and automod. How it works →

/warn

Who:
Timeout Members
Where:
Any channel

Records a warning against a member.

Opens a numbered case, DMs the member (unless the server turned that off) and posts to the mod-log channel when one is set. Refuses to act on yourself, on Guaca, or on anyone whose top role is at or above Guaca’s.

  • user required
    member
    Member
  • reason
    text
    Reason

/timeout

Who:
Timeout Members
Where:
Any channel

Times a member out for a duration such as 10m, 2h or 7d, up to Discord’s 28-day maximum.

Opens a numbered case, DMs the member (unless the server turned that off) and posts to the mod-log channel when one is set. Refuses to act on yourself, on Guaca, or on anyone whose top role is at or above Guaca’s.

  • user required
    member
    Member
  • duration required
    text
    e.g. 10m, 2h, 7d
  • reason
    text
    Reason

/untimeout

Who:
Timeout Members
Where:
Any channel

Lifts a timeout early. Opens a case like the other actions, but sends no DM.

  • user required
    member
    Member
  • reason
    text
    Reason

/kick

Who:
Kick Members
Where:
Any channel

Removes a member from the server.

Opens a numbered case, DMs the member (unless the server turned that off) and posts to the mod-log channel when one is set. Refuses to act on yourself, on Guaca, or on anyone whose top role is at or above Guaca’s.

  • user required
    member
    Member
  • reason
    text
    Reason

/ban

Who:
Ban Members
Where:
Any channel

Bans a member, optionally deleting up to 7 days of their messages.

Opens a numbered case, DMs the member (unless the server turned that off) and posts to the mod-log channel when one is set. Refuses to act on yourself, on Guaca, or on anyone whose top role is at or above Guaca’s.

  • user required
    member
    Member
  • reason
    text
    Reason
  • delete_days
    whole number · 0–7
    Days of their messages to delete (0-7)

/unban

Who:
Ban Members
Where:
Any channel

Lifts a ban.

Opens a numbered case, DMs the member (unless the server turned that off) and posts to the mod-log channel when one is set. Refuses to act on yourself, on Guaca, or on anyone whose top role is at or above Guaca’s.

  • user required
    member
    Member
  • reason
    text
    Reason

/purge

Who:
Manage Messages
Where:
Any channel

Bulk-deletes up to 100 recent messages in the channel, optionally from one member only. Discord does not allow bulk-deleting messages older than 14 days, so those are skipped. Always records a case.

  • count required
    whole number · 1–100
    How many (1-100)
  • user
    member
    Member

/cases

Who:
Timeout Members
Where:
Any channel

Privately shows the last ten cases, one member’s history, or a single case by number. Automod actions appear here too.

  • user
    member
    Member
  • case
    whole number · min 1
    A specific case number

/automod

Who:
Manage Server
Where:
Any channel

Turns automatic filtering on or off and tunes it. It ships switched off. Exempt channels and roles, and cross-post limits, are set in Dashboard → Moderation.

/automod show

Shows every filter, its threshold and the escalation rule.

/automod on

Switches automod on.

/automod off

Switches automod off.

/automod rule

Turns one filter on or off: invites, scams, links, caps, mentions, words or crosspost. The threshold is the caps percentage, the maximum mentions, or the scam score.

  • filter required
    text
    Which filter
    invitesscamslinkscapsmentionswordscrosspost
  • enabled required
    true / false
    On or off
  • threshold
    whole number · 0–100
    caps %, max mentions, or scam score

/automod words

Replaces the banned word list (comma-separated) and switches the words filter on.

  • words required
    text
    word, other word, ...

/automod escalation

What happens to repeat offenders: after N hits, warn, timeout, kick or ban. By default 3 hits within an hour earn a 10-minute timeout.

  • after
    whole number · 1–20
    Hits before escalating
  • action
    text
    What to do
    warntimeoutkickban
  • timeout_minutes
    whole number · 1–40320
    Timeout length

Community

Giveaways, role menus and birthdays. How it works →

/giveaway

Who:
Manage Server
Where:
Any channel

Posts a giveaway with an Enter button. Lasts from 1 minute to 30 days with 1 to 20 winners; the winners are drawn and announced automatically when it ends.

The host cannot enter their own giveaway.

  • prize required
    text
    What is being given away
  • duration required
    text
    How long, e.g. 2h or 3d
  • winners
    whole number · 1–20
    How many winners

/rolemenu

Who:
Manage Roles
Where:
Any channel

Posts a message with up to five buttons members press to give themselves a role, or take it off again.

Roles with admin-level permissions, and roles above Guaca’s own, are refused.

  • title required
    text
    Heading for the menu
  • role1 required
    role
    Role 1
  • role2
    role
    Role 2
  • role3
    role
    Role 3
  • role4
    role
    Role 4
  • role5
    role
    Role 5

/birthday

Who:
Everyone
Where:
Any channel

Tells Guaca your birthday: a day and a month, never the year. It is announced in the server’s birthday channel, if one is set.

/birthday set

Saves your birthday.

  • day required
    whole number · 1–31
    Day of the month
  • month required
    whole number
    Month
    JanuaryFebruaryMarchAprilMayJuneJulyAugustSeptemberOctoberNovemberDecember

/birthday clear

Forgets it.

Farms

A farm for every member. How it works →

/farm

Who:
Everyone
Where:
Allowed channels only

Everything about farms: start one, stock it, run it, and look at everyone else’s. Farms are off until an admin turns them on in Dashboard → Farms.

/farm status

Your farm card, or another member’s. Someone else’s card hides their reserve.

  • user
    member
    Whose farm

/farm create

Opens your farm. By default you need 7 days in the server and it costs 1,000 from your cash. One farm per member.

  • name required
    text · up to 32 characters
    What to call it

/farm list

Every farm in the server, ranked by what it makes per day.

/farm shop

What you can buy now and what is still locked, with the reason: tier, housing or plot space.

/farm buy

Buys an animal, a crop, a building or feed, paid from the farm reserve.

  • item required
    text
    What to buy — suggestions appear as you type
  • quantity
    whole number · min 1
    How many

/farm sell

Sells produce and feed at the catalogue price, or a building, animal or crop back at half what it cost. A building still housing animals or crops cannot be sold.

  • resource
    text
    What to sell — leave blank to see the whole store — suggestions appear as you type
  • quantity
    text
    How much, or "all"

/farm deposit

Moves cash from your wallet into the farm reserve.

  • amount required
    text
    How much, or "all"

/farm withdraw

Moves money from the farm reserve back to your cash.

  • amount required
    text
    How much, or "all"

/farm upgrade

Moves the farm up a tier, paid from the reserve. Higher tiers produce more and hold more.

/farm jornalero

Hire a farmhand who writes to you privately when your farm needs something, dismiss him, or ask him now.

  • action
    text
    What to do — leave blank to ask his advice
    advicehiredismiss

/farm repair

Pays to bring the farm’s condition back to 100%. The price grows with the damage and with what stands on the farm.

Announcements

Post and schedule announcements. How it works →

/anuncio

Who:
Manage Server
Where:
Any channel

Posts, schedules and manages announcements from Discord. Its subcommands and options are Spanish in every language. Every reply is private.

/anuncio publicar

Posts a one-section announcement now, or at a date and time in the server’s clock (YYYY-MM-DD HH:MM). In the text, \n breaks a line and || starts a paragraph. An event time adds reminders one day and one hour before.

  • canal required
    channel
    Where to post it
  • titulo required
    text · up to 200 characters
    The headline
  • texto required
    text
    The body. \n breaks a line, || starts a new paragraph
  • mencion
    text
    Who to ping. Default: nobody
    nobody@everyone@herea role (pick it in rol)
  • rol
    role
    The role to ping, when mencion is rol
  • fecha
    text · up to 16 characters
    When to post it, YYYY-MM-DD HH:MM in the server clock. Empty posts now
  • evento
    text · up to 16 characters
    When the event is, YYYY-MM-DD HH:MM. Reminders go out 1 day and 1 hour before
  • banner
    text
    The picture on top. Default: generated
    generatednone

/anuncio borrador

Posts or schedules a draft written in Dashboard → Announcements.

  • anuncio required
    text
    Which draft — suggestions appear as you type
  • fecha
    text · up to 16 characters
    When to post it, YYYY-MM-DD HH:MM in the server clock. Empty posts now

/anuncio lista

What is scheduled, which reminders are pending, and what failed.

/anuncio cancelar

Cancels a scheduled announcement before it posts.

  • anuncio required
    text
    Which announcement — suggestions appear as you type

/anuncio borrar

Takes an announcement that was already posted down.

  • anuncio required
    text
    Which announcement — suggestions appear as you type

/anuncio previa

Shows you an announcement exactly as it will look. Mentions do not ping.

  • anuncio required
    text
    Which announcement — suggestions appear as you type

Tournaments

Check-in for torneos.aguacatech.io. How it works →

/torneo

Who:
Everyone
Where:
Any channel

Check-in for tournaments run on torneos.aguacatech.io. It works in the channel linked to the tournament. Anyone can use the player subcommands; the organiser ones need Manage Server or Administrator.

/torneo attend

Checks you in for this channel’s tournament.

/torneo drop

Withdraws your check-in.

/torneo status

Who has checked in so far.

/torneo panel

Organisers: posts the public check-in panel with Confirm and Drop buttons.

/torneo mark

Organisers: marks a player present or absent.

  • player required
    text
    Who — suggestions appear as you type
  • present
    true / false
    Present (default) or absent

/torneo sync

Organisers: matches server members to the roster and hands out the tournament role.

/torneo role-clear

Organisers: takes the tournament role back from everyone.

Server admin

Server settings and balances. How it works →

/money

Who:
Manage Server
Where:
Any channel

Adjusts a member’s balance. Every change is written to the ledger.

/money add

Adds money to cash (the default) or bank.

  • user required
    member
    Who receives it
  • amount required
    whole number · min 1
    How much
  • where
    text
    Cash or bank
    cashbank

/money remove

Takes money from cash or bank, never below zero.

  • user required
    member
    Who loses it
  • amount required
    whole number · min 1
    How much
  • where
    text
    Cash or bank
    cashbank

/money set

Sets cash and/or bank to an exact amount.

  • user required
    member
    Whose balance
  • cash
    whole number · min 0
    Exact cash
  • bank
    whole number · min 0
    Exact bank

/config

Who:
Manage Server
Where:
Any channel

Server settings from Discord. For every channel setting, leaving the channel out turns that feature off. Everything here is also in the dashboard, except the starboard and the birthday channel.

/config channels

Shows the channels economy commands and games are allowed in. An empty list means every channel.

/config channel-add

Adds a channel to the allowlist.

  • channel required
    channel
    Channel

/config birthday-channel

Where birthdays are announced.

  • channel
    channel
    Channel

/config starboard

Collects messages that reach a reaction threshold (3 ⭐ by default, up to 50) into a channel.

  • channel
    channel
    Channel
  • emoji
    text
    Which reaction counts (default ⭐)
  • threshold
    whole number · 1–50
    How many reactions are needed

/config test-channel

A channel where Administrators skip the /work, /hustle, /crime and game cooldowns, for testing.

  • channel
    channel
    Channel

/config welcome

Greets new members in a channel. The message can use {user}, {username}, {server} and {count}.

  • channel
    channel
    Channel
  • message
    text
    Uses {user} {username} {server} {count}

/config goodbye

Notes departures in a channel. The message can use {username}, {server} and {count}.

  • channel
    channel
    Channel
  • message
    text
    Uses {username} {server} {count}

/config mod-log

Where moderation cases are posted.

  • channel
    channel
    Channel

/config channel-remove

Removes a channel from the allowlist.

  • channel required
    channel
    Channel

Utility

Checking the bot is alive. How it works →

/ping

Who:
Everyone
Where:
Any channel

Checks that Guaca is answering. Shows the response time and the language it will reply in. Works in DMs too.