Crystals

Overview

The Crystal System allows players to enhance their tools and weapons with special booster crystals. These crystals provide various benefits including currency boosts, enchantment boosts, and other special effects.

Basic Configuration

Crystal Slots

default-crystal-slots: 3

Players start with 3 crystal slots by default. Administrators can add more slots using the command:

/crystals addslots <Player> <Amount>

Duplicate Crystal Policy

can-have-same-booster-crystal: true

• true: Players can apply multiple crystals with the same booster type

• false: Only one crystal per booster type is allowed

Sound Effects

crystal-applied-sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
crystal-broke-sound: "BLOCK_ANVIL_DESTROY"
crystal-invalid-sound: "ENTITY_VILLAGER_NO"

Sound Triggers:

• crystal-applied-sound: Plays when a crystal is successfully applied

• crystal-broke-sound: Plays when a crystal breaks or is removed

• crystal-invalid-sound: Plays when application fails (insufficient slots or duplicate boosters)

Crystal Types

Currency Boost Crystals

To create crystals that boost currencies, use the currency ID as the boost value.

items:
  souls-crystal:
    boost: souls  # Replace 'souls' with your currency ID
    multiplier: 50-150
    chance: 75-100
    item:
      material: GOLD_NUGGET
      name: '&6&lSouls &e&lCrystal'
      lore:
        - '&8Tool Crystal'
        - '&r'
        - '&7Drag and Drop this &6Souls &eCrystal &7onto'
        - '&7your tool to apply the currency boost.'
        - '&r'
        - '&6&lInformation:'
        - ' &6* &eChance: &f{chance}% Chance to apply'
        - ' &6* &eBoost: &f{multiplier}% &6Souls &eBoost'
        - '&r'
        - '&6[ᴅʀᴀɢ ᴀɴᴅ ᴅʀᴏᴘ ᴏɴᴛᴏ ʏᴏᴜʀ ᴛᴏᴏʟ]'

Common Currency Examples:

• souls - Soul currency

• shards - Shard currency

• essence - Essence currency

Enchantment Boost Crystals

To create crystals that boost specific enchantments, use the enchantment ID as the boost value.

items:
  soulgreed-crystal:
    boost: soulgreed  # Enchantment ID
    multiplier: 25-75
    chance: 60-90
    item:
      material: DIAMOND
      name: '&b&lSoul Greed &3&lCrystal'
      lore:
        - '&8Tool Crystal'
        - '&r'
        - '&7Drag and Drop this &bSoul Greed &3Crystal &7onto'
        - '&7your tool to boost Soul Greed enchantment.'
        - '&r'
        - '&b&lInformation:'
        - ' &b* &3Chance: &f{chance}% Chance to apply'
        - ' &b* &3Boost: &f{multiplier}% &bSoul Greed &3Boost'
        - '&r'
        - '&3[ᴅʀᴀɢ ᴀɴᴅ ᴅʀᴏᴘ ᴏɴᴛᴏ ʏᴏᴜʀ ᴛᴏᴏʟ]'

Common Enchantment IDs:

• soulgreed - Soul Greed enchantment

• keyfinder - Key Finder enchantment

• nuke - Nuke enchantment

• fortune - Fortune enchantment

• efficiency - Efficiency enchantment

All Enchants Boost Crystal

To create crystals that boost ALL enchantments on a tool, use "all-enchants" as the boost value.

items:
  universal-crystal:
    boost: all-enchants  # Special keyword for all enchantments
    multiplier: 15-50
    chance: 30-70
    item:
      material: NETHER_STAR
      name: '&5&lUniversal &d&lCrystal'
      lore:
        - '&8Tool Crystal'
        - '&r'
        - '&7Drag and Drop this &5Universal &dCrystal &7onto'
        - '&7your tool to boost ALL enchantments.'
        - '&r'
        - '&5&lInformation:'
        - ' &5* &dChance: &f{chance}% Chance to apply'
        - ' &5* &dBoost: &f{multiplier}% boost to &5ALL &denchantments'
        - '&r'
        - '&d[ᴅʀᴀɢ ᴀɴᴅ ᴅʀᴏᴘ ᴏɴᴛᴏ ʏᴏᴜʀ ᴛᴏᴏʟ]'

Configuration Parameters

Multiplier Ranges

multiplier: 25-100  # Random boost between 25% and 100%

• Format: min-max (e.g., 50-150 for 50% to 150% boost)

• Single value: 75 (fixed 75% boost)

Chance Ranges

chance: 0-100  # Random success chance between 0% and 100%

• Format: min-max (e.g., 75-100 for 75% to 100% success rate)

• Single value: 85 (fixed 85% success rate)

Placeholder Variables

Use these placeholders in your crystal lore:

• {chance} - Shows the crystal's success chance

• {multiplier} - Shows the crystal's boost multiplier

Custom Format Strings

Define custom format strings for different boost types:

formats:
  essence: "&d{multiplier}% &9Essence Boost"
  souls: "&6{multiplier}% &eSouls Boost"
  shards: "&b{multiplier}% &3Shards Boost"
  soulgreed: "&4{multiplier}% &cSoul Greed Boost"
  keyfinder: "&2{multiplier}% &aKey Finder Boost"
  nuke: "&c{multiplier}% &4Nuke Boost"
  all-enchants: "&5{multiplier}% &dUniversal Boost"

Complete Example Configuration

default-crystal-slots: 3
can-have-same-booster-crystal: true

crystal-applied-sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
crystal-broke-sound: "BLOCK_ANVIL_DESTROY"
crystal-invalid-sound: "ENTITY_VILLAGER_NO"

formats:
  essence: "&d{multiplier}% &9Essence Boost"
  souls: "&6{multiplier}% &eSouls Boost"
  shards: "&b{multiplier}% &3Shards Boost"
  soulgreed: "&4{multiplier}% &cSoul Greed Boost"
  keyfinder: "&2{multiplier}% &aKey Finder Boost"
  nuke: "&c{multiplier}% &4Nuke Boost"
  all-enchants: "&5{multiplier}% &dUniversal Boost"

items:
  # Currency Boost Crystal
  souls-crystal:
    boost: souls
    multiplier: 50-150
    chance: 75-100
    item:
      material: GOLD_NUGGET
      name: '&6&lSouls &e&lCrystal'
      lore:
        - '&8Tool Crystal'
        - '&r'
        - '&7Applies a souls boost to your tool.'
        - '&r'
        - '&6&lStats:'
        - ' &6* &eChance: &f{chance}%'
        - ' &6* &eBoost: &f{multiplier}%'

  # Specific Enchant Boost Crystal  
  soulgreed-crystal:
    boost: soulgreed
    multiplier: 25-75
    chance: 60-90
    item:
      material: DIAMOND
      name: '&4&lSoul Greed &c&lCrystal'
      lore:
        - '&8Tool Crystal'
        - '&r'
        - '&7Boosts Soul Greed enchantment effectiveness.'
        - '&r'
        - '&4&lStats:'
        - ' &4* &cChance: &f{chance}%'
        - ' &4* &cBoost: &f{multiplier}%'

  # All Enchants Boost Crystal
  universal-crystal:
    boost: all-enchants
    multiplier: 15-40
    chance: 40-80
    item:
      material: NETHER_STAR
      name: '&5&lUniversal &d&lCrystal'
      lore:
        - '&8Tool Crystal'
        - '&r'
        - '&7Boosts ALL enchantments on your tool.'
        - '&r'
        - '&5&lStats:'
        - ' &5* &dChance: &f{chance}%'
        - ' &5* &dBoost: &f{multiplier}%'