Docs
Pico
Cada jugador tiene un pico persistente que recibe al entrar. Tiene nivel, experiencia, estadísticas, encantamientos, skin y ranuras de cristales, y es la llave de casi toda la progresión.
| Configuración | config.yml (sección pickaxe), enchants.yml |
| Datos | data/pickaxes/ o la base de datos |
| Módulo | pickaxe-system |
Niveles y experiencia
Cada bloque minado da experience-per-block, multiplicado por Exp Boost, la estadística pickaxe-exp, el árbol de habilidades y la mascota. La experiencia para el siguiente nivel crece con el nivel:
requerida(nivel) = base-requirement × nivel ^ exponent
| Nivel | EXP necesaria | Bloques sin multiplicadores |
|---|---|---|
| 1 → 2 | 250 | 25 |
| 10 → 11 | 5,600 | 560 |
| 100 → 101 | 125,300 | 12,530 |
- Se pueden ganar varios niveles con un solo bloque.
- Cada nivel da puntos del árbol de habilidades (
points-per-pickaxe-level). - El nivel desbloquea encantamientos, skins, ranuras de cristales y habilidades.
- Al subir aparece un título en pantalla.
yaml
pickaxe:
prevent-death-drop: true # el pico no se pierde al morir
recovery-timeout-minutes: 30
autosell-default: true # auto-sell de un pico nuevo
progression:
experience-per-block: 10
base-requirement: 250
exponent: 1.35 # más alto = juego tardío más lento
max-level: 500
display:
name: "ee8fa⛏ &fPickaxe &8• &#b388ffLv. {level}"
idle-refresh-millis: 2500
level-up-title: true
disenchant:
enabled: true
refund-percent: 50 # reembolso al quitar nivelesCómo se ve
- Nombre y lore: nivel, progreso, bloques, dinero ganado, auto-sell y encantamientos. Se actualizan al instante al subir de nivel, comprar o quitar encantamientos y cambiar el auto-sell. Bloques y experiencia se actualizan cuando el jugador deja de minar
idle-refresh-millis, porque reescribir el ítem en la mano repite la animación de sacarlo. - Action bar: siempre en vivo, con experiencia ganada, nivel, barra, porcentaje y dinero.
- Skin: la skin elegida cambia el material, el modelo y el nombre.
- Identidad: el pico se reconoce por una marca interna, no por el nombre ni el material, así que cambiar la skin o renombrarlo no lo rompe.
Menú del pico
Clic derecho con el pico, o /pickaxe, abre menus/pickaxe.yml:
- La grilla central lista los encantamientos con su estado: bloqueado, disponible, activo o al máximo. Clic en uno abre su menú de mejora, también cuando ya está al máximo, para quitar niveles.
- Botones de auto-sell y de ajustes.
- Accesos a skins, cristales, maestrías, habilidades, armaduras y estadísticas. Cada botón se esconde solo si su módulo está apagado.
Protección
- Con
prevent-death-drop, el pico no cae al morir: se guarda y vuelve al reaparecer, duranterecovery-timeout-minutes. - El progreso vive en los datos del jugador, no en el ítem: si lo pierde,
/pickaxe givele entrega uno con todo su nivel y encantamientos. - Al entrar, el jugador recibe su pico si no lo tiene.
Comandos
| Comando | Permiso | Hace |
|---|---|---|
/pickaxe · /pickaxe stats | pulseprison.pickaxe.use | Nivel, experiencia, estadísticas y encantamientos |
/pickaxe autosell [on|off] · /autosell [on|off] | pulseprison.pickaxe.use · pulseprison.autosell | Auto-sell |
/pickaxe refresh | pulseprison.pickaxe.use | Rehace el ítem |
/pickaxe give <jugador> | pulseprison.pickaxe.admin | Entrega un pico de reemplazo |
/pickaxe reset <jugador> confirm | pulseprison.pickaxe.admin | Borra el pico de un jugador |
/prisonadmin pickaxe <jugador|me> ... | pulseprison.prisonadmin | Nivel y experiencia, ver Comandos de staff |
Aliases de /pickaxe: /pico, /pick.
Placeholders
%pulseprison_pickaxe_level%, %pulseprison_pickaxe_exp%, %pulseprison_pickaxe_exp_needed%, %pulseprison_pickaxe_progress%, %pulseprison_pickaxe_blocks_mined%, %pulseprison_pickaxe_enchant_<id>%.