Ver el código de «Sistema de Tiendas»

= 🏪 Sistema de Tiendas - ComunidadSP =

Aprende a crear '''tiendas automáticas''' con ChestShop que funcionan 24/7, incluso cuando estás offline.

<div style="background: #e8f5e9; padding: 20px; border-left: 4px solid #4caf50; margin: 20px 0;">
'''💰 Economía Real:''' ChestShop es el corazón de la economía de ComunidadSP. Crea tu imperio comercial vendiendo y comprando items a otros jugadores.
</div>

----

== 📖 Índice ==

* [[#¿Qué es ChestShop?|❓ ¿Qué es ChestShop?]]
* [[#Crear Tienda de Venta|🏪 Crear Tienda de Venta]]
* [[#Crear Tienda de Compra|💵 Crear Tienda de Compra]]
* [[#Tienda Mixta|🔄 Tienda Mixta (Compra y Venta)]]
* [[#Gestión de Tiendas|⚙️ Gestión de Tiendas]]
* [[#Tiendas en Claims|🛡️ Tiendas en Claims]]
* [[#Items Especiales|✨ Items Especiales]]
* [[#Consejos de Negocio|💡 Consejos de Negocio]]
* [[#Problemas Comunes|❓ Problemas Comunes]]

----

== ❓ ¿Qué es ChestShop? ==

'''ChestShop''' es un sistema que convierte cofres normales en '''tiendas automáticas'''.

=== Características ===

* ✅ '''Funciona 24/7''' - Vende incluso cuando estás offline
* ✅ '''Totalmente automático''' - No necesitas estar presente
* ✅ '''Seguro''' - Solo el dueño puede modificar precios/stock
* ✅ '''Compatible con claims''' - Funciona en terrenos protegidos
* ✅ '''Cross-platform''' - Jugadores Java y Bedrock pueden usar tus tiendas

=== Componentes de una Tienda ===

Una tienda ChestShop tiene 3 elementos:

# '''Cofre''' - Almacena los items a vender/comprar
# '''Cartel''' - Muestra precios y controla transacciones
# '''Stock/Dinero''' - Items en el cofre (venta) o dinero (compra)

----

== 🏪 Crear Tienda de Venta ==

'''Objetivo:''' Vender tus items a otros jugadores.

=== Paso a Paso ===

# '''Coloca un cofre''' donde quieras tu tienda
# '''Llena el cofre''' con los items que quieres vender
# '''Coloca un cartel''' en el cofre (click derecho en la cara del cofre)
# '''Escribe en el cartel:'''

<pre>
Línea 1: (se llena automáticamente con tu nombre)
Línea 2: Cantidad por transacción
Línea 3: S PrecioVenta
Línea 4: Nombre del item
</pre>

=== Ejemplo: Vender Diamantes ===

{| class="wikitable" style="width: 100%;"
|-
! Línea !! Qué Escribir !! Ejemplo
|-
| '''1''' || (vacío - se llena solo) || <code>TuNombre</code>
|-
| '''2''' || Cantidad de items || <code>1</code>
|-
| '''3''' || S + precio de venta || <code>S 100</code>
|-
| '''4''' || Nombre del item || <code>Diamond</code>
|-
|}

'''Cartel final:'''
<pre>
TuNombre
1
S 100
Diamond
</pre>

'''Significado:''' Vendes 1 diamante por $100 cada uno.

=== Cómo Funciona ===

# Llenas el cofre con diamantes
# Un jugador da '''click derecho''' en el cartel
# Se le cobra $100
# Recibe 1 diamante del cofre
# Tú recibes $100 en tu balance
# '''Todo automático''' - no necesitas estar online

<div style="background: #e3f2fd; padding: 15px; border-left: 4px solid #2196f3; margin: 20px 0;">
'''💡 Tip:''' El dinero se deposita directamente en tu cuenta con <code>/bal</code>. No necesitas un cofre para almacenar dinero.
</div>

----

== 💵 Crear Tienda de Compra ==

'''Objetivo:''' Comprar items de otros jugadores automáticamente.

=== Paso a Paso ===

# '''Coloca un cofre'''
# '''Pon dinero en el cofre''' (items que valen dinero para tener fondos)
# '''Coloca un cartel''' en el cofre
# '''Escribe en el cartel:'''

<pre>
Línea 1: (vacío - se llena solo)
Línea 2: Cantidad
Línea 3: B PrecioCompra
Línea 4: Nombre del item
</pre>

=== Ejemplo: Comprar Hierro ===

{| class="wikitable" style="width: 100%;"
|-
! Línea !! Qué Escribir !! Ejemplo
|-
| '''1''' || (vacío) || <code>TuNombre</code>
|-
| '''2''' || Cantidad || <code>64</code>
|-
| '''3''' || B + precio de compra || <code>B 50</code>
|-
| '''4''' || Nombre del item || <code>Iron Ingot</code>
|-
|}

'''Cartel final:'''
<pre>
TuNombre
64
B 50
Iron Ingot
</pre>

'''Significado:''' Compras 64 lingotes de hierro por $50 el stack.

=== Cómo Funciona ===

# Pones dinero en tu balance (usando <code>/pay</code> a ti mismo desde otra fuente)
# Un jugador con hierro da '''click izquierdo''' en el cartel
# Deposita 64 hierro en el cofre
# Recibe $50 de tu balance
# Tú obtienes el hierro en el cofre

<div style="background: #fff3e0; padding: 15px; border-left: 4px solid #ff9800; margin: 20px 0;">
'''⚠️ Importante:''' Debes tener suficiente dinero en tu <code>/bal</code> para que la tienda funcione. Si te quedas sin dinero, la tienda deja de comprar.
</div>

----

== 🔄 Tienda Mixta (Compra y Venta) ==

'''Objetivo:''' Comprar Y vender el mismo item.

=== Formato del Cartel ===

<pre>
Línea 1: (vacío)
Línea 2: Cantidad
Línea 3: B PrecioCompra : S PrecioVenta
Línea 4: Nombre del item
</pre>

=== Ejemplo: Tienda de Esmeraldas ===

{| class="wikitable" style="width: 100%;"
|-
! Línea !! Qué Escribir !! Ejemplo
|-
| '''1''' || (vacío) || <code>TuNombre</code>
|-
| '''2''' || Cantidad || <code>16</code>
|-
| '''3''' || B precio : S precio || <code>B 40 : S 60</code>
|-
| '''4''' || Nombre del item || <code>Emerald</code>
|-
|}

'''Cartel final:'''
<pre>
TuNombre
16
B 40 : S 60
Emerald
</pre>

'''Significado:''' 
* '''Compras''' 16 esmeraldas por $40 (click izquierdo)
* '''Vendes''' 16 esmeraldas por $60 (click derecho)
* Ganancia: $20 por cada transacción completa

=== Estrategia de Negocio ===

<pre>
Compras barato → Vendes caro = Ganancia

Ejemplo:
1. Compras hierro a $3/unidad (64 × $3 = $192)
2. Vendes hierro a $5/unidad (64 × $5 = $320)
3. Ganancia: $128 por ciclo completo
</pre>

----

== ⚙️ Gestión de Tiendas ==

=== Verificar Stock ===

Simplemente '''abre el cofre''' para ver:
* Cuántos items quedan (tiendas de venta)
* Cuántos items has comprado (tiendas de compra)

=== Cambiar Precios ===

# '''Destruye el cartel''' (click izquierdo como dueño)
# '''Coloca nuevo cartel''' con precios actualizados
# El stock en el cofre se mantiene

<div style="background: #e3f2fd; padding: 15px; border-left: 4px solid #2196f3; margin: 20px 0;">
'''💡 Tip:''' Solo el dueño puede destruir el cartel. Otros jugadores solo pueden comprar/vender.
</div>

=== Retirar Dinero ===

El dinero de tus ventas va directo a <code>/bal</code>. Úsalo con:

<pre>
/bal              # Ver tu dinero
/pay Jugador 500  # Transferir a otro jugador
/buyclaimblocks   # Comprar bloques de claim
</pre>

=== Eliminar Tienda ===

# '''Saca todos los items''' del cofre
# '''Destruye el cartel'''
# '''Rompe el cofre'''

<div style="background: #ffebee; padding: 15px; border-left: 4px solid #f44336; margin: 20px 0;">
'''⚠️ ADVERTENCIA:''' Si rompes el cofre con items dentro, '''se caerán al suelo''' y otros jugadores pueden tomarlos. Siempre vacía el cofre primero.
</div>

----

== 🛡️ Tiendas en Claims ==

=== Tiendas Privadas (Solo tú) ===

Crea la tienda '''dentro de tu claim''' normalmente. Solo tú puedes:
* Abrir el cofre
* Destruir el cartel
* Modificar precios

Otros jugadores pueden:
* Ver el cartel
* Comprar/vender (click en cartel)

'''No necesitas configuración especial.'''

=== Tiendas Públicas (Todos pueden ver stock) ===

Si quieres que los clientes '''vean cuánto stock tienes''':

# Crea tu tienda en un claim
# Usa [[Protección de Terrenos#Subdivisiones|subdivisión]] para el área de la tienda
# Da acceso: <code>/containertrust public</code>

<div style="background: #fff3e0; padding: 15px; border-left: 4px solid #ff9800; margin: 20px 0;">
'''⚠️ Riesgo:''' Con <code>containertrust public</code>, cualquiera puede abrir el cofre. '''NO pongas items valiosos extra''', solo el stock de la tienda.
</div>

=== Zona Comercial Recomendada ===

<pre>
┌────────────────────────────────┐
│   CLAIM PRINCIPAL (Privado)    │
│                                │
│  ┌──────────────────────────┐  │
│  │  Casa / Almacenes        │  │
│  │  (Privado 100%)          │  │
│  └──────────────────────────┘  │
│                                │
│  ┌──────────────────────────┐  │
│  │  SUBDIVISIÓN: Tiendas    │  │
│  │  /containertrust public  │  │
│  │                          │  │
│  │  [Shop] [Shop] [Shop]    │  │
│  └──────────────────────────┘  │
│                                │
└────────────────────────────────┘
</pre>

[[Protección de Terrenos|🛡️ Ver Guía de Subdivisiones]]

----

== ✨ Items Especiales ==

=== Cómo Escribir Nombres de Items ===

ChestShop usa '''nombres en inglés''' del juego. Aquí los más comunes:

==== Bloques ====
{| class="wikitable" style="width: 100%;"
|-
! Item (Español) !! Nombre ChestShop !! Item (Español) !! Nombre ChestShop
|-
| Piedra || <code>Stone</code> || Tierra || <code>Dirt</code>
|-
| Césped || <code>Grass Block</code> || Arena || <code>Sand</code>
|-
| Madera Roble || <code>Oak Log</code> || Tablas Roble || <code>Oak Planks</code>
|-
| Vidrio || <code>Glass</code> || Obsidiana || <code>Obsidian</code>
|-
|}

==== Minerales ====
{| class="wikitable" style="width: 100%;"
|-
! Item (Español) !! Nombre ChestShop
|-
| Diamante || <code>Diamond</code>
|-
| Esmeralda || <code>Emerald</code>
|-
| Lingote de Hierro || <code>Iron Ingot</code>
|-
| Lingote de Oro || <code>Gold Ingot</code>
|-
| Lingote de Netherite || <code>Netherite Ingot</code>
|-
| Carbón || <code>Coal</code>
|-
| Redstone || <code>Redstone</code>
|-
| Lapislázuli || <code>Lapis Lazuli</code>
|-
|}

==== Items de Granja ====
{| class="wikitable" style="width: 100%;"
|-
! Item (Español) !! Nombre ChestShop
|-
| Trigo || <code>Wheat</code>
|-
| Zanahoria || <code>Carrot</code>
|-
| Papa || <code>Potato</code>
|-
| Caña de Azúcar || <code>Sugar Cane</code>
|-
| Manzana || <code>Apple</code>
|-
| Carne Cocida || <code>Cooked Beef</code>
|-
| Huevo || <code>Egg</code>
|-
| Cuero || <code>Leather</code>
|-
|}

=== Items Encantados ===

'''No puedes vender items encantados directamente con ChestShop.''' 

Alternativas:
* Vende items sin encantar
* Ofrece servicio de encantamiento (tú encantas manualmente)
* Usa shulker boxes con items encantados dentro

=== Shulker Boxes con Items ===

Puedes vender '''shulker boxes llenas''' de items:

# Llena un shulker box con items
# Pon los shulkers en el cofre
# Cartel: <code>Shulker Box</code>

El comprador recibe el shulker con todo su contenido.

<div style="background: #e8f5e9; padding: 15px; border-left: 4px solid #4caf50; margin: 20px 0;">
'''💡 Negocio Avanzado:''' Vende "kits de inicio" en shulkers (espada, pico, comida, antorchas) a precio premium.
</div>

----

== 💡 Consejos de Negocio ==

=== Encontrar Buenos Precios ===

# '''Investiga la competencia''' - Visita otras tiendas
# '''Usa /balancetop''' - Ve quiénes son los más ricos (probablemente comerciantes exitosos)
# '''Pregunta en el chat''' - "¿Cuánto pagarían por 64 diamantes?"
# '''Precios del servidor''' - Usa <code>/worth</code> como referencia base

=== Estrategia de Precios ===

{| class="wikitable" style="width: 100%;"
|-
! Estrategia !! Cuándo Usar !! Ejemplo
|-
| '''Precio Bajo''' || Items comunes, alta competencia || Vender tierra a $1 en lugar de $2
|-
| '''Precio Medio''' || Items moderados, balanceado || Hierro a precio de mercado
|-
| '''Precio Premium''' || Items raros, poca competencia || Netherite a $500 c/u
|-
| '''Compra/Venta Mixta''' || Actuar como intermediario || Comprar diamantes $80, vender $120
|-
|}

=== Items Más Rentables ===

'''Alto Volumen (Venta Rápida):'''
* Comida (carne cocida, pan)
* Bloques de construcción (piedra, madera)
* Redstone/Hierro (farms automáticas)

'''Alto Margen (Venta Lenta):'''
* Diamantes/Netherite
* Elytras
* Bloques raros (esponjas, bloques de slime)

'''Servicios (Sin stock):'''
* "Compro todo tipo de minerales" (tienda de compra)
* "Banco" (guardas items de otros jugadores por tarifa)

=== Ubicación de Tiendas ===

'''Mejores lugares:'''
* ✅ Cerca del spawn (más tráfico)
* ✅ En zonas de comercio comunitarias
* ✅ Anunciadas en {{DiscordLink}} canal de tiendas

'''Evitar:'''
* ❌ Lejos de todo sin warps
* ❌ Escondidas sin señalización
* ❌ En medio del wilderness sin protección

----

== 📊 Ejemplos de Tiendas Exitosas ==

=== Tienda de Materiales Básicos ===

<pre>
Cofre 1: Piedra
64
S 10
Stone

Cofre 2: Madera
64
S 15
Oak Log

Cofre 3: Vidrio
64
S 25
Glass
</pre>

'''Ventaja:''' Items que siempre se necesitan, alta rotación.

=== Tienda de Granja (Compra/Venta) ===

<pre>
TuNombre
64
B 30 : S 50
Carrot

TuNombre
64
B 25 : S 45
Potato

TuNombre
64
B 40 : S 60
Wheat
</pre>

'''Estrategia:''' Compras barato de granjeros, vendes caro a constructores.

=== Tienda Premium (Solo Venta) ===

<pre>
TuNombre
1
S 150
Diamond

TuNombre
1
S 500
Netherite Ingot

TuNombre
1
S 300
Elytra
</pre>

'''Ventaja:''' Alto margen, poco stock necesario.

----

== ❓ Problemas Comunes ==

<div class="mw-collapsible mw-collapsed" style="background: #f5f5f5; padding: 15px; margin: 10px 0; border-radius: 5px;">
<div class="mw-collapsible-toggle" style="float: right;">[Expandir]</div>
=== El cartel dice "Nombre de item inválido" ===
<div class="mw-collapsible-content">
El nombre del item está mal escrito.

'''Soluciones:'''
# Verifica el nombre exacto en inglés (sensible a mayúsculas)
# Pon el item en tu mano y usa <code>/iteminfo</code> para ver el nombre correcto
# Ejemplos comunes:
#* <code>Iron Ingot</code> (no "Iron")
#* <code>Oak Log</code> (no "Wood")
#* <code>Cooked Beef</code> (no "Steak")
</div>
</div>

<div class="mw-collapsible mw-collapsed" style="background: #f5f5f5; padding: 15px; margin: 10px 0; border-radius: 5px;">
<div class="mw-collapsible-toggle" style="float: right;">[Expandir]</div>
=== "No tienes suficiente dinero" (tienda de compra) ===
<div class="mw-collapsible-content">
Tu balance está vacío.

'''Solución:'''
# Verifica tu dinero: <code>/bal</code>
# Añade dinero vendiendo items: <code>/sell all</code>
# O recibe dinero de otro jugador: <code>/pay TuNombre 1000</code>

La tienda usa el dinero de tu <code>/bal</code>, no del cofre.
</div>
</div>

<div class="mw-collapsible mw-collapsed" style="background: #f5f5f5; padding: 15px; margin: 10px 0; border-radius: 5px;">
<div class="mw-collapsible-toggle" style="float: right;">[Expandir]</div>
=== Los jugadores no pueden usar mi tienda ===
<div class="mw-collapsible-content">
Posible problema de permisos de claim.

'''Solución:'''
# Verifica que la tienda esté en tu claim
# Los jugadores '''SÍ pueden''' usar carteles en claims ajenos (es parte del sistema)
# Si usaste subdivisión, asegúrate de no haber bloqueado el acceso
# Pide a un jugador que intente y te diga el error exacto
</div>
</div>

<div class="mw-collapsible mw-collapsed" style="background: #f5f5f5; padding: 15px; margin: 10px 0; border-radius: 5px;">
<div class="mw-collapsible-toggle" style="float: right;">[Expandir]</div>
=== Alguien destruyó mi tienda ===
<div class="mw-collapsible-content">
Si tu tienda estaba '''dentro de un claim''', esto NO debería ser posible.

'''Verifica:'''
# ¿La tienda estaba en tu claim? (usa palo para verificar límites)
# ¿Le diste trust a alguien que abusó?

'''Si fue griefing fuera de claim:'''
# Reporta en {{DiscordLink}} con screenshots
# Admins usan CoreProtect para revertir y banear

'''Prevención:''' SIEMPRE crea tiendas dentro de claims protegidos.
</div>
</div>

<div class="mw-collapsible mw-collapsed" style="background: #f5f5f5; padding: 15px; margin: 10px 0; border-radius: 5px;">
<div class="mw-collapsible-toggle" style="float: right;">[Expandir]</div>
=== ¿Cómo sé si alguien compró de mi tienda? ===
<div class="mw-collapsible-content">
ChestShop envía notificaciones:

'''Si estás online:'''
* Recibes mensaje en chat: <code>[ChestShop] Pedro123 compró 64 Diamond por $6,400</code>

'''Si estás offline:'''
* Revisa tu balance: <code>/bal</code> (habrá aumentado)
* Revisa el cofre (stock habrá bajado)

'''Próximamente:''' Integración con Discord para notificaciones cuando estés offline.
</div>
</div>

<div class="mw-collapsible mw-collapsed" style="background: #f5f5f5; padding: 15px; margin: 10px 0; border-radius: 5px;">
<div class="mw-collapsible-toggle" style="float: right;">[Expandir]</div>
=== ¿Los jugadores Bedrock pueden usar tiendas? ===
<div class="mw-collapsible-content">
'''Sí, 100% funcional.'''

Los jugadores Bedrock pueden:
* ✅ Crear sus propias tiendas
* ✅ Comprar en tiendas de otros
* ✅ Vender en tiendas de otros
* ✅ Usar tiendas mixtas (B:S)

'''Nota:''' Su username tendrá punto al inicio (ej: <code>.NombreJugador</code>) en el cartel, esto es normal.
</div>
</div>

----

== 📢 Promocionar Tu Tienda ==

=== Discord ===

Anuncia en {{DiscordLink}} canal <code>#tiendas</code>:

<pre>
🏪 NUEVA TIENDA: Materiales de Construcción

📍 Ubicación: /warp comercio (plot 5)

💎 Vendemos:
- Piedra: 64 por $10
- Madera: 64 por $15
- Vidrio: 64 por $25

💰 Compramos:
- Hierro: 64 por $200
- Oro: 64 por $400
</pre>

=== In-Game ===

<pre>
# Mensaje en chat cada 30 min (no spam)
Visita mi tienda de diamantes en /home TuNombre tienda

# Crea un warp si tienes permisos VIP
/setwarp TiendaPedro
</pre>

=== Señalización ===

* Coloca carteles con flechas guiando a tu tienda
* Usa bloques de colores llamativos
* Construye un edificio atractivo/temático

----

== 💬 Soporte ==

¿Problemas con ChestShop?

* 🎮 '''In-game:''' Pregunta en el chat
* 💬 '''Discord:''' {{DiscordLink}}
* 📧 '''Email:''' nokrosis@comunidadsp.com

'''Reportar tienda problemática:'''
* Toma screenshot del cartel y coordenadas
* Reporta en Discord con detalles

<div style="text-align: center; padding: 20px; background: #f0f0f0; border-radius: 8px; margin: 30px 0;">
'''¿Listo para crear tu imperio comercial?'''

¡Construye tu primera tienda y empieza a ganar!

[[Página principal|← Volver al inicio]] | [[Comandos|Ver Comandos →]] | [[Protección de Terrenos|Proteger tu Tienda →]]
</div>

----

''Última actualización: Diciembre 2025''

[[Categoría:Economía]]
[[Categoría:ChestShop]]
[[Categoría:Tiendas]]
[[Categoría:Guías]]