Features

Minecraft

A server can hang a Minecraft world off its economy: a town where every member who buys a farm gets a plot and a house, a console that runs the real bot commands from inside the game, a casino in the castle and a portal out to the wild. Everything here is optional and extra — a farm is a Discord thing first, and it works completely without ever opening Minecraft.

Every server brings its own world. Guaca does not host one. An admin points the server at their own Minecraft server in Dashboard → Farms → Config, installs the plugin and issues that server one token. Two servers never share a world, a token or a database.

Getting in

Linking starts in Discord, always. /farm link <your Minecraft name> does two things at once: it gives you a short code, and it puts you on the server’s whitelist so you can actually get in. Join the world and type /link <code> to finish. The code is single use and expires.

It is in that order for a reason: the whitelist is what lets you through the door, so a code minted inside the game would be a code for somebody who cannot be there to type it. Your link is one per person; the whitelist is per server.

The town

The castle stands in the middle and the farms ring it, the first one straight out of the gate. Buy a farm with /farm create and the town builds your plot by itself within a minute: the ground is levelled, roads and lamps go in, a house is stamped on your lot, and a path runs from the road to your doorstep. Everything you buy afterwards appears on the plot the same way — nobody presses anything.

The ring of slabs around your plot is its condition, readable from the road: smooth stone when the farm is healthy, then sandstone, red sandstone, granite and blackstone as it slips. That is deliberate, so a member who never opens Minecraft still has a farm that looks owned and looked after to everyone walking past.

Beside your front door stands a terminal. Right-click it for your farm’s status, the shop, the sell page and the upgrade — the same tills as /farm in Discord, against the same numbers. Only you can open yours.

Inside the town nothing hostile spawns, explosions take no block and fire does not spread. Only your own plot and the castle are protected from other players; the roads and the lawns are ordinary. Your house is yours — Guaca stamps it once and never rebuilds over it, so anything you put inside stays where you left it. Your animals are the farm’s: they cannot be hurt, led away or bred by hand.

If you have hired a jornalero, he stands on the other side of the walk from the terminal, so the two of them frame your door. Right-click him and he tells you what your farm needs — the same thing he sends you privately every few hours. See Farms.

The console

/guaca opens a small chest menu anywhere in the world: what you have in cash and in the bank, which income commands are ready and which are still counting down, the shop, your inventory and the boards. It is not a copy of the bot — every click runs the real command, through the same code Discord talks to, against the same cooldowns and the same ledger.

Results print to chat, not into the menu: an answer is often five or six lines, and an item’s tooltip neither wraps nor scrolls. Because a chest screen hides the chat behind it, the menu also shows the last answer as the item in the middle and plays a sound — sound is the only thing that reaches you while a container is open.

When something you do in game pays out, the same embed Discord would have posted is posted there — your avatar, the server’s currency symbol, the level bonus line and all. What is private in Discord stays private here: a balance or a deposit is never announced.

The casino

The castle’s ground-floor hall is the game room: a table each for blackjack, roulette, higher/lower and russian roulette, a coin-flip stand, four slot cabinets and a cashier. Right-click a table and it asks only what that game needs, then deals. Money can be made anywhere in the world; gambling happens in one place you have to walk to.

Card games are dealt into the chat as clickable text rather than into a menu, because a card you have to hover over to read is not a card you can play. Only a finished hand is posted to Discord, once — a hand still in progress is nobody else’s business, and if the server drops mid-hand the stake comes back to you rather than counting as a loss.

The portal

The town is safe, which also makes it tame. In the castle garden there is an obsidian arch: step in, stand still for three seconds, and you are put down somewhere real between 1,500 and 6,000 blocks away on ground that has been checked for you — no water landing, no cliff face. /volver brings you back to the garden after five seconds of standing still.

It is free, with five minutes between trips. Out there the world is ordinary Minecraft — caves, nights, mobs and everything you can carry home. The portal asks the bot nothing and touches no money, so it is the one part of the town that keeps working when everything else is down.

The portal remembers where it put you. Coming back with /volver keeps the place as your camp, so step into the arch again and it takes you straight there — instantly, because that land already exists. Crouch as you step in to roll somewhere new instead; the countdown tells you which one you are getting before it fires. Your camp only moves when the portal drops you somewhere new, so riding along to a friend's camp never costs you your own.

You can cross together. Whoever is standing inside the arch when the countdown ends travels with you, to the same place — there is nothing to type and nobody to invite, and stepping out of the portal is how you decide not to go. One landing is found for the whole group, so a party costs the server no more than one person does.

If you die out there you wake where the portal left you, not back at your farm gate, and the coordinates of your body are printed in chat so you can walk back for it. A bed you slept in out in the wild still wins — that one is your choice. And the wild makes everybody an ordinary player: survival, no flight, and no /gamemode or anything like it until you are standing in town again.

What the game may run

A game server is not Discord, and Guaca does not trust it like one. Discord decides who may use an admin command before the request ever arrives; a game server inherits none of that. So what a linked player may run from in game is a list written in the bot’s source, never a setting — nineteen commands, and nothing else reaches the economy.

WhatCommandsFrom the game
Your own money/balance, /deposit, /work, /hustle, /crime, /dailyYes
The six games/coinflip, /slots, /roulette, /russian, /blackjack, /higherlowerYes
Shop and boards/shop, /buy, /use, /inventory, /rank, /levels, /leaderboardYes
Money that leaves the safe/withdrawNo
Money between members/give, /robNo
Admin and moderation/money, /config, /ban, /timeout, /purge, …No
From the game, money never moves between members, and never leaves the safe. You can earn your own money and put it *into* the bank, because that can only make it safer. Taking it back out is /withdraw, and a withdrawal pulls savings into cash — the one place /rob can reach — so it stays in Discord, along with /give and /rob themselves. Nothing on the game surface targets another member at all.

A command added to Guaca next year is unreachable from the game until somebody puts it on that list on purpose. /farm link and /farm create stay in Discord even so: linking is what whitelists you, and opening a farm checks how long you have been in the server.

Commands in the world

CommandWhat it does
/link <code>Claims the code /farm link gave you in Discord. One use, then it is gone.
/guacaThe console: your money, the income commands, the shop and the boards. Alias /consola.
/farmYour farm without walking to it — status, shop, buy, sell, upgrade, menu.
/farmhomeTakes you to your own gate. Once every 20 minutes.
/work, /hustle, /crime, /dailyThe same income commands as in Discord, on the same cooldowns.
/volverBack to town from anywhere. Five seconds standing still. Alias /regresar.

Your Discord colour comes with you: the highest role you wear that has a colour paints your name in chat and in the tab list. The floating name above your head keeps the vanilla colour, because Minecraft only has sixteen to choose from there and one surface disagreeing with the others would be worse than none.