> For the complete documentation index, see [llms.txt](https://horizons-cite-plugin.gitbook.io/horizons-cite-plugin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://horizons-cite-plugin.gitbook.io/horizons-cite-plugin/commandes/horizons/shop.md).

# Shop

{% hint style="info" %}
Cette commande permet de gérer les paramètres des shops, notamment le timer de refresh automatique des prix (pause / reprise / vérification).
{% endhint %}

## 📝 Introduction

La commande `shop` permet de gérer les paramètres des shops et notamment le timer de refresh automatique des prix. Elle offre des fonctionnalités pour mettre en pause, reprendre ou vérifier l'état du timer de mise à jour des prix des shops.

## 🔑 Permission

{% hint style="info" %}
Permission requise : `horizons.shop`
{% endhint %}

## 📋 Syntaxe générale

**Format:** `/horizons shop <action>`

## 🎯 Actions disponibles

### 🔄 toggle / pricetimer

**Syntaxe:** `/horizons shop toggle` ou `/horizons shop pricetimer`

**Description:** Alterne l'état du timer de refresh des prix (pause/resume). Si le timer est actif, il sera mis en pause. S'il est en pause, il sera repris.

**Exemples:**

```
/horizons shop toggle
/horizons shop pricetimer
```

***

### ⏸️ pause

**Syntaxe:** `/horizons shop pause`

**Description:** Met en pause le timer de refresh automatique des prix. Le timer ne mettra plus à jour les prix des shops tant qu'il n'est pas repris.

**Exemples:**

```
/horizons shop pause
```

**Note:** Si le timer est déjà en pause, un message d'erreur vous en informera.

***

### ▶️ resume

**Syntaxe:** `/horizons shop resume`

**Description:** Reprend le timer de refresh automatique des prix. Le timer recommencera à mettre à jour les prix des shops selon l'intervalle configuré.

**Exemples:**

```
/horizons shop resume
```

**Note:** Si le timer n'est pas en pause, un message d'erreur vous en informera.

***

### 📊 status

**Syntaxe:** `/horizons shop status`

**Description:** Affiche l'état actuel du timer de refresh des prix (actif ou en pause).

**Exemples:**

```
/horizons shop status
```

## 🎮 Utilisation

### Mettre en pause le timer

```
/horizons shop pause         # Met en pause le timer de refresh des prix
```

### Reprendre le timer

```
/horizons shop resume        # Reprend le timer de refresh des prix
```

### Toggle le timer

```
/horizons shop toggle        # Alterne l'état du timer (pause/resume)
/horizons shop pricetimer    # Alternative pour toggle
```

### Vérifier l'état du timer

```
/horizons shop status        # Affiche si le timer est actif ou en pause
```

## ⚠️ Restrictions

{% hint style="warning" %}

* Le système de shops doit être activé (plugin Citizens requis)
* La permission `horizons.shop` est requise pour utiliser cette commande
* Le timer continue de tourner en arrière-plan, mais ne met pas à jour les prix quand il est en pause
  {% endhint %}

## 📌 Notes importantes

{% hint style="info" %}

* Le timer de refresh est configuré dans `config.yml` via `price_update_interval` dans la section Shop.
* Quand le timer est en pause, les messages de refresh ne sont pas envoyés aux joueurs.
* Le timer reprendra automatiquement au redémarrage du serveur (état non persisté).
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://horizons-cite-plugin.gitbook.io/horizons-cite-plugin/commandes/horizons/shop.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.