📚 LevelAmmo Wiki
El Sistema RPG de Niveles más Completo para Minecraft
Versión: 1.7 | API: Spigot 1.21.1 | Autor: Pecar087
📖 Índice
- Introducción
- Instalación
- Características
- Comandos
- Permisos
- Configuración
- Sistema de Niveles
- Sistema de Skills
- Sistema de Prestigio
- Custom Enchants
- Mob Levels
- Eventos Mundiales
- Desafíos
- Logros
- API para Desarrolladores
- PlaceholderAPI
- FAQ
🎮 Introducción
LevelAmmo es un plugin RPG que permite a los jugadores subir de nivel sus herramientas, armas y armaduras mientras juegan. Cada acción (minar, matar mobs, recibir daño) otorga XP que hace que tus items sean más poderosos.
Características Principales
- 🔨 10+ tipos de items leveleables
- 🔮 20+ habilidades desbloqueables
- ✨ 15 encantamientos custom
- 👹 Sistema de niveles para mobs
- ⚡ Eventos mundiales
- 📋 Desafíos diarios/semanales
- 🏆 50 logros
- 🌍 Multi-idioma (ES, EN, PT)
- 🗄️ MySQL/SQLite
📥 Instalación
- Descarga
LevelAmmo-1.7.jar - Colócalo en la carpeta
plugins/ - Reinicia el servidor
- Configura los archivos en
plugins/LevelAmmo/ - Usa
/la reloadpara aplicar cambios
Dependencias Opcionales
| Plugin | Uso |
|---|---|
| Vault | Recompensas de dinero |
| PlaceholderAPI | Placeholders |
| TokenEnchant | Tokens |
| Oraxen/ItemsAdder | Items custom |
✨ Características
v1.7 - Events & Challenges
- Eventos mundiales (2x XP, Double Drops, Boss Spawn)
- 3 desafíos diarios + 1 semanal
- 50 logros desbloqueables
- API pública para desarrolladores
v1.6 - Mob Levels & Multi-Language
- Mobs con niveles por distancia del spawn
- Elite mobs (5% chance)
- Soporte multi-idioma
v1.5 - Custom Enchantments
- 15 encantamientos únicos
- 5 tiers de rareza
- Sistema de descubrimiento
v1.4 - Database & Stability
- MySQL con HikariCP
- Operaciones asíncronas
- Debug mode
v1.3 - Prestige System
- Sistema de prestigio completo
- Bonus permanentes de XP
v1.2 - Skills System
- 20+ habilidades
- Skills pasivas y activas
⌨️ Comandos
| Comando | Descripción | Permiso |
|---|---|---|
/la give <player> <type> <level> |
Dar item | levelammo.command.give |
/la reload |
Recargar config | levelammo.command.reload |
/la setlevel <level> |
Establecer nivel | levelammo.command.setlevel |
/la setxp <xp> |
Establecer XP | levelammo.command.setxp |
/la top <type> |
Top 10 por nivel | - |
/la ptop <type> |
Top 10 por prestigio | - |
/la stats |
Estadísticas (GUI) | - |
/la skills |
Habilidades (GUI) | - |
/la enchants |
Encantamientos (GUI) | - |
/la prestige |
Prestigiar item | - |
/la events |
Eventos mundiales (GUI) | - |
/la challenges |
Desafíos (GUI) | - |
/la achievements |
Logros (GUI) | - |
/la event <start|stop|list> [id] |
Admin eventos | levelammo.admin |
/la lang <code> |
Cambiar idioma | levelammo.admin |
/la info |
Info del item | - |
Alias: /la, /lammo
🔐 Permisos
| Permiso | Descripción | Default |
|---|---|---|
levelammo.admin |
Administrador | OP |
levelammo.command.give |
Comando give | OP |
levelammo.command.reload |
Comando reload | OP |
levelammo.command.setlevel |
Comando setlevel | OP |
levelammo.command.setxp |
Comando setxp | OP |
levelammo.multiplier.vip |
1.5x XP | false |
levelammo.multiplier.mvp |
2.0x XP | false |
levelammo.multiplier.elite |
3.0x XP | false |
⚙️ Configuración
Archivos
plugins/LevelAmmo/
├── config.yml # Configuración general
├── items.yml # Tipos de items
├── levels.yml # Fórmulas de XP
├── xp.yml # Valores de XP
├── rewards.yml # Recompensas
├── skills.yml # Habilidades
├── enchants.yml # Encantamientos
├── prestige.yml # Prestigio
├── mobs.yml # Niveles de mobs
├── events.yml # Eventos mundiales
├── challenges.yml # Desafíos
├── achievements.yml # Logros
└── lang/
├── es.yml # Español
├── en.yml # English
└── pt.yml # Português
config.yml Básico
settings:
language: es
creative-xp: false
track-placed-blocks: true
debug: false
database:
type: sqlite # sqlite o mysql
mysql:
host: localhost
port: 3306
database: levelammo
username: root
password: ""📈 Sistema de Niveles
Tipos de Items
- Herramientas: pickaxe, axe
- Armas: sword, bow, crossbow, trident
- Armadura: helmet, chestplate, leggings, boots
Ganancia de XP
| Acción | Item | XP Base |
|---|---|---|
| Minar piedra | Pickaxe | 1 |
| Minar diamante | Pickaxe | 50 |
| Golpear mob | Sword/Axe | 2 |
| Matar zombie | Sword/Axe | 10 |
| Recibir daño | Armor | 1-5 |
Fórmula de XP
XP Requerido = base * (level ^ exponent)
Default: 100 * (level ^ 1.5)
🔮 Sistema de Skills
Skills por Tipo
⛏ Pickaxe:
- Auto-Smelt - Funde minerales
- Fortune Boost - +drops
- Vein Miner - Mina venas
- Haste - Velocidad de minado
- Drill (Activa) - Mina en línea
⚔ Sword:
- Lifesteal - Roba vida
- Critical Chance - Golpes críticos
- Bleed - Sangrado
- Execute - Bonus a baja vida
- Berserk (Activa) - Modo furia
🏹 Bow:
- Multishot - Flechas extra
- Explosive Arrows - Explosiones
- Homing - Flechas guiadas
- Arrow Rain (Activa) - Lluvia
🛡 Armor:
- Thorns Enhanced - Refleja daño
- Regeneration - Regenera vida
- Damage Reduction - Reduce daño
- Shield (Activa) - Inmunidad
Skill Points
Se obtienen en niveles: 10, 20, 30, 40, 50, 60, 70, 80, 90, 100
⭐ Sistema de Prestigio
¿Qué es?
Al alcanzar nivel 100, puedes "prestigiar" para:
- Reiniciar a nivel 1
- Obtener +10% XP permanente
- Ganar recompensas exclusivas
- Mostrar estrellas ★ en el item
Niveles de Prestigio
| Prestigio | Bonus XP | Título |
|---|---|---|
| 1 | +10% | Novato |
| 3 | +30% | Veterano |
| 5 | +50% | Experto |
| 10 | +100% | Legendario |
✨ Custom Enchants
Tiers
- Común (Gris) - Fácil de obtener
- Poco Común (Verde) - 20% drop
- Raro (Azul) - 10% drop
- Épico (Morado) - 5% drop
- Legendario (Dorado) - 1% drop
Encantamientos
| Nombre | Efecto | Tier |
|---|---|---|
| Sharpened Edge | +Daño | Común |
| Critical Strike | +Crítico | Poco Común |
| Vampiric Touch | Lifesteal | Raro |
| Soulbound | No se pierde | Épico |
| Unbreakable | Indestructible | Legendario |
👹 Mob Levels
Sistema
- Nivel basado en distancia del spawn
- Cada 100 bloques = +1 nivel
- Máximo nivel 100
Scaling
| Stat | Por Nivel |
|---|---|
| HP | +10% |
| Daño | +5% |
| XP Drop | +15% |
Elite Mobs
- 5% de probabilidad
- 2x stats
- 3x XP
⚡ Eventos Mundiales
Tipos de Eventos
| Evento | Efecto | Duración |
|---|---|---|
| XP Boost | 2x XP | 15 min |
| Drop Boost | 2x Drops | 15 min |
| Combo Frenzy | Combos fáciles | 20 min |
| Boss Invasion | Spawn boss | 30 min |
| Happy Hour | 1.5x XP + Drops | 30 min |
Auto-Eventos
- Cada 60 minutos
- 30% de probabilidad
- Configurable
📋 Desafíos
Diarios (3 por día)
- Mina 100 bloques
- Mata 30 mobs
- Sube 3 niveles
- Alcanza combo x10
Semanales (1 por semana)
- Mina 1000 bloques
- Mata 200 mobs
- Prestigia un item
Racha Diaria
Completa todos los desafíos diarios para mantener tu racha.
🏆 Logros
Categorías
- ⛏ Minería (10 logros)
- ⚔ Combate (10 logros)
- ⬆ Niveles (10 logros)
- ⭐ Prestigio (8 logros)
- 🔮 Skills (5 logros)
- ✨ Enchants (4 logros)
- 📋 Challenges (3 logros)
- 🌟 Especiales (5 logros)
Tiers
- ★ Bronce
- ★★ Plata
- ★★★ Oro
- ★★★★ Diamante
- ★★★★★ Legendario
🔧 API para Desarrolladores
Obtener API
LevelAmmoAPI api = LevelAmmoAPI.getInstance();Métodos Principales
// Items
api.isLevelable(item);
api.getItemLevel(item);
api.addXP(player, item, amount);
// Events
api.startEvent("xp_boost");
api.getActiveEvents();
// Achievements
api.hasAchievement(playerId, "first_block");📊 PlaceholderAPI
%levelammo_held_level% - Nivel del item
%levelammo_held_xp% - XP actual
%levelammo_held_type% - Tipo de item
%levelammo_held_prestige% - Prestigio
%levelammo_top_pickaxe_1_name% - #1 en picos
%levelammo_top_pickaxe_1_level% - Nivel del #1
❓ FAQ
¿Cómo empiezo?
Solo equipa una herramienta/arma/armadura y úsala normalmente.
¿Puedo usar items custom?
Sí, con Oraxen o ItemsAdder.
¿Funciona con MySQL?
Sí, configura en config.yml.
¿Cómo cambio el idioma?
/la lang es o edita config.yml.
¿Los items se pierden al morir?
Por defecto sí, pero el enchant "Soulbound" los protege.
🔗 Enlaces
© 2024 Pecar087 - LevelAmmo v1.7