Purchase inventory

Everything the player buys goes to their inventory on the server. Nothing is delivered right away: the player opens the inventory and activates each purchase whenever they like. Someone who buys three VIPs can activate one now and keep the other two.

The texts in the game are in Portuguese; the English in parentheses is what they say.

How the player uses it

1. The player opens the inventory with a Switch menu button in the store that leads to the Inventory menu. After paying with Pix in the game, the inventory opens on its own.
2. Each unit bought shows up on its own, like "VIP (1 de 3)" (1 of 3), with the purchase date.
3. The player clicks the purchase. It gets marked with "Clique de novo para ativar" (click again to activate).
4. They click again within 5 seconds. The purchase shows "Entregando..." (delivering), and the plugin runs the product's commands.

The two clicks keep anyone from activating a VIP by accident.

Build the inventory menu

The inventory is a required menu, like the cart. In In-game menus, open the Inventory menu:

What to set up	How
Where purchases show up	Choose slots, in the Inventory menu. Each slot shows one purchase.
More purchases than slots	Previous inventory page and Next inventory page buttons. They disappear when there is no page to go to.
Back to the store	A Switch menu button to the main menu.
Open the inventory	A Switch menu button to the Inventory menu, in any menu of the store.

A purchase shows up with the look of the product's Add to cart button. If the product has no button, it shows up as paper.

If the Inventory menu has no buttons, the plugin uses ready-made page arrows and a back button.

Gifts

The player can give the cart as a gift to another player. Put a Give as a gift button in the Cart menu.

1. The player clicks Give as a gift and types the nickname of whoever will receive it. Before 1.21, they type it in the chat.
2. They pay as usual. They are the one who pays.
3. The purchase goes to the receiver's inventory, with "Presente de:" (gift from) and the giver's nickname in the description.
4. The receiver gets a message when the payment is approved, if they are on the server, and again every time they join while the gift is in the inventory.

The product's commands run for the receiver, when they activate the gift.

To change how the anvil looks, open the Cart menu in In-game menus and use Edit gift screen, right below the coupon screen. {nick} on the confirm item becomes the typed nickname.

The receiver must have joined the server before. To buy for themselves again, the player opens Give as a gift and confirms with the field empty (or types - in the chat).

Open after payment

In Settings, under Inventory, the Open the inventory after payment option is on by default. When the player pays with Pix in the game, the QR code turns into "Compra confirmada" (purchase confirmed) and the inventory opens with the purchase. With it off, the player gets a message and opens the inventory with the button.

Run /hasty update all after changing this option.

Requirements

• Plugin 2.5.0 or newer, or Hasty legacy 0.1.0 on 1.8.9.
• With an older plugin, purchases are delivered right away, as before. Hasty goes by the last plugin that connected with the server key.
• Several servers with the same key share the player's inventory. Use the same plugin version on all of them.

In the dashboard

In Orders, each order shows how many purchases the player has activated, like "1 of 3 used". The order stays Paid while there is a purchase in the inventory, and becomes Delivered when all of them have been activated.

A refund or a chargeback removes the purchases not yet activated from the inventory.

Problems

Message or symptom	Likely cause	What to do
Purchases are delivered right away	The server's plugin is older than 2.5.0 (or legacy 0.1.0).	Update the plugin. See How do I update the plugin?.
Nao foi possivel abrir o inventario agora. Tente de novo.	The server couldn't reach Hasty.	The player tries again in a moment.
Este item nao pode mais ser usado.	The purchase was already activated or was refunded.	Nothing to fix.
... nunca entrou neste servidor.	The gift's receiver never played on the server, or the nickname is wrong.	The receiver joins the server once, and the player tries again.
The Give as a gift button doesn't show up in the game	The server's plugin is older than 2.5.0 (or legacy 0.1.0), or the button is outside the Cart.	Update the plugin, or put the button in the Cart.
The purchase shows "A entrega falhou" (delivery failed)	A product command failed several times.	Fix the cause and use Deliver again, in Orders. See How does delivery work?.