Getting started

This tutorial takes you from a new account to a test purchase delivered in the game. Do it in order: each step builds on the one before.

What you need

• A Spigot or Paper server on Minecraft 1.8.9 or 1.17 onwards, where you have access to the console and the plugins folder.
• A Mercado Pago account, to get paid for sales.
• A Discord or Google account, to sign in to the dashboard.

1. Create the server in the dashboard

1. Sign in to app.hasty.com.br with Discord or Google.
2. Create your server. The address you choose becomes the web store's, for example yourserver.hasty.com.br.

2. Choose the Minecraft version

In In-game menus, in the selector next to Templates, choose your server's version. Hasty builds the store for that version and only lets you use what it supports. See Minecraft versions.

3. Connect Mercado Pago

In Settings, under Payouts, connect your Mercado Pago account. Without it, players can't pay. See How do I get paid for sales?.

4. Add a product

In Products, create a product with a name, a price and at least one command. To test, use a simple command:

say {player} bought from the store!

See How do I create a product?.

5. Install the plugin

Follow How do I install the plugin?. At the end, run in the console:

/hasty update all

The console should show Loja baixada e carregada.

6. Make a test purchase

1. Join the server and run /loja.
2. Add the product to the cart and check out with Pix.
3. Pay the QR code that shows up on the map in your hand. The QR code turns into "Compra confirmada" and your inventory opens.
4. Click the purchase, then click again to activate it.
5. Check the say command's message in the server chat, and in Orders, in the dashboard, the order as "Delivered".

Done: the store is live. Now build the menus your way in How do I build the /loja menus?, and add a Switch menu button to the Inventory menu in the store. See Purchase inventory.

Problems

The plugin shows its messages in Portuguese; they are quoted here as they appear.

Symptom	Likely cause	What to do
/loja answers A loja ainda esta carregando do painel da Hasty.	The plugin hasn't downloaded the store yet.	Run /hasty update all in the console.
The order stays at "Delivering"	The plugin isn't connected.	Check the key in settings.yml and run /hasty reload settings.
At checkout, Erro ao gerar pagamento: shows up	Often, Mercado Pago isn't connected.	Connect it in Settings › Payouts and try again.

For other messages, see Troubleshooting.