# 🛒 Sistema di Shop (Survival)

Nel mondo **Survival** è disponibile uno **Shop**, punto di riferimento per tutti i giocatori che vogliono **acquistare o vendere oggetti direttamente in game**.

Puoi aprire lo shop in qualsiasi momento con il comando:

```
/shop
```

Da qui si aprirà una **GUI interattiva** con tutte le **categorie di oggetti**, comodamente organizzate per tipo.\
Lo shop è **in costante aggiornamento**, con nuove sezioni e oggetti che vengono aggiunti regolarmente per rendere l’economia sempre dinamica e bilanciata.

***

### 🧱 Come creare il tuo Shop

Per aprire un negozio personale nel mondo **Survival,** segui questi semplici passaggi:

1. **Procurati una chest**\
   È l’elemento base del tuo negozio. Posizionala nel punto in cui vuoi aprire lo shop: può essere nella tua base, in una zona pubblica o in un’area dedicata al commercio.
2. **Tieni in mano l’oggetto che vuoi vendere o acquistare**\
   Questo serve al sistema per riconoscere automaticamente quale item sarà collegato allo shop.
3. **Crea lo shop con il comando:**

   ```
   /qs create <prezzo>
   ```

   * Sostituisci `<prezzo>` con il valore in **crediti** che desideri.
   * Il prezzo rappresenta il costo (o guadagno) per **una singola unità** dell’oggetto scelto.
4. Dopo aver eseguito il comando, si aprirà automaticamente l’interfaccia dello **Shop**, da cui potrai **personalizzare le impostazioni** del tuo negozio.\ <br>

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

### 💰 Modalità Vendita (Shop di base)

Quando crei il tuo shop con il comando `/qs create <prezzo>`, questo verrà **automaticamente impostato in modalità&#x20;*****Vendita***.

In questa modalità:

* Dovrai **inserire nella chest** la quantità di item che desideri mettere in vendita.
* Il **prezzo indicato** al momento della creazione dello shop si riferisce a **una singola unità** dell’oggetto.
* I giocatori che interagiranno con il **cartello sopra la chest** potranno **acquistare l’item** al prezzo mostrato.
* Ogni acquisto **rimuoverà un oggetto** dalla tua chest e **aggiungerà i crediti** al tuo bilancio.
* Quando la chest si svuota, lo shop non potrà più effettuare vendite fino a quando non reinserirai nuovi item.

Questa modalità è ideale per chi vuole **vendere le proprie risorse** o **offrire oggetti rari** ad altri giocatori, stabilendo il proprio prezzo di mercato.

### ⚙️ Gestione e Personalizzazione dello Shop

Una volta creato il tuo negozio, puoi **interagire direttamente con il cartello** posto sopra la chest per aprire il **pannello di controllo** dello shop.

<figure><img src="/files/9rPvGJHRhjNxCwZjJEIH" alt=""><figcaption></figcaption></figure>

Da questo pannello puoi:

* Visualizzare le informazioni principali del tuo negozio (item, prezzo, quantità, modalità, ecc.);
* **Modificare il prezzo di vendita o acquisto**;
* **Rimuovere lo shop**;
* **Cambiare la modalità dello shop** tra *Vendita* e *Acquisto*.

***

### 🔄 Modalità Acquisto

Cliccando l’opzione per **switchare la modalità**, potrai trasformare il tuo shop da *Vendita* a **Modalità Acquisto**.

In questa modalità:

* Sei **tu** a voler **comprare** un determinato item dai giocatori.
* Inserisci nel pannello il **prezzo** che sei disposto a pagare **per una singola unità** dell’oggetto.
* I giocatori che interagiranno con il cartello potranno **venderti l’item** e riceveranno **i crediti** corrispondenti.
* Gli oggetti acquistati verranno depositati **direttamente nella chest** collegata allo shop.

La modalità Acquisto è utile per chi vuole **rifornirsi di materiali** o acquistare **risorse specifiche** dai giocatori in modo automatico e costante.

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

#### 📦 Gestione della Quantità in Modalità Acquisto

Un aspetto fondamentale della **Modalità Acquisto** riguarda la **quantità massima di oggetti** che i giocatori possono venderti.

* La **capienza della chest** determina **quanti oggetti puoi acquistare**.
* Se la chest è **vuota** o ha spazio libero, i giocatori potranno **continuare a venderti l’item** fino a quando la chest non sarà completamente piena.
* Se vuoi **limitare la quantità acquistabile**, ti basta **riempire parzialmente la chest** con altri oggetti (anche casuali), lasciando spazio solo per la quantità che desideri acquistare.
* Sul **cartello** dello shop viene mostrata la **quantità disponibile all’acquisto**, in modo che i giocatori sappiano **quanti item possono ancora venderti**.

💡 *Esempio:*\
Se vuoi acquistare solo **64 unità di ferro**, puoi lasciare **uno slot libero** nella chest, così i giocatori non potranno vendertene oltre quella quantità.

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

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

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

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

### 🧰 Gestione dello Spazio e Shop Multipli

Il sistema di shop personalizzati permette anche una **gestione avanzata delle chest**, offrendo grande flessibilità per chi vuole ottimizzare il proprio negozio.

#### 🔗 Doppia Chest

* Puoi **espandere la capacità del tuo shop** collegando una **doppia chest**.
* Basta piazzare due chest una accanto all’altra *prima* di creare lo shop.
* Lo shop riconoscerà automaticamente la chest collegata e ne utilizzerà **l’intero spazio** per gestire le vendite o gli acquisti.
* Il **cartello rimarrà uno solo**, posizionato su una delle due chest, ma controllerà l’intero inventario collegato.

#### 🛒 Più Shop sulla stessa Chest

È anche possibile **creare più shop sulla stessa chest**, ognuno dedicato a un item diverso.\
Per farlo:

1. Scegli una **parte laterale libera della chest**.
2. Tieni in mano l’oggetto del nuovo shop.
3. Esegui il comando:

   ```
   /qs create <prezzo>
   ```
4. Il nuovo cartello verrà creato, seguendo le stesse logiche di creazione viste in precedenza.

In questo modo puoi:

* Avere **due item diversi** gestiti nella **stessa chest** (es. uno in vendita e uno in acquisto);
* Oppure creare **due shop separati**, entrambi in vendita o entrambi in acquisto, purché collegati a slot liberi della chest.

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

### 🎨 Personalizzazioni Extra

Oltre alle chest tradizionali, il sistema di shop personalizzati supporta anche **altri tipi di contenitori**, offrendo più libertà estetica e organizzativa.

#### 🧭 Contenitori alternativi

Puoi creare il tuo shop anche utilizzando i **Barili (Barrels)**

Entrambi funzionano **con le stesse regole e comandi** delle chest normali, ma permettono di adattare meglio il tuo negozio allo stile della tua base o dell’area commerciale.

#### 🪵 Personalizzare il cartello

Vuoi dare un tocco di colore o cambiare il tipo di legno del cartello?\
Puoi farlo facilmente con il comando:

```
/qs sign
```

Da qui potrai:

* Scegliere il **tipo di cartello** (legno, betulla, quercia scura, ecc.);
* Personalizzare l’aspetto per **coordinare il tuo shop** al design dell’ambiente circostante;
* Rendere il tuo negozio **più riconoscibile e accattivante**.

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

***

### 🏁 Conclusione

Il sistema di **Shop Personalizzati** nella modalità *Survival* offre un’esperienza di commercio **completamente gestita dai giocatori**.\
Dalla semplice vendita di materiali fino alla creazione di veri e propri **empori multi-item**, ogni player può contribuire all’economia del server in modo dinamico e creativo.

🪙 *Costruisci, commercia e fai prosperare il tuo mercato!*


---

# 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://nientedafa.gitbook.io/nientedafa/sistema-di-shop-survival.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.
