🎨 Creación de Contenido

Guía técnica paso a paso para crear items, áreas/niveles, mobs y ofertas directamente desde Discord. Requiere permiso Manage Guild o rol de staff.

📦 Items: crear/editar

1) Crear base
!item-crear iron_sword
Base → Nombre: "Espada de Hierro", Descripción, Stackable: false,1
Tags → weapon, tier2

2) Props (JSON) comunes
{
  "tool": { "type": "sword", "tier": 2 },
  "damage": 15,
  "breakable": { "enabled": true, "maxDurability": 200 }
}

3) Receta (modal ⭐)
Habilitar: true
Produce: 1
Ingredientes: iron_ingot:3, wood_plank:1

4) Guardar → ✅ Item creado
Prueba: !craftear iron_sword

Usa !item-editar, !item-ver, !items-lista para gestionar.

🧭 Áreas y Niveles (MINE/LAGOON/FIGHT/FARM)

1) Crear área
!area-crear mine.iron_cavern
Config (JSON): {
  "cooldownSeconds": 60,
  "description": "Caverna rica en hierro",
  "icon": "⛏️"
}
Guardar → ✅ Área creada

2) Crear nivel 1
!area-nivel mine.iron_cavern 1
Requisitos (JSON): {
  "tool": { "required": true, "toolType": "pickaxe", "minTier": 2 }
}
Recompensas (JSON): {
  "draws": 2,
  "table": [
    { "type": "coins", "amount": 50, "weight": 10 },
    { "type": "item",  "itemKey": "iron_ore", "qty": 2, "weight": 8 }
  ]
}
Mobs (JSON, opcional): {
  "draws": 1,
  "table": [ { "mobKey": "cave_spider", "weight": 10 } ]
}
Guardar → ✅ Nivel guardado
Errores comunes
  • mobKey o itemKey inexistente → crea primero o corrige la key
  • Pesos mal balanceados → revisa weight (no negativos; no tienen que sumar 100)
  • Herramienta requerida mal configurada → revisa toolType y minTier

👹 Mobs (enemigos/NPCs)

1) Crear mob
!mob-crear goblin
Base → Nombre: Goblin, Categoría: enemies
Stats (JSON): { "attack": 10, "hp": 50, "defense": 3, "xpReward": 25 }
Drops (JSON): {
  "draws": 2,
  "table": [
    { "type": "coins", "amount": 20, "weight": 10 },
    { "type": "item",  "itemKey": "leather", "qty": 1, "weight": 5 }
  ]
}
Guardar → ✅ Mob creado

Revisa con !mobs-lista y !mob-eliminar <key> si necesitas limpiar datos de prueba.

🛒 Ofertas de Tienda

1) Crear oferta
!offer-crear
Base → itemKey: iron_sword, Habilitada: true
Precio (JSON): { "coins": 100 }
— o —
Precio (JSON): {
  "coins": 50,
  "items": [ { "itemKey": "iron_ore", "qty": 5 } ]
}
Límites → por usuario: 5, stock global: 100
Ventana → inicio/fin ISO (opcional)
Guardar → ✅ Oferta guardada
Errores comunes
  • itemKey no existe → crea el ítem primero
  • Formato de precio inválido → respeta estructura de coins e items
  • Ventana inválida → usa fechas ISO: YYYY-MM-DDTHH:MM:SSZ
Recomendaciones