# Shop

## Otevření obchodu

Jak na to:

Napište do chatu `/shop` a stiskněte Enter.

Zobrazí se okno s barevnými ikonkami – každá ikona představuje jednu kategorii.

Najeto na ikonu kategorie (její název a iconka) vám ukáže stručný popis („Klikni pro otevření kategorie“).

## Expirace itemů

Pokud item někdo nezakoupí do 7 reálných dní, vrátí se Vám do inventáře.

## Procházení kategorií a nákup

Když kliknete na vybranou kategorii, otevře se nové okno:

* **Kategorie GUI**: v horní liště je název (např. „Shop: Jídlo“).
* **Rozložení**:
  * Každý slot obsazený předmětem ukazuje jednu „nejlevnější“ nabídku.
  * Pokud existuje hráčská nabídka pro daný item, zobrazí se jako první.
  * Pokud žádná hráčská nabídka neexistuje, zobrazí se běžný item za pevnou „serverovou cenu“.
* **Ukázka hráčské nabídky** (příklad pro „Jablko“):
  * **Název ikonky**: „Prodej \<jmeno\_hrace> (\<mnozstvi>×)“
  * **Lore (popisek)**
    1. ID nabídky
    2. Cena (za kus)
    3. „Klikni pro výběr množství“
  * Pokud tedy někdo nabízí 100 jablek za 8.0 kostiček měny/ks a je to nejlevnější nabídka, zobrazí se ikonka Jablka s textem „Prodej HráčXYZ (100×)“ a v popisku uvidíte ID a jednotkovou cenu.

<figure><img src="/files/nAYmodiaUtIpNWh09O9D" alt=""><figcaption></figcaption></figure>

* **Ukázka serverové nabídky** (když žádný hráč neprodává):
  * **Název ikonky**: „Jablko“
  * **Lore**
    1. „Serverová cena (za ks): 10.0“
    2. „Klikni pro výběr množství“
*

```
<figure><img src="/files/Rn57iQIEzEpBTLb3R32k" alt=""><figcaption></figcaption></figure>
```

## Výběr množství k nákupu

* **Kliknutí na položku** (hráčskou či serverovou) vás dostane do **tenkého GUI pro výběr množství**.
* **Červené sklo**: „−15“, „−10“, „−1“ (snižuje požadované množství)
* **Zelené sklo**: „+1“, „+10“, „+15“ (zvyšuje požadované množství)
* Uprostřed (slot č. 13) je reálný item, který kupujete, s **počet v názvu** (např. „Jablko x5“) a v popisku:
  1. „Množství: 5“
  2. „Celková cena: 40.00“ (5 × 8.0)
  3. „Klikni pro potvrzení nákupu“
* **Jak upravovat množství**:
  * Klikněte na červené („−“) nebo zelené („+“) sklo. S každým kliknutím se změní číslo u prostředního itemu.
  * Pokud se snažíte zvýšit množství nad limit (`dostupné množství` u hráčské nabídky, nebo neomezeně u serveru), plugin vás upozorní červenou zprávou „Tato hráčská nabídka neobsahuje více itemů.“
  * Když máte množství nastaveno na hodnotu, kterou chcete, **klikněte přímo na prostřední item** („Jablko x5“) pro **potvrzení nákupu**.
* Po potvrzení se obratem:
  * **U hráčských nabídek**:
    * Z vašeho účtu se strhne *celková cena* (5 × 8.0 = 40).
    * Prodávajícímu (hráči, který nabídku vytvořil) se okamžitě přičte 40 (minus případné poplatky, pokud jsou nastaveny).
    * Pokud prodávající offline, uloží se mu zpráva („Tvoje nabídka ID XYZ byla prodána...“) a peníze mu přibydou do Vaultu.
    * Nabídka se aktualizuje:
      * Pokud zbylo méně kusů, než jste koupili, zůstane nová snížená nabídka.
      * Pokud jste koupili vše, položka se odstraní ze seznamu.
  * **U serverových nabídek**:
    * Z vašeho účtu se strhne *celková cena* (např. 5 × 10.0 = 50).
    * Předměty (5 × jablko) vám ihned přibudou do inventáře.

## Nabídka vlastních předmětů k prodeji

1. Držte ve své ruce **stack itemů** (např. 20 × jablko), který chcete nabídnout.
2. Napište do chatu:

   ```
   /shop sell <cena>
   ```

   * `<cena>` je cena za **1 kus**, kterou chcete nastavit.
   * **Podmínka**: Musí být nižší než serverová cena, ale maximálně 20 % pod ní. (Pokud serverová cena jablka je 10.0, nejnižší povolená cena je 8.0.)
3. Pokud je všechno v pořádku, váš stack (20 × jablko) se sníží z inventáře a nabídka se uloží s novým ID (např. „abc12345“). Zobrazí se vám zpráva:

   ```
   Nabídka uložena s ID abc12345. Item: JABLKO (20×) za 8.0 (za kus).
   ```
4. Ihned dostanete potvrzení v chatu a vaše nabídka se automaticky zobrazí v příslušné kategorii (v okně obchodu).

## Zrušení vlastní nabídky

Pokud si přejete nabídku zrušit (např. chcete vrátit zbývající předměty zpět do inventáře), napište:

```
/shop cancel <ID>
```

* `<ID>` je osmimístné ID, které jste obdrželi při vytvoření nabídky (např. „abc12345“).
* Po úspěšném zrušení se zbylé položky vrátí do vaší aktuální inventáře.
* Pokud jste zrušili správné ID a měli jste například 5 kusů stále na prodej, dostanete je zpět.
* Získáte v chatu potvrzení:

  ```
  Nabídka abc12345 zrušena; 5× JABLKO vráceno do inventáře.
  ```
* V kódu je zajištěno, aby se nikdo nemohl pokusit koupit nabídku současně, během rušení.

## Zobrazení vlastních nabídek

* Příkaz:

  ```
  /shop own
  ```
* Po zadání se vám zobrazí seznam všech vašich aktuálně neprodaných nabídek ve formátu:

  ```
  ID   Item    Množství   Cena (za ks)
  abc12345   JABLKO   15   8.0
  def67890   DIAMANT  3    40.0
  ```
* Pokud momentálně žádné nabídky nemáte, uvidíte zprávu:

  ```
  Žádné aktivní nabídky.
  ```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.hesovodoupe.cz/slimefun/shop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.