feat: agregar comando de registro de muertes y penalizaciones; implementar ítem de purga de efectos y mejorar la documentación de creación de contenido

src/server/views/partials/sections/creacion-contenido.ejs

@@ -1,6 +1,6 @@
 <section id="creacion-contenido" class="rounded-3xl bg-gradient-to-br from-red-900/20 to-orange-900/20 backdrop-blur-xl border border-red-500/30 p-8 shadow-2xl">
   <h2 class="text-3xl sm:text-4xl font-bold mb-3 bg-clip-text text-transparent bg-gradient-to-r from-red-200 to-orange-200">🎨 Creación de Contenido</h2>
-  <p class="text-slate-100">Guía técnica paso a paso para crear <strong>items</strong>, <strong>áreas/niveles</strong>, <strong>mobs</strong> y <strong>ofertas</strong> directamente desde Discord. Requiere permiso <span class="font-mono">Manage Guild</span> o rol de staff.</p>
+  <p class="text-slate-100">Guía técnica paso a paso para crear <strong>items</strong>, <strong>áreas/niveles</strong>, <strong>mobs</strong>, <strong>ofertas</strong> y ahora <strong>componentes RPG avanzados</strong> (durabilidad por instancia, efectos de estado, penalizaciones de muerte, rachas, riskFactor de áreas). Requiere permiso <span class="font-mono">Manage Guild</span> o rol de staff.</p>
 
   <div class="grid gap-6 md:grid-cols-2">
     <div class="space-y-3 rounded-2xl border border-white/5 bg-black/20 p-5">
@@ -26,7 +26,15 @@ Ingredientes: iron_ingot:3, wood_plank:1
 4) Guardar → ✅ Item creado
 Prueba: !craftear iron_sword</pre>
       </div>
-      <p class="text-slate-300 text-sm">Usa <span class="font-mono">!item-editar</span>, <span class="font-mono">!item-ver</span>, <span class="font-mono">!items-lista</span> para gestionar.</p>
+      <p class="text-slate-300 text-sm">Usa <span class="font-mono">!item-editar</span>, <span class="font-mono">!item-ver</span>, <span class="font-mono">!items-lista</span>. Para herramientas NO apilables la durabilidad se gestiona por <em>instancias</em> dentro de <span class="font-mono">inventory.state.instances</span>.</p>
+      <div class="mt-3 bg-black/40 rounded-lg p-3 text-xs text-orange-100 space-y-2">
+        <div class="font-semibold">Novedades RPG (Items)</div>
+        <ul class="list-disc pl-5 space-y-1">
+          <li><strong>Durabilidad por instancia:</strong> si <span class="font-mono">stackable=false</span> y <span class="font-mono">breakable.enabled=true</span>, cada unidad es una instancia con su propia durabilidad.</li>
+          <li><strong>Mutaciones / Encantamientos:</strong> se reflejan sumando bonuses (damageBonus, defenseBonus, maxHpBonus).</li>
+          <li><strong>Ítem purga efectos:</strong> puedes crear tu propia poción local: <code>{ "usable": true, "purgeAllEffects": true }</code> y usarla con <span class="font-mono">!efectos purgar</span>.</li>
+        </ul>
+      </div>
     </div>
     <div class="space-y-3 rounded-2xl border border-white/5 bg-black/20 p-5">
       <h3 class="text-lg font-semibold text-white">🧭 Áreas y Niveles (MINE/LAGOON/FIGHT/FARM)</h3>
@@ -36,7 +44,8 @@ Prueba: !craftear iron_sword</pre>
 Config (JSON): {
   "cooldownSeconds": 60,
   "description": "Caverna rica en hierro",
-  "icon": "⛏️"
+  "icon": "⛏️",
+  "riskFactor": 2
 }
 Guardar → ✅ Área creada
 
@@ -64,6 +73,7 @@ Guardar → ✅ Nivel guardado</pre>
           <li><span class="font-mono">mobKey</span> o <span class="font-mono">itemKey</span> inexistente → crea primero o corrige la key</li>
           <li>Pesos mal balanceados → revisa <span class="font-mono">weight</span> (no negativos; no tienen que sumar 100)</li>
           <li>Herramienta requerida mal configurada → revisa <span class="font-mono">toolType</span> y <span class="font-mono">minTier</span></li>
+          <li><span class="font-mono">riskFactor</span> (0-3) afecta % de oro que pierdes al morir (escala hasta 25% total con nivel).</li>
         </ul>
       </div>
     </div>
@@ -87,6 +97,14 @@ Drops (JSON): {
 Guardar → ✅ Mob creado</pre>
       </div>
       <p class="text-slate-300 text-xs">Revisa con <span class="font-mono">!mobs-lista</span> y <span class="font-mono">!mob-eliminar &lt;key&gt;</span> si necesitas limpiar datos de prueba.</p>
+      <div class="mt-3 bg-black/40 rounded-lg p-3 text-xs text-orange-100 space-y-2">
+        <div class="font-semibold">Integración combate</div>
+        <ul class="list-disc pl-5 space-y-1">
+          <li>El daño del jugador usa arma + mutaciones + racha (1% cada 3 victorias, cap 30%).</li>
+          <li>Defensa reduce daño hasta 60% (5% por punto, cap).</li>
+          <li>Si daño efectivo = 0 → derrota automática (flag <span class="font-mono">autoDefeatNoWeapon</span>).</li>
+        </ul>
+      </div>
     </div>
     <div class="space-y-3 rounded-2xl border border-white/5 bg-black/20 p-5">
       <h3 class="text-lg font-semibold text-white">🛒 Ofertas de Tienda</h3>
@@ -110,6 +128,7 @@ Guardar → ✅ Oferta guardada</pre>
           <li><span class="font-mono">itemKey</span> no existe → crea el ítem primero</li>
           <li>Formato de precio inválido → respeta estructura de <span class="font-mono">coins</span> e <span class="font-mono">items</span></li>
           <li>Ventana inválida → usa fechas ISO: <span class="font-mono">YYYY-MM-DDTHH:MM:SSZ</span></li>
+          <li>Para vender una poción de purga local crea un ítem consumible y ofrece en la tienda.</li>
         </ul>
       </div>
     </div>
@@ -120,7 +139,18 @@ Guardar → ✅ Oferta guardada</pre>
     <ul class="list-disc pl-5 space-y-1">
       <li>Usa keys en minúsculas y sin espacios (únicas por servidor).</li>
       <li>Guarda plantillas de Props JSON para acelerar creación.</li>
-      <li>Prueba inmediatamente tras crear: <span class="font-mono">!craftear</span>, <span class="font-mono">!abrir</span>, <span class="font-mono">!equipar</span>.</li>
+      <li>Prueba tras crear: <span class="font-mono">!craftear</span>, <span class="font-mono">!abrir</span>, <span class="font-mono">!equipar</span>, <span class="font-mono">!efectos</span>, <span class="font-mono">!deathlog</span>.</li>
+      <li>Si ajustas valores de riesgo o nivel alto prueba la pérdida real (usa un alt) para validar balance.</li>
+      <li>Consulta auditoría de muertes: <span class="font-mono">!deathlog</span> para detectar abusos o mal balance.</li>
     </ul>
+    <div class="mt-4 bg-black/30 p-3 rounded-lg text-xs space-y-1">
+      <div class="font-semibold">Resumen rápido nuevas claves JSON</div>
+      <code class="block">area.config.riskFactor: 0-3 (aumenta % oro perdido)</code>
+      <code class="block">item.props.breakable.maxDurability / durabilityPerUse</code>
+      <code class="block">item.props.tool { type, tier }</code>
+      <code class="block">item.props.purgeAllEffects = true (ítem purga)</code>
+      <code class="block">status effects: almacenados en DB (PlayerStatusEffect)</code>
+      <code class="block">death penalty: porcentaje dinámico + fatiga escalada</code>
+    </div>
   </div>
 </section>

src/server/views/partials/sections/ejemplos-avanzados.ejs

@@ -51,5 +51,74 @@ Props (JSON): {"tool": {"type": "sword", "tier": 3}, "damage": 25}
 Props (JSON): {"damage": 45, "breakable": {"enabled": true, "maxDurability": 300}}
 Receta (modal): steel_sword_base:1, magic_dust:3, dragon_scale:1</pre>
     </div>
+
+    <div class="space-y-2 rounded-2xl border border-white/5 bg-slate-900/60 p-5">
+      <h3 class="text-lg font-semibold text-white">4) Área Avanzada con Riesgo y Mobs</h3>
+      <pre class="text-indigo-200 text-sm whitespace-pre-wrap bg-slate-900/40 p-3 rounded-lg"># Área con factor de riesgo (aumenta penalización oro al morir)
+!area-crear arena.blood_pit
+Config (JSON): {"cooldownSeconds": 90, "icon": "⚔️", "riskFactor": 3, "description": "La fosa sangrienta"}
+!area-nivel arena.blood_pit 1
+Requisitos (JSON): {"tool": {"required": true, "toolType": "sword", "minTier": 2}}
+Recompensas (JSON): {"draws": 2, "table": [
+  {"type": "coins", "amount": 120, "weight": 10},
+  {"type": "item",  "itemKey": "blood_shard", "qty": 1, "weight": 4}
+]}
+Mobs (JSON): {"draws": 2, "table": [
+  {"mobKey": "goblin", "weight": 8},
+  {"mobKey": "cave_spider", "weight": 5}
+]}</pre>
+    </div>
+
+    <div class="space-y-2 rounded-2xl border border-white/5 bg-slate-900/60 p-5">
+      <h3 class="text-lg font-semibold text-white">5) Ítem Poción de Purga Local</h3>
+      <pre class="text-indigo-200 text-sm whitespace-pre-wrap bg-slate-900/40 p-3 rounded-lg">!item-crear purge_potion
+Props (JSON): {"usable": true, "purgeAllEffects": true, "icon": "🧪"}
+# Se consume al usar: !efectos purgar
+# Para venderla: crear oferta o poner drop en cofre.</pre>
+    </div>
+
+    <div class="space-y-2 rounded-2xl border border-white/5 bg-slate-900/60 p-5">
+      <h3 class="text-lg font-semibold text-white">6) Introducción a Status Effects Manuales</h3>
+      <pre class="text-indigo-200 text-sm whitespace-pre-wrap bg-slate-900/40 p-3 rounded-lg"># (Opcional) Aplicar un efecto custom vía comando admin futuro
+# Ejemplo conceptual JSON (guardado server-side):
+{
+  "type": "BLESSING",
+  "magnitude": 0.10,   # +10% daño (interpretación futura)
+  "durationMs": 600000 # 10 min
+}
+# Los efectos actuales: FATIGUE (reduce daño y defensa)
+# Ver activos: !efectos</pre>
+    </div>
+
+    <div class="space-y-2 rounded-2xl border border-white/5 bg-slate-900/60 p-5">
+      <h3 class="text-lg font-semibold text-white">7) Auditoría de Muertes</h3>
+      <pre class="text-indigo-200 text-sm whitespace-pre-wrap bg-slate-900/40 p-3 rounded-lg"># Ver últimas muertes y penalizaciones
+!deathlog           # por defecto 10
+!deathlog 20        # máximo 20
+
+# Interpreta columnas
+# HH:MM:SS | areaKey Lnivel | -oro | % | Fatiga | sin arma?
+
+# Ajusta balance si ves pérdidas demasiado altas en cierto nivel/riskFactor.</pre>
+    </div>
+
+    <div class="space-y-2 rounded-2xl border border-white/5 bg-slate-900/60 p-5">
+      <h3 class="text-lg font-semibold text-white">8) Cadena Completa: Creación → Riesgo → Muerte</h3>
+      <pre class="text-indigo-200 text-sm whitespace-pre-wrap bg-slate-900/40 p-3 rounded-lg"># 1. Crear arma y área con riesgo
+!item-crear bone_sword
+Props (JSON): {"tool": {"type": "sword", "tier": 1}, "damage": 9, "breakable": {"enabled": true, "maxDurability": 80}}
+!area-crear arena.bone_trial
+Config (JSON): {"cooldownSeconds": 45, "riskFactor": 1, "icon": "🗡️"}
+!area-nivel arena.bone_trial 1
+Requisitos (JSON): {"tool": {"required": true, "toolType": "sword", "minTier": 1}}
+Mobs (JSON): {"draws":1, "table":[{"mobKey":"goblin","weight":10}]}
+
+# 2. Pelear varias veces para subir racha y ver bonus daño (!player)
+# 3. Morir intencionalmente con monedas => verifica !deathlog
+# 4. Aplicar purga de efectos si acumulaste FATIGUE
+!efectos purgar
+
+# Ajusta riskFactor o nivel si la penalización % es muy baja/alta.</pre>
+    </div>
   </div>
 </section>