MiniGames Plugin

# MiniGames Plugin v2.0

> **El plugin de minijuegos más completo y personalizable para Minecraft 1.20+**

## Descripción

**MiniGames Plugin** es una solución todo-en-uno para servidores de Minecraft que buscan ofrecer una experiencia de minijuegos completa, profesional y altamente personalizable. Con más de **10 tipos de arenas**, sistema de economía integrado, clanes, torneos, cosméticos y mucho más.

### ✨ Características Principales

- ️ **10+ Tipos de Arenas** - Parkour, PvP, CTF, Race, Spleef, TNT Run, y más
- **Sistema de Economía** - Monedas, tienda, recompensas personalizables
- **Sistema de Clanes** - Crea clanes, compite con amigos, chat privado
- **Torneos Automáticos** - Sistema de brackets, premios multiplicados
- ✨ **21 Cosméticos** - Trails de partículas, pets, efectos de muerte
- **Estadísticas Completas** - Tracking de wins, kills, records, rachas
- **Logros y Misiones** - Sistema de achievements y misiones diarias
- ⚙️ **100% Configurable** - GUI in-game + archivos YAML
- **Multi-idioma** - Español e Inglés incluidos
- **GUIs Modernas** - Menús interactivos y visuales

---

## Tipos de Minijuegos

### Parkour
- Sistema de checkpoints inteligente
- Timer en action bar
- Records personales y globales
- Sistema de rachas con bonos
- Anti-caída y anti-hambre
- Particle trails mientras corres
- Herramienta de reset

### ⚔️ PvP Arena
- Combate 1v1 o FFA
- Sistema de killstreaks
- Kits personalizables
- Respawn automático
- Estadísticas de K/D
- Recompensas por kills

### Capture The Flag
- Equipos automáticos
- Banderas con efectos visuales
- Sistema de puntuación
- Chat de equipo
- Recompensas por capturas
- Modo competitivo

### Race
- Carreras de hasta 16 jugadores
- Checkpoints de vuelta
- Podio automático
- Records de tiempo
- Power-ups en pista
- Recompensas por posición

### Spleef
- Bloques que desaparecen
- Múltiples niveles
- Último en pie gana
- Power-ups especiales
- Espectador automático

### TNT Run
- Bloques que explotan
- Velocidad progresiva
- Múltiples plataformas
- Efectos de partículas
- Survival mode

### Bow Spleef
- Arco con knockback
- Munición infinita
- Plataformas destructibles
- Combate aéreo

### ️ Build Battle
- Temas aleatorios
- Sistema de votación
- Time limit configurable
- Premios por creatividad

### Paintball
- Armas de paintball
- Equipos o FFA
- Munición limitada
- Recarga automática

### Y más...
- Modo Edit para crear arenas
- Sistema de espectadores
- Lobbies personalizables

---

## Sistema de Economía

### Monedas
- Monedas iniciales configurables
- Gana monedas jugando
- Sistema anti-inflación
- Balance visible en action bar

### Tienda
```
Power-ups:
• Speed Boost (100 monedas) - Velocidad por 10s
• Double Jump (150 monedas) - 3 saltos dobles
• Checkpoint Saver (200 monedas) - Guarda posición
• Time Freeze (250 monedas) - Congela timer 5s

Upgrades:
• Extra Life (500 monedas) - Vida extra en PvP
• Damage Boost (300 monedas) - +50% daño
• Shield (400 monedas) - 4 corazones absorción
```

### Recompensas
- **Parkour:** 50-200 monedas por completar
- **PvP:** 10 monedas por kill, 100 por victoria
- **CTF:** 50 por captura, 150 por victoria
- **Race:** 100/50/25 por posición
- **Killstreaks:** Bonos de 20-100 monedas
- **Logros:** 100-50,000 monedas
- **Misiones Diarias:** 50-200 monedas

---

## ✨ Sistema de Cosméticos

### 21 Particle Trails
```
Básicos (100-200 monedas):
Flame Heart Note ✨ Enchant
☁️ Cloud Magic Smoke Water

Premium (250-400 monedas):
Lava ❄️ Snow Slime Redstone
Portal ⭐ End Rod Dragon Firework

VIP Exclusivos (500 monedas):
Totem Soul Cherry ⚡ Electric
Rainbow
```

### Pets
- 10 tipos de mascotas
- Siguen al jugador
- Efectos de partículas
- Nombres personalizables

### Efectos de Muerte
- Explosión
- Rayo
- Fuegos artificiales

---

## Sistema de Clanes

### Características
- Crear clanes con nombre y tag
- Hasta 20 miembros
- Banco de clan compartido
- Chat privado de clan
- Ranking de clanes
- Sistema de roles (Líder, Oficial, Miembro)

### Comandos de Clan
```
/mg clan create <nombre> <tag> - Crear clan (500 monedas)
/mg clan join <nombre> - Unirse a clan
/mg clan leave - Salir del clan
/mg clan info [nombre] - Ver información
/mg clan chat <mensaje> - Chat de clan
/mg clan top - Top clanes
```

---

## Torneos

### Sistema Automático
- Registro automático
- Brackets generados
- Eliminación simple/doble
- Premios multiplicados x3
- Broadcast de resultados

### Comandos
```
/mg tournament create <nombre> - Crear torneo
/mg tournament join <nombre> - Unirse
/mg tournament start <nombre> - Iniciar
/mg tournament bracket <nombre> - Ver bracket
```

---

## Estadísticas y Logros

### Stats Trackeadas
- Total de victorias
- Total de kills
- Ratio K/D
- Records de tiempo
- Rachas máximas
- Monedas ganadas
- Partidas jugadas

### Logros
```
Logros Disponibles:
• Primera Victoria (100 monedas)
• 10 Victorias (500 monedas)
• 100 Victorias (5,000 monedas)
• 1000 Victorias (50,000 monedas)
• Primera Kill (50 monedas)
• 100 Kills (1,000 monedas)
• Completar Parkour (100 monedas)
• Crear Clan (500 monedas)
• Ganar Torneo (1,000 monedas)
```

---

## ⚙️ Sistema de Configuración v2.0

### 5 Archivos de Configuración
```yaml
config.yml - Configuración general
• Economía (monedas iniciales, máximo)
• Parkour (recompensas, bonos, anti-caída)
• PvP (kills, muertes, respawn)
• Clanes (costo, miembros, banco)
• Torneos (jugadores, tiempo)

shop-config.yml - Tienda
• Precios de power-ups
• Precios de upgrades
• Precios de kits
• Habilitado/deshabilitado

cosmetics-config.yml - Cosméticos
• Precio de cada trail
• VIP-only flags
• Configuración de pets
• Efectos de muerte

rewards-config.yml - Recompensas
• Recompensas por parkour
• Recompensas por PvP
• Recompensas por logros
• Bonos de killstreak

messages-config.yml - Mensajes
• Todos los mensajes del plugin
• Placeholders personalizables
• Multi-idioma
```

### GUI de Configuración In-Game
```
/mg config - Abre menú visual de configuración

Menús Disponibles:
Economía - Monedas, recompensas
Parkour - Bonos, anti-caída, timer
Tienda - Precios de items
⚔️ PvP - Kills, respawn, killstreaks

Edición Visual:
• Click Izquierdo: +10
• Click Derecho: +1
• Shift + Click: -10
• Toggle automático para booleanos
• Guardado automático
```

### Comandos de Configuración
```
/mg config reload - Recargar configuración
/mg config set <path> <value> - Establecer valor
/mg config get <path> - Obtener valor

Ejemplos:
/mg config set economy.starting-coins 200
/mg config set parkour.anti-fall-damage true
/mg config get shop.power-ups.speed-boost.price
```

---

## Comandos Completos

### Comandos de Jugador
```
/mg - Menú principal
/mg join <arena> - Unirse a arena
/mg leave - Salir de arena
/mg shop - Abrir tienda
/mg stats [jugador] - Ver estadísticas
/mg top <arena> - Leaderboard
/mg cosmetic - Menú de cosméticos
/mg clan <subcomando> - Comandos de clan
/mg party <subcomando> - Sistema de partidos
/mg achievements - Ver logros
/mg missions - Misiones diarias
```

### Comandos de Admin
```
/mg create <tipo> <nombre> - Crear arena
/mg delete <arena> - Eliminar arena
/mg setspawn <arena> <tipo> - Establecer spawn
/mg edit <arena> - Modo edición
/mg start <arena> - Forzar inicio
/mg stop <arena> - Detener partida
/mg config - Configuración visual
/mg reload - Recargar plugin
/mg give <jugador> <cantidad> - Dar monedas
```

---

## Permisos

### Permisos de Jugador
```
mg.play - Jugar en arenas (default: true)
mg.join - Unirse a arenas (default: true)
mg.leave - Salir de arenas (default: true)
mg.shop - Acceder a tienda (default: true)
mg.stats - Ver estadísticas (default: true)
mg.cosmetics - Usar cosméticos (default: true)
mg.clan - Comandos de clan (default: true)
mg.party - Sistema de partidos (default: true)
mg.vip - Cosméticos VIP (default: false)
```

### Permisos de Admin
```
mg.admin - Acceso completo (default: op)
mg.create - Crear arenas (default: op)
mg.delete - Eliminar arenas (default: op)
mg.edit - Editar arenas (default: op)
mg.config - Configuración (default: op)
mg.give - Dar monedas (default: op)
mg.reload - Recargar plugin (default: op)
mg.bypass - Bypass de restricciones (default: op)
```

---

## Instalación

### Requisitos
- Minecraft 1.20 o superior
- Spigot/Paper 1.20+
- Java 17 o superior

### Pasos
1. Descarga `minigames-plugin-2.0.jar`
2. Coloca el archivo en la carpeta `plugins/`
3. Reinicia el servidor
4. Los archivos de configuración se generarán automáticamente
5. Configura a tu gusto y usa `/mg reload`

### Primera Configuración
```bash
1. Crear primera arena:
/mg create parkour MiParkour

2. Establecer spawns:
/mg setspawn MiParkour lobby
/mg setspawn MiParkour start
/mg setspawn MiParkour end

3. Probar:
/mg join MiParkour
```

### Rendimiento
- Optimizado para 100+ jugadores
- Async processing para stats
- Particle pooling
- Efficient data storage
- Memory leak prevention

### Compatibilidad
- ✅ Spigot 1.20+
- ✅ Paper 1.20+ (Recomendado)
- ✅ Purpur 1.20+
- ✅ Plugins de economía (Vault)
- ✅ Plugins de permisos (LuckPerms)

## Soporte
- Email: [email protected]
---

### v2.0.0 (Actual)
- ✨ Sistema de configuración completo
- ✨ GUI de configuración in-game
- ✨ 5 archivos de config YAML
- ✨ Mensajes con placeholders
- Fixes en parkour auto-start
- Fixes en detección de placas
- Traducción completa a español

### v1.9.1
- Parkour fixes
- Spanish translation
- ✨ Cosmetic GUI improvements

### v1.8.0
- ✨ Sistema de clanes
- ✨ Torneos automáticos
- ✨ Misiones diarias

---

## Licencia

Este plugin es de uso privado. Todos los derechos reservados.

---

## ¿Por qué elegir MiniGames Plugin?

### ✅ Completo
Todo lo que necesitas en un solo plugin: arenas, economía, stats, clanes, torneos, cosméticos.

### ✅ Personalizable
100% configurable vía archivos YAML o GUI in-game. Adapta todo a tu servidor.

### ✅ Profesional
Código limpio, optimizado, sin bugs. Usado en servidores con 100+ jugadores.

### ✅ Actualizado
Soporte activo, actualizaciones frecuentes, compatibilidad con últimas versiones.

### ✅ Fácil de Usar
Instalación en 5 minutos. Documentación completa. Soporte dedicado.

---

**¿Listo para llevar tu servidor al siguiente nivel?**