1300 lines
27 KiB
Markdown
1300 lines
27 KiB
Markdown
# 🎮 Guía de Usuario Completa - Amayo Bot
|
|
|
|
> **Última actualización: Enero 2025 • Versión 0.11.20**
|
|
|
|
Esta es la guía completa de Amayo Bot para usuarios finales de Discord. Aprende a usar todos los comandos, jugar minijuegos, gestionar tu economía y, si eres administrador, cómo crear contenido personalizado para tu servidor.
|
|
|
|
---
|
|
|
|
## 📋 Tabla de Contenidos
|
|
|
|
### Para Todos los Usuarios
|
|
1. [Primeros Pasos](#primeros-pasos)
|
|
2. [Comandos Básicos](#comandos-basicos)
|
|
3. [Sistema de Juego](#sistema-juego)
|
|
4. [Minijuegos](#minijuegos)
|
|
5. [Inventario y Equipo](#inventario)
|
|
6. [Economía](#economia)
|
|
7. [Tienda](#tienda)
|
|
8. [Crafteo](#crafteo)
|
|
9. [Logros](#logros)
|
|
10. [Misiones](#misiones)
|
|
11. [Racha Diaria](#racha)
|
|
12. [Consumibles](#consumibles)
|
|
13. [Cofres](#cofres)
|
|
14. [Encantamientos](#encantamientos)
|
|
15. [Fundición](#fundicion)
|
|
16. [IA Conversacional](#ia)
|
|
17. [Recordatorios](#recordatorios)
|
|
18. [Sistema de Alianzas](#alianzas)
|
|
|
|
### Para Administradores
|
|
19. [Creación de Contenido](#creacion-contenido)
|
|
20. [Gestión de Items](#gestion-items)
|
|
21. [Gestión de Mobs](#gestion-mobs)
|
|
22. [Gestión de Áreas](#gestion-areas)
|
|
23. [Gestión de Ofertas](#gestion-ofertas)
|
|
24. [Configuración del Servidor](#configuracion)
|
|
|
|
### Recursos
|
|
25. [Tips y Trucos](#tips)
|
|
26. [Preguntas Frecuentes](#faq)
|
|
|
|
---
|
|
|
|
## 🚀 Primeros Pasos {#primeros-pasos}
|
|
|
|
### ¿Qué es Amayo Bot?
|
|
|
|
Amayo Bot es un bot de Discord completo que añade un sistema de juego RPG a tu servidor con:
|
|
- **Minijuegos**: Mina, pesca, pelea y cultiva
|
|
- **Economía**: Sistema de monedas, tienda e inventario
|
|
- **Progresión**: Logros, misiones y rachas diarias
|
|
- **Personalización**: Equipo, encantamientos y crafteo
|
|
- **IA**: Chat con Gemini AI
|
|
- **Alianzas**: Sistema de puntos para servidores
|
|
|
|
### Prefix del Bot
|
|
|
|
El prefix por defecto es `!` pero los administradores pueden cambiarlo.
|
|
|
|
**Ejemplos:**
|
|
- `!ayuda` - Ver comandos disponibles
|
|
- `!player` - Ver tu perfil
|
|
- `!mina` - Jugar al minijuego de minería
|
|
|
|
---
|
|
|
|
## ⚡ Comandos Básicos {#comandos-basicos}
|
|
|
|
### Información General
|
|
|
|
- `!ayuda` o `!help` - Lista todos los comandos
|
|
- `!ayuda <comando>` - Ayuda sobre un comando específico
|
|
- `!ping` - Ver la latencia del bot
|
|
- `!player [@usuario]` - Ver perfil de jugador
|
|
|
|
### Ver tu Progreso
|
|
|
|
- `!inventario` o `!inv` - Ver tu inventario
|
|
- `!stats` - Ver tus estadísticas detalladas
|
|
- `!logros` - Ver tus logros
|
|
- `!misiones` - Ver misiones disponibles
|
|
- `!cooldowns` - Ver tus cooldowns activos
|
|
|
|
---
|
|
|
|
## 🎮 Sistema de Juego {#sistema-juego}
|
|
|
|
### Estadísticas de Combate
|
|
|
|
Tu personaje tiene las siguientes estadísticas:
|
|
|
|
- **HP (Vida)**: Puntos de vida actuales y máximos
|
|
- **ATK (Ataque)**: Daño que infliges
|
|
- **DEF (Defensa)**: Reduce el daño recibido
|
|
|
|
### Equipo
|
|
|
|
Puedes equipar:
|
|
- **Arma (weapon)**: Aumenta tu ataque
|
|
- **Armadura (armor)**: Aumenta tu defensa
|
|
- **Capa (cape)**: Bonos especiales (HP, stats adicionales)
|
|
|
|
**Comando:**
|
|
```
|
|
!equipar <slot> <itemKey>
|
|
```
|
|
|
|
**Ejemplos:**
|
|
- `!equipar weapon iron_sword`
|
|
- `!equipar armor leather_armor`
|
|
- `!equipar cape red_cape`
|
|
|
|
---
|
|
|
|
## 🎯 Minijuegos {#minijuegos}
|
|
|
|
Los minijuegos son la forma principal de obtener recursos y monedas.
|
|
|
|
### ⛏️ Minar
|
|
|
|
Extrae minerales valiosos de la mina.
|
|
|
|
**Comando:** `!mina [nivel] [herramienta] [area:clave]`
|
|
|
|
**Ejemplos:**
|
|
- `!mina` - Mina en el nivel más alto desbloqueado
|
|
- `!mina 2` - Mina en el nivel 2
|
|
- `!mina 1 iron_pickaxe` - Usa un pico específico
|
|
|
|
**Herramienta requerida:** Pico (pickaxe)
|
|
|
|
### 🎣 Pescar
|
|
|
|
Captura peces y tesoros en la laguna.
|
|
|
|
**Comando:** `!pescar [nivel] [herramienta] [area:clave]`
|
|
|
|
**Ejemplos:**
|
|
- `!pescar` - Pesca automática
|
|
- `!pescar 3` - Pesca en nivel 3
|
|
|
|
**Herramienta requerida:** Caña de pescar (rod)
|
|
|
|
### ⚔️ Pelear
|
|
|
|
Enfrenta enemigos en la arena.
|
|
|
|
**Comando:** `!pelear [nivel] [arma] [area:clave]`
|
|
|
|
**Ejemplos:**
|
|
- `!pelear` - Combate automático
|
|
- `!pelear 1 iron_sword` - Usa espada específica
|
|
|
|
**Herramienta requerida:** Arma (sword, bow, halberd)
|
|
|
|
### 🌾 Plantar
|
|
|
|
Cultiva plantas y cosecha alimentos.
|
|
|
|
**Comando:** `!plantar [nivel] [herramienta]`
|
|
|
|
**Herramienta requerida:** Azada (hoe)
|
|
|
|
### Cooldowns
|
|
|
|
Cada minijuego tiene un tiempo de espera entre usos. Usa `!cooldowns` para ver cuánto tiempo falta.
|
|
|
|
---
|
|
|
|
## 💡 Conceptos Básicos {#conceptos-básicos}
|
|
|
|
### ¿Qué es una "key"?
|
|
Una **key** es un identificador único para cada elemento (item, mob, área, etc.). Es como el "nombre interno" del elemento.
|
|
|
|
**Ejemplos de keys:**
|
|
- `iron_sword` - Espada de hierro
|
|
- `health_potion` - Poción de vida
|
|
- `cave_spider` - Enemigo araña
|
|
|
|
**⚠️ Importante:** Las keys no pueden repetirse y deben ser únicas.
|
|
|
|
### Sistema de Pesos (Weights)
|
|
Cuando configuras recompensas o enemigos que aparecen, usas un sistema de **pesos** para decidir qué tan común es cada cosa.
|
|
|
|
**Ejemplo:**
|
|
```json
|
|
{ "itemKey": "iron_ore", "weight": 10 } ← Aparece 10 veces de cada 13
|
|
{ "itemKey": "gold_ore", "weight": 3 } ← Aparece 3 veces de cada 13
|
|
```
|
|
|
|
Cuanto **mayor** sea el número, **más probable** es que aparezca.
|
|
|
|
---
|
|
|
|
## 🎒 Creando Items {#creando-items}
|
|
|
|
### Paso 1: Iniciar el Editor
|
|
Escribe en Discord:
|
|
```
|
|
!item-crear <key>
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!item-crear iron_sword
|
|
```
|
|
|
|
### Paso 2: Configurar la Base
|
|
Haz clic en el botón **"Base"** y llena los campos:
|
|
|
|
| Campo | Descripción | Ejemplo |
|
|
|-------|-------------|---------|
|
|
| **Nombre** | Nombre visible del item | `Espada de Hierro` |
|
|
| **Descripción** | Descripción del item | `Una espada forjada con hierro resistente` |
|
|
| **Categoría** | Tipo de item | `weapons` |
|
|
| **Icon URL** | URL de una imagen (opcional) | `https://...` |
|
|
| **Stackable y Máx** | Si se apila y máximo por inventario | `true,10` o `false,1` |
|
|
|
|
#### ¿Qué significa "Stackable"?
|
|
- **`true,10`** = Se pueden apilar hasta 10 unidades del mismo item
|
|
- **`false,1`** = Solo puedes tener 1 unidad (común para armas/herramientas)
|
|
- **`true,`** (dejar vacío el número) = Apilable sin límite
|
|
|
|
### Paso 3: Agregar Tags (Opcional)
|
|
Los tags te ayudan a organizar tus items. Haz clic en **"Tags"** y escribe:
|
|
```
|
|
weapon, rare, crafteable
|
|
```
|
|
|
|
### Paso 4: Configurar Propiedades Avanzadas (Props)
|
|
Aquí defines qué hace especial a tu item. Haz clic en **"Props (JSON)"**.
|
|
|
|
#### 🛠️ **Props para Herramientas**
|
|
|
|
Usa esto si tu item es una herramienta (pico, caña, espada, etc.):
|
|
|
|
```json
|
|
{
|
|
"tool": {
|
|
"type": "pickaxe",
|
|
"tier": 2
|
|
},
|
|
"breakable": {
|
|
"enabled": true,
|
|
"maxDurability": 150,
|
|
"durabilityPerUse": 1
|
|
}
|
|
}
|
|
```
|
|
|
|
**Tipos de herramientas disponibles:**
|
|
- `pickaxe` (pico para minar)
|
|
- `rod` (caña para pescar)
|
|
- `sword` (espada para pelear)
|
|
- `bow` (arco)
|
|
- `halberd` (alabarda)
|
|
- `net` (red)
|
|
|
|
**Durabilidad:**
|
|
- `maxDurability`: Cuántos usos tiene antes de romperse
|
|
- `durabilityPerUse`: Cuánta durabilidad pierde por uso (normalmente 1)
|
|
|
|
#### ⚔️ **Props para Armas/Armaduras**
|
|
|
|
```json
|
|
{
|
|
"damage": 15,
|
|
"defense": 0
|
|
}
|
|
```
|
|
|
|
- `damage`: Daño que hace el arma
|
|
- `defense`: Defensa que da la armadura
|
|
- `maxHpBonus`: HP extra que otorga (para capas)
|
|
|
|
#### 🍖 **Props para Comida/Pociones**
|
|
|
|
```json
|
|
{
|
|
"food": {
|
|
"healHp": 50,
|
|
"cooldownSeconds": 30
|
|
}
|
|
}
|
|
```
|
|
|
|
- `healHp`: Cuánta vida cura
|
|
- `healPercent`: Porcentaje de vida que cura (opcional)
|
|
- `cooldownSeconds`: Segundos antes de poder usar otra vez
|
|
|
|
#### 📦 **Props para Cofres**
|
|
|
|
Los cofres pueden dar monedas, items o roles cuando se abren:
|
|
|
|
```json
|
|
{
|
|
"chest": {
|
|
"enabled": true,
|
|
"rewards": [
|
|
{ "type": "coins", "amount": 100 },
|
|
{ "type": "item", "itemKey": "iron_ore", "qty": 5 },
|
|
{ "type": "role", "roleId": "123456789012345678" }
|
|
],
|
|
"consumeOnOpen": true
|
|
}
|
|
}
|
|
```
|
|
|
|
- `consumeOnOpen`: Si es `true`, el cofre se consume al abrirse
|
|
|
|
### Paso 5: Guardar
|
|
Haz clic en **"Guardar"** y ¡listo! Tu item ha sido creado.
|
|
|
|
---
|
|
|
|
## 🔍 Gestionando Items {#gestionando-items}
|
|
|
|
### Ver Lista de Items
|
|
Para ver todos los items creados en tu servidor:
|
|
```
|
|
!items-lista [página]
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!items-lista 1
|
|
```
|
|
|
|
Esto mostrará una lista interactiva con botones para:
|
|
- Ver detalles completos de cada item
|
|
- Navegar entre páginas
|
|
- Ver información de categorías y props
|
|
|
|
### Ver Detalles de un Item
|
|
Para ver información detallada de un item específico:
|
|
```
|
|
!item-ver <key>
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!item-ver iron_sword
|
|
```
|
|
|
|
Esto mostrará:
|
|
- Nombre y descripción
|
|
- Categoría y tags
|
|
- Propiedades (damage, defense, tool, etc.)
|
|
- Configuración de stackable
|
|
- Si es breakable y su durabilidad
|
|
|
|
### Editar un Item
|
|
Para editar un item existente:
|
|
```
|
|
!item-editar <key>
|
|
```
|
|
|
|
Funciona igual que el comando de crear, pero con los valores actuales pre-cargados.
|
|
|
|
### Eliminar un Item
|
|
Para eliminar un item permanentemente:
|
|
```
|
|
!item-eliminar <key>
|
|
```
|
|
|
|
**⚠️ Advertencia:** Esta acción es permanente y no se puede deshacer.
|
|
|
|
---
|
|
|
|
## 👹 Creando Enemigos (Mobs) {#creando-enemigos}
|
|
|
|
### Paso 1: Iniciar el Editor
|
|
```
|
|
!mob-crear <key>
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!mob-crear goblin
|
|
```
|
|
|
|
### Paso 2: Configurar Base
|
|
Haz clic en **"Base"**:
|
|
- **Nombre:** `Goblin`
|
|
- **Categoría:** `enemies` (opcional)
|
|
|
|
### Paso 3: Configurar Stats
|
|
Haz clic en **"Stats (JSON)"**:
|
|
|
|
```json
|
|
{
|
|
"attack": 10,
|
|
"hp": 50,
|
|
"defense": 3,
|
|
"xpReward": 25
|
|
}
|
|
```
|
|
|
|
- `attack`: Daño que hace el enemigo
|
|
- `hp`: Vida del enemigo
|
|
- `defense`: Defensa del enemigo
|
|
- `xpReward`: Experiencia que da al derrotarlo
|
|
|
|
### Paso 4: Configurar Drops (Recompensas)
|
|
Haz clic en **"Drops (JSON)"**:
|
|
|
|
```json
|
|
{
|
|
"draws": 2,
|
|
"table": [
|
|
{ "type": "coins", "amount": 20, "weight": 10 },
|
|
{ "type": "item", "itemKey": "leather", "qty": 1, "weight": 5 },
|
|
{ "type": "item", "itemKey": "goblin_tooth", "qty": 1, "weight": 2 }
|
|
]
|
|
}
|
|
```
|
|
|
|
- `draws`: Cuántos premios saca de la tabla
|
|
- `table`: Lista de posibles premios con su peso (probabilidad)
|
|
|
|
**En este ejemplo:**
|
|
- Hace 2 extracciones
|
|
- Más probable: 20 monedas (peso 10)
|
|
- Medianamente probable: 1 cuero (peso 5)
|
|
- Poco probable: 1 diente de goblin (peso 2)
|
|
|
|
### Paso 5: Guardar
|
|
Haz clic en **"Guardar"**.
|
|
|
|
---
|
|
|
|
## 🔍 Gestionando Enemigos {#gestionando-enemigos}
|
|
|
|
### Ver Lista de Mobs
|
|
Para ver todos los enemigos creados en tu servidor:
|
|
```
|
|
!mobs-lista [página]
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!mobs-lista 1
|
|
```
|
|
|
|
Esto mostrará una lista interactiva con:
|
|
- Nombre y categoría de cada mob
|
|
- Stats básicos (HP, ATK, DEF, XP)
|
|
- Botones para ver más detalles
|
|
|
|
### Eliminar un Mob
|
|
Para eliminar un enemigo permanentemente:
|
|
```
|
|
!mob-eliminar <key>
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!mob-eliminar goblin
|
|
```
|
|
|
|
**⚠️ Advertencia:** Esta acción es permanente. Si el mob está siendo usado en áreas, puede causar errores.
|
|
|
|
---
|
|
|
|
## 🗺️ Configurando Áreas de Juego {#configurando-áreas}
|
|
|
|
Las áreas son lugares donde los jugadores pueden realizar actividades como minar, pescar o pelear.
|
|
|
|
### Paso 1: Crear el Área
|
|
```
|
|
!area-crear <key>
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!area-crear mine.iron_cavern
|
|
```
|
|
|
|
### Paso 2: Configurar Base
|
|
Haz clic en **"Base"**:
|
|
- **Nombre:** `Caverna de Hierro`
|
|
- **Tipo:** Elige uno:
|
|
- `MINE` (minar)
|
|
- `LAGOON` (pescar)
|
|
- `FIGHT` (pelear)
|
|
- `FARM` (plantar)
|
|
|
|
### Paso 3: Configurar Config
|
|
Haz clic en **"Config (JSON)"**:
|
|
|
|
```json
|
|
{
|
|
"cooldownSeconds": 60,
|
|
"description": "Una profunda caverna llena de minerales de hierro",
|
|
"icon": "⛏️"
|
|
}
|
|
```
|
|
|
|
- `cooldownSeconds`: Segundos que deben esperar entre usos
|
|
|
|
### Paso 4: Guardar
|
|
Haz clic en **"Guardar"**.
|
|
|
|
---
|
|
|
|
## 🔍 Gestionando Áreas {#gestionando-áreas}
|
|
|
|
### Ver Lista de Áreas
|
|
Para ver todas las áreas configuradas en tu servidor:
|
|
```
|
|
!areas-lista [página]
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!areas-lista 1
|
|
```
|
|
|
|
Esto mostrará:
|
|
- Nombre y tipo de cada área (MINE, LAGOON, FIGHT, FARM)
|
|
- Cooldown configurado
|
|
- Si es global o del servidor
|
|
- Botones para ver detalles de niveles
|
|
|
|
### Eliminar un Área
|
|
Para eliminar un área permanentemente:
|
|
```
|
|
!area-eliminar <key>
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!area-eliminar mine.iron_cavern
|
|
```
|
|
|
|
**⚠️ Advertencia:**
|
|
- Esta acción eliminará el área Y todos sus niveles
|
|
- Se perderá todo el progreso de los jugadores en esa área
|
|
- Esta acción no se puede deshacer
|
|
|
|
---
|
|
|
|
## 📊 Configurando Niveles de Área {#configurando-niveles}
|
|
|
|
Los niveles son las "dificultades" de cada área. Cada nivel puede tener diferentes requisitos, recompensas y enemigos.
|
|
|
|
### Paso 1: Crear el Nivel
|
|
```
|
|
!area-nivel <key-del-área> <número-de-nivel>
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!area-nivel mine.iron_cavern 1
|
|
```
|
|
|
|
### Paso 2: Configurar Requisitos
|
|
Haz clic en **"Requisitos"**:
|
|
|
|
```json
|
|
{
|
|
"tool": {
|
|
"required": true,
|
|
"toolType": "pickaxe",
|
|
"minTier": 2
|
|
}
|
|
}
|
|
```
|
|
|
|
**Significado:**
|
|
- Es **obligatorio** tener un pico (`required: true`)
|
|
- Debe ser un pico de nivel 2 o superior (`minTier: 2`)
|
|
|
|
**Si no quieres requisitos:**
|
|
```json
|
|
{}
|
|
```
|
|
|
|
### Paso 3: Configurar Recompensas
|
|
Haz clic en **"Recompensas"**:
|
|
|
|
```json
|
|
{
|
|
"draws": 3,
|
|
"table": [
|
|
{ "type": "coins", "amount": 50, "weight": 10 },
|
|
{ "type": "item", "itemKey": "iron_ore", "qty": 2, "weight": 8 },
|
|
{ "type": "item", "itemKey": "gold_ore", "qty": 1, "weight": 2 }
|
|
]
|
|
}
|
|
```
|
|
|
|
**En este ejemplo:**
|
|
- Hace 3 extracciones de la tabla
|
|
- Más probable: 50 monedas
|
|
- Probable: 2 minerales de hierro
|
|
- Poco probable: 1 mineral de oro
|
|
|
|
### Paso 4: Configurar Mobs (Enemigos que Aparecen)
|
|
Haz clic en **"Mobs"**:
|
|
|
|
```json
|
|
{
|
|
"draws": 1,
|
|
"table": [
|
|
{ "mobKey": "cave_spider", "weight": 10 },
|
|
{ "mobKey": "bat", "weight": 5 },
|
|
{ "mobKey": "cave_troll", "weight": 1 }
|
|
]
|
|
}
|
|
```
|
|
|
|
- `draws`: Cuántos enemigos pueden aparecer (en este caso, 1)
|
|
- Más probable: araña de cueva
|
|
- Menos probable: murciélago
|
|
- Muy poco probable: troll de cueva
|
|
|
|
**Si no quieres enemigos:**
|
|
```json
|
|
{
|
|
"draws": 0,
|
|
"table": []
|
|
}
|
|
```
|
|
|
|
### Paso 5: Configurar Ventana de Disponibilidad (Opcional)
|
|
Si quieres que el nivel solo esté disponible en ciertas fechas, haz clic en **"Ventana"**:
|
|
|
|
- **Desde:** `2025-12-01T00:00:00Z` (formato ISO)
|
|
- **Hasta:** `2025-12-31T23:59:59Z`
|
|
|
|
**Deja en blanco si quieres que esté siempre disponible.**
|
|
|
|
### Paso 6: Guardar
|
|
Haz clic en **"Guardar"**.
|
|
|
|
---
|
|
|
|
## 🏪 Creando Ofertas de Tienda {#creando-ofertas}
|
|
|
|
Las ofertas permiten vender items a los jugadores.
|
|
|
|
### Paso 1: Crear la Oferta
|
|
```
|
|
!offer-crear
|
|
```
|
|
|
|
### Paso 2: Configurar Base
|
|
Haz clic en **"Base"**:
|
|
- **Item Key:** `iron_sword` (el item que quieres vender)
|
|
- **Habilitada?:** `true` (o `false` para deshabilitarla)
|
|
|
|
### Paso 3: Configurar Precio
|
|
Haz clic en **"Precio (JSON)"**:
|
|
|
|
#### Precio solo en monedas:
|
|
```json
|
|
{
|
|
"coins": 100
|
|
}
|
|
```
|
|
|
|
#### Precio en monedas e items:
|
|
```json
|
|
{
|
|
"coins": 50,
|
|
"items": [
|
|
{ "itemKey": "iron_ore", "qty": 5 },
|
|
{ "itemKey": "wood", "qty": 10 }
|
|
]
|
|
}
|
|
```
|
|
|
|
**Significado:** Cuesta 50 monedas + 5 minerales de hierro + 10 maderas.
|
|
|
|
### Paso 4: Configurar Límites (Opcional)
|
|
Haz clic en **"Límites"**:
|
|
|
|
- **Límite por usuario:** `5` (cada jugador puede comprar máximo 5)
|
|
- **Stock global:** `100` (solo hay 100 unidades disponibles en total)
|
|
|
|
**Deja en blanco para ilimitado.**
|
|
|
|
### Paso 5: Configurar Ventana (Opcional)
|
|
Si es una oferta temporal (como evento), haz clic en **"Ventana"**:
|
|
|
|
- **Inicio:** `2025-12-20T00:00:00Z`
|
|
- **Fin:** `2025-12-25T23:59:59Z`
|
|
|
|
### Paso 6: Guardar
|
|
Haz clic en **"Guardar"**.
|
|
|
|
---
|
|
|
|
## 📚 Ejemplos Prácticos {#ejemplos-prácticos}
|
|
|
|
### Ejemplo 1: Sistema de Minería Completo
|
|
|
|
#### 1. Crear el Pico de Madera
|
|
```
|
|
!item-crear wooden_pickaxe
|
|
```
|
|
|
|
**Base:**
|
|
- Nombre: `Pico de Madera`
|
|
- Descripción: `Un pico básico para empezar a minar`
|
|
- Stackable: `false,1`
|
|
|
|
**Props:**
|
|
```json
|
|
{
|
|
"tool": { "type": "pickaxe", "tier": 1 },
|
|
"breakable": { "enabled": true, "maxDurability": 50, "durabilityPerUse": 1 }
|
|
}
|
|
```
|
|
|
|
#### 2. Crear el Mineral de Cobre
|
|
```
|
|
!item-crear copper_ore
|
|
```
|
|
|
|
**Base:**
|
|
- Nombre: `Mineral de Cobre`
|
|
- Descripción: `Un mineral común encontrado en las minas`
|
|
- Stackable: `true,999`
|
|
|
|
**Props:**
|
|
```json
|
|
{
|
|
"craftingOnly": false
|
|
}
|
|
```
|
|
|
|
#### 3. Crear el Área de Mina
|
|
```
|
|
!area-crear mine.starter
|
|
```
|
|
|
|
**Base:**
|
|
- Nombre: `Mina Inicial`
|
|
- Tipo: `MINE`
|
|
|
|
**Config:**
|
|
```json
|
|
{
|
|
"cooldownSeconds": 30,
|
|
"icon": "⛏️"
|
|
}
|
|
```
|
|
|
|
#### 4. Crear Nivel 1 de la Mina
|
|
```
|
|
!area-nivel mine.starter 1
|
|
```
|
|
|
|
**Requisitos:**
|
|
```json
|
|
{
|
|
"tool": { "required": true, "toolType": "pickaxe", "minTier": 1 }
|
|
}
|
|
```
|
|
|
|
**Recompensas:**
|
|
```json
|
|
{
|
|
"draws": 2,
|
|
"table": [
|
|
{ "type": "coins", "amount": 10, "weight": 10 },
|
|
{ "type": "item", "itemKey": "copper_ore", "qty": 1, "weight": 8 }
|
|
]
|
|
}
|
|
```
|
|
|
|
**Mobs:**
|
|
```json
|
|
{
|
|
"draws": 0,
|
|
"table": []
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
### Ejemplo 2: Cofre de Recompensa Diaria
|
|
|
|
```
|
|
!item-crear daily_chest
|
|
```
|
|
|
|
**Base:**
|
|
- Nombre: `Cofre Diario`
|
|
- Descripción: `Un cofre que contiene recompensas aleatorias`
|
|
- Stackable: `true,10`
|
|
|
|
**Props:**
|
|
```json
|
|
{
|
|
"chest": {
|
|
"enabled": true,
|
|
"rewards": [
|
|
{ "type": "coins", "amount": 500 },
|
|
{ "type": "item", "itemKey": "health_potion", "qty": 3 }
|
|
],
|
|
"consumeOnOpen": true
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
### Ejemplo 3: Espada Legendaria
|
|
|
|
```
|
|
!item-crear legendary_sword
|
|
```
|
|
|
|
**Base:**
|
|
- Nombre: `⚔️ Espada Legendaria de los Dragones`
|
|
- Descripción: `Una espada forjada con escamas de dragón. Aumenta tu poder de ataque en 50 puntos.`
|
|
- Categoría: `legendary_weapons`
|
|
- Stackable: `false,1`
|
|
|
|
**Tags:**
|
|
```
|
|
legendary, weapon, sword, dragon
|
|
```
|
|
|
|
**Props:**
|
|
```json
|
|
{
|
|
"damage": 50,
|
|
"tool": { "type": "sword", "tier": 5 },
|
|
"breakable": { "enabled": false }
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
### Ejemplo 4: Enemigo Boss
|
|
|
|
```
|
|
!mob-crear dragon_boss
|
|
```
|
|
|
|
**Base:**
|
|
- Nombre: `🐉 Dragón Ancestral`
|
|
- Categoría: `boss`
|
|
|
|
**Stats:**
|
|
```json
|
|
{
|
|
"attack": 50,
|
|
"hp": 1000,
|
|
"defense": 30,
|
|
"xpReward": 1000
|
|
}
|
|
```
|
|
|
|
**Drops:**
|
|
```json
|
|
{
|
|
"draws": 5,
|
|
"table": [
|
|
{ "type": "coins", "amount": 1000, "weight": 10 },
|
|
{ "type": "item", "itemKey": "dragon_scale", "qty": 3, "weight": 8 },
|
|
{ "type": "item", "itemKey": "legendary_sword", "qty": 1, "weight": 1 }
|
|
]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 🏆 Creando Logros {#creando-logros}
|
|
|
|
Los logros son recompensas que los jugadores pueden obtener al completar ciertos objetivos.
|
|
|
|
### Paso 1: Crear el Logro
|
|
```
|
|
!logro-crear <key-única>
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!logro-crear master_miner
|
|
```
|
|
|
|
### Paso 2: Configurar Base
|
|
Haz clic en **"Base"**:
|
|
- **Nombre:** `Maestro Minero`
|
|
- **Descripción:** `Mina 1000 veces en áreas de minería`
|
|
- **Categoría:** `mining` (mining, combat, economy, fishing, etc.)
|
|
- **Icono:** `⛏️` (emoji o URL)
|
|
- **Puntos:** `100` (puntos que otorga el logro)
|
|
- **Oculto:** `false` (si es `true`, no se muestra hasta desbloquearlo)
|
|
|
|
### Paso 3: Configurar Requisitos
|
|
Haz clic en **"Requisitos (JSON)"**:
|
|
|
|
#### Requisitos de Conteo de Acción:
|
|
```json
|
|
{
|
|
"type": "mine_count",
|
|
"value": 1000
|
|
}
|
|
```
|
|
|
|
Tipos disponibles:
|
|
- `mine_count`: Veces que ha minado
|
|
- `fish_count`: Veces que ha pescado
|
|
- `fight_count`: Veces que ha peleado
|
|
- `craft_count`: Veces que ha crafteado
|
|
- `coins_earned`: Monedas ganadas en total
|
|
- `items_collected`: Items colectados
|
|
|
|
#### Requisitos de Item:
|
|
```json
|
|
{
|
|
"type": "item_owned",
|
|
"itemKey": "diamond_pickaxe",
|
|
"quantity": 1
|
|
}
|
|
```
|
|
|
|
### Paso 4: Configurar Recompensas
|
|
Haz clic en **"Recompensas (JSON)"**:
|
|
|
|
```json
|
|
{
|
|
"coins": 5000,
|
|
"items": [
|
|
{ "itemKey": "legendary_pickaxe", "qty": 1 }
|
|
]
|
|
}
|
|
```
|
|
|
|
### Paso 5: Guardar
|
|
Haz clic en **"Guardar"**.
|
|
|
|
---
|
|
|
|
## 🔍 Gestionando Logros {#gestionando-logros}
|
|
|
|
### Ver Lista de Logros
|
|
```
|
|
!logros-lista [página]
|
|
```
|
|
|
|
Muestra todos los logros del servidor con:
|
|
- Nombre y descripción
|
|
- Puntos que otorga
|
|
- Si está oculto
|
|
- Botones para ver detalles
|
|
|
|
### Ver Detalles de un Logro
|
|
```
|
|
!logro-ver <key>
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!logro-ver master_miner
|
|
```
|
|
|
|
### Eliminar un Logro
|
|
```
|
|
!logro-eliminar <key>
|
|
```
|
|
|
|
**⚠️ Advertencia:** Esto eliminará el logro y el progreso de todos los jugadores.
|
|
|
|
---
|
|
|
|
## 🎯 Creando Misiones {#creando-misiones}
|
|
|
|
Las misiones son tareas que los jugadores pueden completar para obtener recompensas.
|
|
|
|
### Paso 1: Crear la Misión
|
|
```
|
|
!mision-crear <key-única>
|
|
```
|
|
|
|
**Ejemplo:**
|
|
```
|
|
!mision-crear daily_mining_quest
|
|
```
|
|
|
|
### Paso 2: Configurar Base
|
|
Haz clic en **"Base"**:
|
|
- **Nombre:** `Misión Diaria: Minería`
|
|
- **Descripción:** `Mina 10 veces en cualquier área`
|
|
- **Categoría:** `mining`
|
|
- **Tipo:** `daily` (daily, weekly, one_time, repeatable)
|
|
- **Icono:** `⛏️`
|
|
- **Repetible:** `true`
|
|
|
|
### Paso 3: Configurar Requisitos
|
|
Haz clic en **"Requisitos (JSON)"**:
|
|
|
|
#### Contar Acción:
|
|
```json
|
|
{
|
|
"type": "mine_count",
|
|
"count": 10
|
|
}
|
|
```
|
|
|
|
#### Recolectar Items:
|
|
```json
|
|
{
|
|
"type": "collect_items",
|
|
"items": [
|
|
{ "itemKey": "iron_ore", "quantity": 20 }
|
|
]
|
|
}
|
|
```
|
|
|
|
#### Derrotar Enemigos:
|
|
```json
|
|
{
|
|
"type": "defeat_mobs",
|
|
"mobKey": "goblin",
|
|
"count": 5
|
|
}
|
|
```
|
|
|
|
### Paso 4: Configurar Recompensas
|
|
Haz clic en **"Recompensas (JSON)"**:
|
|
|
|
```json
|
|
{
|
|
"coins": 1000,
|
|
"xp": 500,
|
|
"items": [
|
|
{ "itemKey": "mystery_chest", "qty": 1 }
|
|
]
|
|
}
|
|
```
|
|
|
|
### Paso 5: Guardar
|
|
Haz clic en **"Guardar"**.
|
|
|
|
---
|
|
|
|
## 🔍 Gestionando Misiones {#gestionando-misiones}
|
|
|
|
### Ver Lista de Misiones
|
|
```
|
|
!misiones-lista [página]
|
|
```
|
|
|
|
### Ver Detalles de una Misión
|
|
```
|
|
!mision-ver <key>
|
|
```
|
|
|
|
### Eliminar una Misión
|
|
```
|
|
!mision-eliminar <key>
|
|
```
|
|
|
|
---
|
|
|
|
## 👤 Comandos de Jugador {#comandos-jugador}
|
|
|
|
### Ver Perfil
|
|
```
|
|
!player [@usuario]
|
|
```
|
|
|
|
### Ver Estadísticas
|
|
```
|
|
!stats [@usuario]
|
|
```
|
|
|
|
### Ver Cooldowns
|
|
```
|
|
!cooldowns
|
|
```
|
|
|
|
### Ver Saldo
|
|
```
|
|
!monedas
|
|
```
|
|
|
|
### Ver Racha Diaria
|
|
```
|
|
!racha
|
|
```
|
|
|
|
### Ver Inventario
|
|
```
|
|
!inventario [página]
|
|
```
|
|
|
|
### Ver Logros
|
|
```
|
|
!logros [@usuario]
|
|
```
|
|
|
|
### Ver Misiones
|
|
```
|
|
!misiones
|
|
```
|
|
|
|
### Reclamar Misión
|
|
```
|
|
!mision-reclamar <key>
|
|
```
|
|
|
|
---
|
|
|
|
## ❓ Preguntas Frecuentes {#preguntas-frecuentes}
|
|
|
|
### ¿Puedo editar un item después de crearlo?
|
|
Sí, usa el comando:
|
|
```
|
|
!item-editar <key>
|
|
```
|
|
|
|
### ¿Cómo elimino un item?
|
|
Usa el comando:
|
|
```
|
|
!item-eliminar <key>
|
|
```
|
|
**Advertencia:** Esta acción es permanente y no se puede deshacer.
|
|
|
|
### ¿Cómo veo todos los items creados?
|
|
Usa el comando:
|
|
```
|
|
!items-lista
|
|
```
|
|
Esto mostrará una lista interactiva paginada con todos los items del servidor.
|
|
|
|
### ¿Qué formato tienen las fechas ISO?
|
|
El formato ISO es: `YYYY-MM-DDTHH:MM:SSZ`
|
|
|
|
**Ejemplos:**
|
|
- `2025-01-15T00:00:00Z` (15 de enero de 2025 a las 00:00 UTC)
|
|
- `2025-12-25T23:59:59Z` (25 de diciembre de 2025 a las 23:59 UTC)
|
|
|
|
### ¿Puedo crear items globales para todos los servidores?
|
|
Solo los administradores del bot pueden crear items globales. Los items que crees estarán limitados a tu servidor.
|
|
|
|
### ¿Cuántos niveles puedo crear por área?
|
|
No hay límite técnico, pero se recomienda entre 5-10 niveles por área para mantener la progresión balanceada.
|
|
|
|
### ¿Qué pasa si un jugador no tiene la herramienta requerida?
|
|
El bot le mostrará un mensaje indicando qué herramienta necesita y de qué nivel.
|
|
|
|
### ¿Cómo funcionan los pesos (weights)?
|
|
Los pesos determinan la probabilidad relativa. Por ejemplo:
|
|
- Item A (weight: 10) y Item B (weight: 5)
|
|
- Item A tiene el doble de probabilidad de salir que Item B
|
|
- Probabilidad de A: 10/15 = 66.7%
|
|
- Probabilidad de B: 5/15 = 33.3%
|
|
|
|
### ¿Puedo hacer que un item cure un porcentaje de vida en lugar de cantidad fija?
|
|
Sí, usa `healPercent` en las props de food:
|
|
```json
|
|
{
|
|
"food": {
|
|
"healPercent": 50,
|
|
"cooldownSeconds": 60
|
|
}
|
|
}
|
|
```
|
|
Esto curará el 50% de la vida máxima del jugador.
|
|
|
|
### ¿Cómo hago que un nivel sea más difícil que otro?
|
|
Aumenta:
|
|
- El tier mínimo de herramienta requerida
|
|
- El peso de enemigos más fuertes
|
|
- Reduce el peso de recompensas comunes
|
|
- Aumenta el cooldown del área
|
|
|
|
### ¿Puedo combinar diferentes tipos de props en un item?
|
|
Sí, puedes combinar múltiples props. Por ejemplo, un item que sea arma y herramienta:
|
|
```json
|
|
{
|
|
"tool": { "type": "sword", "tier": 3 },
|
|
"damage": 25,
|
|
"breakable": { "enabled": true, "maxDurability": 200, "durabilityPerUse": 1 }
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 🎓 Consejos Pro
|
|
|
|
### Balanceo de Economía
|
|
- Items iniciales: 10-100 monedas
|
|
- Items raros: 500-1000 monedas
|
|
- Items legendarios: 5000+ monedas
|
|
|
|
### Progresión de Herramientas
|
|
Tier recomendado:
|
|
- Tier 1: Madera/Piedra
|
|
- Tier 2: Cobre/Bronce
|
|
- Tier 3: Hierro
|
|
- Tier 4: Acero
|
|
- Tier 5: Mithril/Legendario
|
|
|
|
### Durabilidad Recomendada
|
|
- Herramientas básicas: 50-100 usos
|
|
- Herramientas intermedias: 150-300 usos
|
|
- Herramientas avanzadas: 500+ usos
|
|
|
|
### Cooldowns Recomendados
|
|
- Actividades básicas: 30-60 segundos
|
|
- Actividades intermedias: 2-5 minutos
|
|
- Actividades difíciles: 10-30 minutos
|
|
|
|
---
|
|
|
|
## 🆕 Preguntas Frecuentes sobre Logros y Misiones
|
|
|
|
### ¿Cómo funcionan los logros?
|
|
Los logros son objetivos permanentes que los jugadores desbloquean al cumplir requisitos específicos. Otorgan puntos y recompensas únicas.
|
|
|
|
### ¿Cuál es la diferencia entre logros y misiones?
|
|
- **Logros:** Permanentes, se desbloquean una vez, dan puntos y prestigio
|
|
- **Misiones:** Pueden ser repetibles, tienen tipos (diarias, semanales), dan recompensas cada vez
|
|
|
|
### ¿Los logros pueden ser ocultos?
|
|
Sí, puedes marcar un logro como `hidden: true`. Los jugadores no verán su existencia hasta desbloquearlo.
|
|
|
|
### ¿Puedo crear misiones que se repitan cada día?
|
|
Sí, configura el tipo como `daily` y `repeatable: true`. Los jugadores podrán completarla cada día.
|
|
|
|
### ¿Cómo veo el progreso de los jugadores en misiones?
|
|
Usa `!mision-ver <key>` para ver estadísticas generales, o pídele al jugador que use `!misiones` para ver su progreso personal.
|
|
|
|
### ¿Los logros y misiones pueden dar items como recompensa?
|
|
Sí, ambos pueden recompensar con:
|
|
- Monedas
|
|
- XP (experiencia)
|
|
- Items específicos
|
|
- Roles de Discord (solo en logros especiales)
|
|
|
|
### ¿Qué pasa si elimino un logro que los jugadores ya desbloquearon?
|
|
Se eliminará el registro de desbloqueo de todos los jugadores. Es mejor desactivar o editar en lugar de eliminar.
|
|
|
|
### ¿Puedo tener misiones con múltiples requisitos?
|
|
Sí, usa el tipo `all` en los requisitos y lista todos los que deben cumplirse:
|
|
```json
|
|
{
|
|
"type": "all",
|
|
"requirements": [
|
|
{ "type": "mine_count", "count": 10 },
|
|
{ "type": "collect_items", "items": [...] }
|
|
]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 📞 Soporte
|
|
|
|
Si tienes problemas o preguntas:
|
|
1. Verifica que tengas los permisos necesarios
|
|
2. Revisa que tus JSONs estén bien formateados
|
|
3. Usa los comandos de lista (`!items-lista`, `!mobs-lista`, etc.) para verificar que todo se creó correctamente
|
|
4. Revisa los logs del bot en caso de errores
|
|
5. Contacta al soporte del bot en el servidor oficial
|
|
|
|
---
|
|
|
|
**¡Feliz creación de contenido! 🎉**
|
|
|
|
---
|
|
|
|
## 📚 Documentación Completa
|
|
|
|
Esta guía es un resumen. Para la **documentación completa, interactiva y moderna** con todas las secciones detalladas, incluyendo:
|
|
|
|
- ✅ Todos los comandos con ejemplos
|
|
- ✅ Sistema completo de creación de contenido (Items, Mobs, Áreas, Niveles, Ofertas)
|
|
- ✅ Guía de Props y configuraciones JSON
|
|
- ✅ Ejemplos prácticos completos
|
|
- ✅ Tips, trucos y FAQ
|
|
- ✅ Diseño moderno con navegación interactiva
|
|
|
|
**Accede a:** `src/server/public/index.html`
|
|
|
|
O visita la URL de tu servidor: `http://tu-servidor:puerto/`
|
|
|
|
---
|
|
|
|
## 🔗 Recursos Adicionales
|
|
|
|
- **CREACION_DE_CONTENIDO.md** - Documentación técnica detallada para administradores sobre creación de contenido
|
|
- **index.html** - Documentación web completa e interactiva
|
|
- **Repositorio del Bot** - Código fuente y documentación técnica
|
|
|
|
---
|
|
|
|
**Última actualización:** Enero 2025 • Versión 0.11.20
|
|
**Amayo Bot** © 2025 - Documentación para usuarios finales de Discord
|