Features
Shop and items
In most bots a shop item is a name and a price. In Guaca an item is a small program: requirements that decide who may buy or use it, and an ordered list of actions that run when they do.
Requirements
- · has the Players role
- · net worth ≥ 5,000
On purchase
- · give Avocado Green
- · reply “Looking fresh!”
7 days later
- · Avocado Green comes off
Buying and using
/shoplists what is for sale, cheapest first./buypays from cash; if the money is in the bank, the reply says to/withdrawfirst.- An item can have limited stock, a per-member limit, and can be hidden from
/shopwhile still existing. - Items that stay in the inventory show up in
/inventory, with expiry times for anything temporary. Usable ones are spent with/use.
# economy
luig used /buy
Requirements
Checked at the moment someone tries to buy or use the item. All of an item’s requirements must pass.
| Requirement | Passes when |
|---|---|
| Has a role | Must have all of these roles, at least one of them, or none of them. |
| Is wealthy enough | Net worth of at least an amount (cash + bank + farm reserve). |
| Owns another item | Must own a number of another item, or must not own it at all. |
Actions
Nine kinds, run in the order you arrange them. Each one fires on purchase, on /use, or both.
| Action | What it does |
|---|---|
| Respond | Replies with a message you write. |
| Give roles | Grants one or more roles, optionally for a set time. |
| Remove roles | Takes roles away, optionally for a set time. |
| Pay | Adds money to the member’s balance. |
| Charge | Takes money from the member’s balance. |
| Give items | Hands over another item, optionally for a set time. |
| Take items | Consumes another item the member owns. |
| Streak freeze | Adds freezes that protect a /daily streak. |
| Clear game cooldowns | Resets the waiting time on every game. |
Timed reversal
Give a role or item action a duration (for example 7 days) and the opposite is scheduled at the moment of purchase: the role comes off, or the item is taken back, on time, even if the member never opens Discord again.
That is what keeps a shop useful in month three. A permanent role drains currency once; a seven-day role drains it for as long as people want to keep wearing it.
Colours and exclusive groups
Put several role items in the same exclusive group, such as name colours, and a member can own many but wear only one at a time. /color switches between the ones they own for free, without buying again.
Making items
Dashboard → Shop items is the full editor: name, description, emoji, price, stock, per-member limit, exclusive group, whether it stays in the inventory, whether it can be used, whether it is listed, and every requirement and action.
/item create is the quick version from Discord: a name, a price, and at most one role, with an optional duration, stock, limit, emoji and description. Anything more goes through the dashboard.
/daily, and an Extra Chip (400) that clears your game cooldowns when used. They are named in the server’s language, and you can edit or delete them.