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

# Developer Platform

Welcome to your team’s developer platform

## 🛒 QSMarketPlus

#### Plataforma de comercio avanzada para servidores Minecraft

Bienvenido a la documentación oficial de **QSMarketPlus**, un plugin diseñado para servidores que buscan un sistema de **tienda, venta y subastas moderno, potente y fácil de usar**.

QSMarketPlus unifica en un solo plugin:

* 🛍️ Tienda GUI
* ⚡ Venta rápida de inventario
* 📦 Tiendas de cofres de jugadores
* 🪧 Tiendas mediante carteles
* 🏷️ Casa de subastas avanzada

Todo optimizado para **Vault** y compatible con ítems personalizados.

***

### 🚀 Empieza en menos de 5 minutos

Instalar y comenzar a usar QSMarketPlus es rápido y sencillo.

#### 1️⃣ Instalación

1. Descarga el plugin **QSMarketPlus.jar**
2. Colócalo en la carpeta `plugins/`
3. Instala **Vault** (obligatorio)
4. Reinicia el servidor

Al iniciar, se generará automáticamente la carpeta:

```
plugins/QSMarketPlus/
```

***

#### 2️⃣ Primeros comandos

Abre la tienda principal:

```
/shop
```

Vende ítems rápidamente:

```
/sell
```

Abre la casa de subastas:

```
/ah
```

¡Listo! Ya estás usando QSMarketPlus.

***

### 🧩 Sistemas incluidos

#### 🛍️ Sistema de Tienda (/shop)

* Menús gráficos configurables
* Categorías personalizadas
* Compra y venta de ítems
* Soporte completo para NBT

***

#### ⚡ Sistema de Venta Rápida (/sell)

Vende ítems de distintas formas:

```
/sell hand
/sell similar
/sell all
```

✔ Compatible con ítems personalizados\
✔ Solo vende ítems configurados en la tienda

***

#### 📦 Tiendas de Cofres de Jugadores (PlayerShops)

Sistema **tipo survival** muy intuitivo:

1. Coloca un **cofre**
2. Coloca el **ítem dentro**
3. Coloca un **cartel**
4. Usa **polvo de redstone** para vincular el cartel al cofre
5. Configura precio y cantidad:

```
/qsmarket set <precio> <cantidad>
```

✔ Los jugadores compran directamente del cofre\
✔ Sistema persistente y seguro

***

#### 🪧 Tiendas por Carteles (SignShops)

Permite crear tiendas rápidas con carteles.

Comando:

```
/qsmarket setitem <categoria> <itemId>
```

* El cartel queda vinculado a un ítem
* Soporta compra y venta
* Puede usar ítems del shop o ítems en mano

***

#### 🏷️ Casa de Subastas (/ah)

Sistema completo de subastas con interfaz gráfica.

Funciones:

* Ver subastas activas
* Subastar ítems individuales o inventario completo
* Reclamar ítems expirados
* Historial de compras y ventas

Comandos:

```
/ah sell <precio>
/ah sellinv <precio>
/ah history
/ah expired
```

***

### 🧠 Compatibilidad avanzada

QSMarketPlus **NO pierde información del ítem**.

Compatible con:

* ItemsAdder
* Oraxen
* MythicMobs
* MMOItems
* EcoItems
* Ítems con NBT, texturas y metadatos personalizados

***

### 🛠️ Herramientas para administradores

#### ➕ Añadir ítems a la tienda

```
/qsmarket additem <categoria> <precio_compra> <precio_venta>
```

El ítem se guarda **exactamente como está en la mano**, incluyendo NBT.

***

#### 🔄 Recargar configuración

```
/qsmarket reload
```

Recarga:

* Configuración
* Categorías
* Ítems
* Menús
* Mensajes

***

### 📚 Aprende más

En esta documentación encontrarás guías detalladas sobre:

* Configuración de archivos YML
* Creación de categorías
* Uso de cabezas personalizadas
* Permisos
* Optimización del sistema

***

#### 🤝 Comunidad y soporte

¿Tienes dudas o sugerencias?\
👉 Únete al **Discord oficial de QSMarketPlus**: <https://discord.com/invite/KuyqQmgpx2>

Aquí podrás:

* 💬 Recibir soporte
* 🐞 Reportar errores
* 💡 Sugerir mejoras
* 👀 Ver avances del plugin