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

157 lines
8.4 KiB
Plaintext
Raw Normal View History

<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>, <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">
<h3 class="text-lg font-semibold text-white">📦 Items: crear/editar</h3>
<div class="bg-black/30 p-3 rounded-lg text-sm">
<pre class="text-orange-200 whitespace-pre-wrap">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</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 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>
<div class="bg-black/30 p-3 rounded-lg text-sm">
<pre class="text-orange-200 whitespace-pre-wrap">1) Crear área
!area-crear mine.iron_cavern
Config (JSON): {
"cooldownSeconds": 60,
"description": "Caverna rica en hierro",
"icon": "⛏️",
"riskFactor": 2
}
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</pre>
</div>
<div class="bg-black/30 p-3 rounded-lg text-xs">
<div class="text-orange-200 font-semibold mb-1">Errores comunes</div>
<ul class="list-disc pl-5 space-y-1 text-orange-100">
<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>
</div>
<div class="grid gap-6 md:grid-cols-2 mt-6">
<div class="space-y-3 rounded-2xl border border-white/5 bg-black/20 p-5">
<h3 class="text-lg font-semibold text-white">👹 Mobs (enemigos/NPCs)</h3>
<div class="bg-black/30 p-3 rounded-lg text-sm">
<pre class="text-orange-200 whitespace-pre-wrap">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</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>
<div class="bg-black/30 p-3 rounded-lg text-sm">
<pre class="text-orange-200 whitespace-pre-wrap">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</pre>
</div>
<div class="bg-black/30 p-3 rounded-lg text-xs">
<div class="text-orange-200 font-semibold mb-1">Errores comunes</div>
<ul class="list-disc pl-5 space-y-1 text-orange-100">
<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>
</div>
<div class="mt-6 rounded-2xl border border-orange-500/30 bg-orange-500/10 p-5 text-sm text-orange-100">
<strong class="block text-base font-semibold text-orange-200 mb-2">Recomendaciones</strong>
<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 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>