pluginv1
LevelAmmo 1.0
Sistema de Leveleo de Items Completamente Configurable | Recompensas Aleatorias | Rankings | PlaceholderAPI
Descripción
¡Sube de nivel tus herramientas, armas y armaduras mientras juegas! LevelAmmo es un plugin que permite a los jugadores ganar XP con sus items y desbloquear recompensas aleatorias al subir de nivel.
Características principales:
- 🔨 10 tipos de items leveleables: Picos, espadas, hachas, arcos, ballestas, tridentes, cascos, pecheras, pantalones y botas
- ⚡ XP por acciones: Minar bloques, golpear mobs, matar enemigos, recibir daño
- 🎁 Recompensas aleatorias: Dinero, comandos, encantamientos, efectos de poción
- 🏆 Rankings globales: Top jugadores por tipo de item
- 🛡️ Anti-exploits: No XP en creativo, bloques colocados, cooldowns
Dependencias
| Plugin | Requerido | Descripción |
|---|---|---|
| Vault | Opcional | Para recompensas de dinero |
| PlaceholderAPI | Opcional | Para placeholders en scoreboards |
Comandos
| Comando | Descripción | Permiso |
|---|---|---|
/levelammo give <jugador> <tipo> <nivel> |
Dar item leveleable | levelammo.command.give |
/levelammo reload |
Recargar configuración | levelammo.command.reload |
/levelammo setlevel <nivel> |
Establecer nivel del item en mano | levelammo.command.setlevel |
/levelammo setxp <xp> |
Establecer XP del item en mano | levelammo.command.setxp |
/levelammo top <tipo> |
Ver top 10 jugadores | - |
Alias: /la, /lammo
Tipos válidos: pickaxe, sword, axe, bow, crossbow, trident, helmet, chestplate, leggings, boots
Permisos
| Permiso | Descripción | Default |
|---|---|---|
levelammo.command.give |
Usar /levelammo give | OP |
levelammo.command.reload |
Usar /levelammo reload | OP |
levelammo.command.setlevel |
Usar /levelammo setlevel | OP |
levelammo.command.setxp |
Usar /levelammo setxp | OP |
PlaceholderAPI
Placeholders de Top
%levelammo_top_pickaxe_1_name% - Nombre del #1 en picos
%levelammo_top_pickaxe_1_level% - Nivel del #1 en picos
%levelammo_top_sword_1_name% - Nombre del #1 en espadas
%levelammo_top_bow_3_level% - Nivel del #3 en arcos
Placeholders del Item en Mano
%levelammo_held_level% - Nivel del item
%levelammo_held_xp% - XP actual
%levelammo_held_type% - Tipo de item
%levelammo_held_max_xp% - XP necesario para subir
%levelammo_held_max_level% - Nivel máximo
Configuración
config.yml
settings:
creative-xp: false # XP en modo creativo
track-placed-blocks: true # Rastrear bloques colocados (anti-exploit)
placed-block-expire-minutes: 60 # Tiempo de expiración
no-xp-regions: # Mundos sin XP
- "spawn"
- "lobby"
feedback:
messages: true # Mensajes de level-up
titles: true # Títulos
sounds: true # Sonidos
particles: true # Partículasitems.yml
Define qué materiales son leveleables por tipo:
item-types:
pickaxe:
display-name: "&b⛏ Pico Nivel %level%"
lore:
- "&7Nivel: &f%level%"
- "&7XP: &a%xp%&7/&a%max_xp%"
materials:
- DIAMOND_PICKAXE
- NETHERITE_PICKAXElevels.yml
Configura la fórmula de XP por tipo:
profiles:
pickaxe:
max-level: 100
formula:
base: 100 # XP base
scale: 1.5 # Multiplicador
power: 1.8 # Exponente
reset-xp: true # Resetear XP al subirFórmula: xp_requerido = base + (nivel * scale) ^ power
xp.yml
Configura cuánto XP se gana:
pickaxe:
cooldown-ms: 500
blocks:
default: 1
DIAMOND_ORE: 15
ANCIENT_DEBRIS: 50
blacklist:
- STONE
- DIRT
sword:
hit-xp: 2
kill-xp: 15
helmet:
pve-xp: 1
pvp-xp: 4
max-xp-per-second: 10
deny-environmental-damage: truerewards.yml
Configura recompensas por nivel:
pools:
pickaxe.1-10:
mode: single # single = 1 reward, multiple = varios
guaranteed:
reward1:
type: MESSAGE
value: "&a¡Tu pico subió a nivel %level%!"
random:
reward1:
type: MONEY
amount: 100
weight: 50
reward2:
type: ENCHANT
value: EFFICIENCY
amount: 1
weight: 20Tipos de recompensa:
CONSOLE_COMMAND- Comando desde consolaPLAYER_COMMAND- Comando como jugadorMESSAGE- Mensaje al jugadorMONEY- Dinero (requiere Vault)ENCHANT- Añadir encantamiento al itemPOTION_EFFECT- Efecto de poción (formato:TIPO:AMPLIFICADOR:DURACION)SOUND- Reproducir sonidoTITLE- Mostrar título (formato:TITULO|SUBTITULO)ITEM- Dar item
Cómo Funciona
Picos
- Ganan XP al romper bloques
- Bloques en blacklist no dan XP
- Minerales dan bonus XP
- Bloques colocados por jugadores no dan XP
Armas (Espadas, Hachas, Arcos, Ballestas, Tridentes)
- Ganan XP al golpear mobs/jugadores
- Bonus XP al matar
Armadura
- Gana XP al recibir daño
- PvP da más XP que PvE
- Daño ambiental (fuego, caída, etc.) no da XP por defecto
- Límite de XP por segundo para evitar exploits
Anti-Exploits
✅ No XP en modo Creativo
✅ No XP por bloques colocados por jugadores
✅ Cooldowns entre acciones
✅ Límite de XP por segundo (armadura)
✅ No XP por daño ambiental
✅ UUID único por item (previene clonación NBT)
Instalación
- Descarga el JAR
- Colócalo en la carpeta
plugins/ - Reinicia el servidor
- Configura los archivos en
plugins/LevelAmmo/ - Usa
/levelammo reloadpara aplicar cambios
Soporte
¿Problemas o sugerencias? Abre un issue o contacta al autor.
Autor: Pecar087
Versión: 1.1
API: Spigot 1.21