> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Produkty

> Dodawaj rangi, itemy i walutę w grze: cena, komendy realizacji, warianty, pakiety z bonusem i zdjęcia.

Produkt to wszystko, co gracz może u Ciebie kupić — ranga, klucz do skrzynki, zestaw albo waluta w grze. Każdy produkt należy do jednego serwera i ma komendy, które plugin wykona na tym serwerze po opłaceniu zamówienia.

> [!WARNING]
>
> Zanim dodasz pierwszy produkt, dodaj [serwer](https://andcze.mintlify.site/pl/shop/servers.md). Bez serwera produktu nie da się zapisać.

## Dodaj produkt

**1. Wybierz serwer**

Wskaż serwer, na którym zakup ma zostać zrealizowany. Produkt zostaje do niego przypisany na stałe w tym formularzu.

**2. Uzupełnij podstawy**

Nazwa (np. „Ranga VIP”) i cena. Opcjonalnie **cena przed promocją** — wyższa, przekreślona cena pokazywana obok aktualnej.

**3. Wybierz sposób sprzedaży**

**Ilość (suwak)** albo **Warianty** — patrz niżej.

**4. Wpisz komendy realizacji**

Co najmniej jedna komenda, jedna na linię. To one dostarczają zakup do gry.

**5. Dodaj opis i zdjęcia**

Krótki opis (na karcie produktu), pełny opis (na stronie produktu) i zdjęcia — pierwsze jest miniaturą.

**6. Przetestuj, potem aktywuj**

Zapisz produkt jako szkic, zrób testowy zakup i dopiero wtedy włącz **Aktywny**.

## Treść cyfrowa zamiast komend

Produkt może też wydawać **klucze licencyjne**, **plik do pobrania** albo **wiadomość** — bez pluginu i serwera gry. Rodzaj dostawy wybierasz w formularzu produktu; szczegóły w [Dostawie treści cyfrowych](https://andcze.mintlify.site/pl/shop/digital.md).

## Komendy realizacji

Po opłaceniu zamówienia plugin wykonuje komendy produktu w konsoli serwera, po kolei. W komendach możesz użyć zmiennych:

| Zmienna | Zostanie zastąpiona przez |
| - | - |
| `{PLAYER}` | nick gracza, który kupił produkt |
| `{PRODUCT}` | nazwę kupionego produktu |
| `{QUANTITY}` | liczbę kupionych sztuk (z bonusem z pakietu) |

Przykład dla rangi i monet:

```text theme={null}
lp user {PLAYER} parent add vip
eco give {PLAYER} {QUANTITY}
broadcast {PLAYER} kupił {PRODUCT}!
```

> [!WARNING]
>
> Produkt aktywny z błędną komendą oznacza, że gracz zapłaci i nic nie dostanie. Zawsze zrób testowy zakup przed aktywacją — najprościej z kodem rabatowym 100% (zobacz [Rabaty i vouchery](https://andcze.mintlify.site/pl/shop/discounts.md)).

## Ilość czy warianty

Produkt sprzedajesz w jednym z dwóch trybów — wzajemnie się wykluczają.

> **Ilość (suwak)**
>
> Gracz sam wybiera liczbę sztuk, cena jest za sztukę. Dla waluty, punktów i kluczy. Możesz dodać pakiety z bonusem.

> **Warianty**
>
> Gracz wybiera jedną z gotowych opcji, np. „VIP 30 dni” i „VIP 90 dni”. Każdy wariant ma własną cenę i opcjonalnie własne komendy.

| Pole (suwak) | Znaczenie | Domyślnie |
| - | - | - |
| Min. ilość | najmniejsza liczba sztuk w jednym zakupie | `1` |
| Maks. ilość | największa liczba sztuk w jednym zakupie | `64` |
| Krok | o ile zmienia się ilość, np. `10` = 10, 20, 30… | `1` |

W trybie **Warianty** dodasz do 20 wariantów. Wariant bez własnych komend używa komend domyślnych produktu. Musi istnieć co najmniej jeden wariant z ceną.

### Pakiety z bonusem

W trybie suwaka możesz dodać do 12 **sugestii pakietów** — gotowych kafelków pod suwakiem. Każdy pakiet ma **ilość** i **bonus** (sztuki gratis). Bonus jest doliczany automatycznie do tego, co dostaje gracz, więc `{QUANTITY}` w komendzie obejmuje już gratisy.

| Ilość | Bonus | Gracz dostaje |
| - | - | - |
| `500` | `0` | 500 monet |
| `1000` | `200` | 1200 monet |
| `5000` | `1500` | 6500 monet |

## Ceny dla metod płatności

Domyślnie produkt można kupić każdą metodą płatności dodaną w sklepie. W ustawieniach produktu możesz:

* wyłączyć wybrane metody dla tego produktu,
* ustawić **inną cenę dla konkretnej metody** — np. wyższą dla płatności SMS, które mają wysoką prowizję. Puste pole = cena standardowa.

W trybie wariantów cenę dla metody ustawiasz osobno przy każdym wariancie. Metody są rozpoznawane po swoim unikalnym kodzie, więc dwie metody tego samego operatora (np. dwa konta Stripe) mogą mieć różne ceny. Więcej: [Płatności](https://andcze.mintlify.site/pl/shop/payments.md).

## Zdjęcia

Zdjęcie możesz wgrać z dysku albo podać adres URL obrazu hostowanego gdzie indziej (jeden adres na linię). Pierwsze zdjęcie jest miniaturą, pozostałe tworzą galerię.

| Zasada | Wartość |
| - | - |
| Formaty | PNG, JPEG, WebP, GIF |
| Maks. rozmiar pliku | 8 MB |
| Miejsce na pliki sklepu | 10 MB (po kompresji) |
| Usuwanie nieużywanych plików | po 1 h (plan Darmowy) lub 24 h (Pro) |

Wgrane obrazy są automatycznie sprawdzane, kompresowane do WebP i pozbawiane metadanych. Wgranie pliku to jeszcze nie zapis — plik jest „używany” dopiero po zapisaniu produktu. Plik, który nie jest użyty w żadnym produkcie ani ustawieniu, zostanie po okresie ochronnym usunięty.

> [!NOTE]
>
> Gdy podajesz zewnętrzny adres URL, ItemShop nie odpowiada za jego dostępność — jeśli obraz zniknie z tamtego serwera, zniknie też z Twojego sklepu.

## Widoczność i kolejność

| Ustawienie | Działanie |
| - | - |
| **Aktywny** | włączony = produkt jest w sklepie; wyłączony = szkic ukryty przed graczami |
| **Wyróżniony** | produkt dostaje plakietkę i mocniejszą ekspozycję — dla bestsellerów i nowości |
| Kolejność | kolejność na liście produktów = kolejność w sklepie; zmieniasz ją przeciąganiem |
| Tłumaczenia | jeśli sklep ma kilka języków, podajesz nazwę i opisy w każdym; puste pola pokazują wersję domyślną |

Usunięcie produktu jest nieodwracalne, ale nie kasuje historii zamówień. Jeśli chcesz tylko schować produkt, wyłącz **Aktywny**.

## Dalej

> **[Płatności](https://andcze.mintlify.site/pl/shop/payments.md)**
>
> Podłącz operatora, żeby gracze mogli zapłacić.

> **[Plugin](https://andcze.mintlify.site/pl/shop/plugin.md)**
>
> Zainstaluj plugin, który wykonuje komendy produktów.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.