Encantamientos

El pico trae 25 encantamientos configurables en enchants.yml, y se pueden crear más sin código. Cada uno tiene rareza, moneda propia, costo que crece por nivel, nivel de pico requerido, probabilidad por nivel, conflictos y requisitos.


Configuración	`enchants.yml`, `custom-enchants/`
Menús	`menus/pickaxe.yml`, `menus/enchant-upgrade.yml`
Módulo	`pickaxe-system`

Encantamientos incluidos

Minería y recompensas

ID	Trigger	Rareza	Nivel máx.	Moneda	Nivel de pico	Efecto
`efficiency_boosted`	PASSIVE	COMMON	100	money	1	Efficiency vanilla oculto en el pico
`fortune_boosted`	POST_BREAK	UNCOMMON	100	money	1	Bloques extra al minar
`telekinesis`	POST_BREAK	RARE	1	money	5	Compatibilidad: el core ya envía siempre los drops a la venta, la mochila o el inventario
`exp_boost`	POST_BREAK	UNCOMMON	50	tokens	10	Multiplica la experiencia del pico
`auto_smelt`	POST_BREAK	RARE	3	money	15	Funde los minerales
`triturador`	POST_BREAK	RARE	3	gems	30	Duplica drops con probabilidad
`magnetismo`	POST_BREAK	UNCOMMON	10	tokens	15	Recoge ítems tirados en el suelo cerca del jugador
`eco_friendly`	PASSIVE	LEGENDARY	1	gems	50	El pico no pierde durabilidad
`auto_sell`	POST_BREAK	EPIC	1	gratis	1	Venta automática, incluido y no removible
`gem_finder`	POST_BREAK	LEGENDARY	50	gems	30	Encuentra gemas
`token_miner`	POST_BREAK	RARE	100	money	15	Encuentra tokens
`speed_miner`	PASSIVE	UNCOMMON	3	tokens	10	Velocidad al minar
`lucky_strike`	POST_BREAK	MYTHIC	10	gems	50	Multiplica las recompensas del bloque
`jackpot`	POST_BREAK	RARE	100	money	10	Ráfaga de tokens con chance de gemas
`frenzy`	POST_BREAK	EPIC	100	tokens	20	Haste III y, mientras dura, tokens extra y +50% de experiencia

Área

ID	Rareza	Nivel máx.	Moneda	Nivel de pico	Qué rompe
`explosive`	EPIC	10	money	20	Radio alrededor del bloque
`vein_miner`	EPIC	25	tokens	25	La veta completa del mismo mineral
`drill`	RARE	100	tokens	15	Túnel 3×3 hacia donde mirás
`laser`	EPIC	100	tokens	25	Rayo recto hacia donde mirás
`thunderstrike`	EPIC	100	tokens	30	Columna de arriba a abajo, 3×3 desde nivel 50
`shockwave`	EPIC	100	tokens	35	Disco alrededor del bloque, dos de profundidad desde nivel 25
`layer`	LEGENDARY	100	tokens	50	La capa entera de la mina a tu altura
`vortex`	LEGENDARY	100	tokens	55	Embudo en espiral hacia el interior
`meteor`	LEGENDARY	100	tokens	60	Cráter en un punto aleatorio de la mina
`nuke`	MYTHIC	100	tokens	75	Esfera grande alrededor del bloque

Todos los de área son PRE_BREAK. explosive y vein_miner son incompatibles entre sí.

Ningún encantamiento crea TNT ni rayos reales: explosiones, meteoros y rayos son visuales.

Opciones de cada encantamiento

yaml

enchantments:
  token_miner:
    display-name: "&e🪙 Token Miner"
    type: PICKAXE
    trigger: POST_BREAK          # PRE_BREAK, POST_BREAK o PASSIVE
    rarity: RARE                 # COMMON, UNCOMMON, RARE, EPIC, LEGENDARY, MYTHIC
    description:
      - "&7Chance to find tokens"
      - "&7when mining blocks."
      - ""
      - "&7Level {level}: &f{value} tokens ({chance}% chance)"
    max-level: 100
    base-cost: 375000.0
    cost-multiplier: 1.07
    currency: "MONEY"            # cualquier moneda de currencies.yml
    required-pickaxe-level: 15
    gui-slot: 24
    gui-item: "GOLD_NUGGET"
    conflicts-with: []
    requires: []                 # encantamientos que hay que tener antes
    level-values:                # fuerza por nivel: aquí, tokens encontrados
      1: 5
      5: 50
      100: 500
    level-chances:               # probabilidad en % por nivel
      1: 5
      5: 22
      100: 50

Interpolación: level-values y level-chances solo necesitan los niveles donde algo cambia. Entre dos entradas el valor se interpola, y por encima de la última se mantiene. Al subir max-level, agregá una entrada para el nuevo máximo.
Costo: el nivel N cuesta base-cost × cost-multiplier ^ (N - 1).
Probabilidad final: level-chances × estadística enchant-chance × nodo ENCHANT_POWER del árbol. Ver Estadísticas.

Comprar y quitar

Menú: clic en un encantamiento del menú del pico abre su menú de mejora, con botones para comprar 1, 10, 100 o el máximo de niveles, quitar un nivel o quitarlo entero.
Comandos:

Comando	Hace
`/enchant list`	Todos, con tu nivel y precio
`/enchant <encantamiento> <niveles\|max>`	Compra niveles
`/enchant remove <encantamiento> [niveles\|all]`	Quita niveles con reembolso

Aliases: /upgrade, /encantar. Permiso: pulseprison.enchant.use.

El reembolso es pickaxe.disenchant.refund-percent del precio de los niveles quitados. auto_sell no se puede quitar, y un encantamiento del que depende otro que tenés tampoco.

Dónde pueden romper los encantamientos de área

Cada bloque que un encantamiento de área quiere romper pasa por la misma protección. Solo se rompe si:

Está dentro de una mina de PulsePrison, de rango o privada, o
Está en una región de WorldGuard con el flag pulseprison-enchants en allow y el jugador podría romperlo a mano.

/rg flag <región> pulseprison-enchants allow

En cualquier otro lugar no pasa nada. Contenedores, carteles, portales y bloques irrompibles siempre se saltean.

yaml

settings:
  show-particles: true
  destruction:
    allow-in-mines: true
    allow-in-worldguard-regions: true
    respect-worldguard-build: true
    max-blocks-per-activation: 2500    # tope por activación

Los bloques extra se pagan igual que minar a mano: con auto-sell se venden en un solo lote por material; sin auto-sell van a la mochila y después al inventario. Un bloque con precio 0 va siempre a la mochila o al inventario.

Mensajes de activación

Los encantamientos especiales avisan en el chat o la action bar cuando se activan, así el jugador sabe qué causó el efecto. Cada jugador los apaga, cambia de chat a action bar o silencia encantamientos sueltos en /settings.

yaml

settings:
  activation-messages:
    enabled: true
    default-on: true
    mode: chat                 # chat o actionbar
    cooldown-millis: 1500      # entre dos avisos del mismo encantamiento
    enchants: [explosive, vein_miner, nuke, layer, jackpot, frenzy]
    custom-enchants: true      # también los de custom-enchants/

El texto es enchant-activation.message en los archivos de mensajes.

Orden al minar

text

1. PRE_BREAK   encantamientos de área: suman bloques extra
2. PASSIVE     efficiency, speed miner, eco friendly
3. POST_BREAK  drops, tokens, gemas, multiplicadores
4. Venta o entrega del bloque y de los extra
5. Experiencia del pico, niveles, mascota, temporada, clan, lucky blocks
6. Action bar

Cada activación suma experiencia de maestría para ese encantamiento.

Placeholders

%pulseprison_pickaxe_enchant_<id>%: nivel del encantamiento.