Skip to main content

Visual Effects

SigmaTools provides customizable visual effects for tool usage.

Visual Components​

Particles​

Particle effects when tools are used:

  • Configurable particle types
  • Adjustable count and spread
  • Tool-specific particles

Sounds​

Sound effects when tools are used:

  • Configurable sound types
  • Adjustable volume and pitch
  • Tool-specific sounds

Action Bar​

Real-time information display:

  • Charges and cooldown
  • Durability status
  • Economy costs/rewards

Configuration​

Enable/Disable Visuals​

tools:
  pickaxe:
    visuals:
      particles: true  # Enable particles
      sound: true  # Enable sounds

Particle Configuration​

tools:
  pickaxe:
    visuals:
      particle-type: "EXPLOSION_NORMAL"
      particle-count: 5
      particle-spread: 0.5

Sound Configuration​

tools:
  pickaxe:
    visuals:
      sound-type: "BLOCK_STONE_BREAK"
      sound-volume: 1.0
      sound-pitch: 1.0

Available Particle Types​

Block Effects​

  • BLOCK_CRACK
  • BLOCK_DUST
  • FALLING_DUST
  • EXPLOSION_NORMAL
  • EXPLOSION_LARGE

Combat Effects​

  • CRIT
  • CRIT_MAGIC
  • DAMAGE_INDICATOR

Magic Effects​

  • ENCHANTMENT_TABLE
  • ENCHANT
  • SPELL_WITCH
  • SPELL_MOB

Environmental Effects​

  • SMOKE_NORMAL
  • CLOUD
  • WATER_SPLASH
  • LAVA
  • FLAME

Special Effects​

  • HEART
  • VILLAGER_HAPPY
  • SWEEP_ATTACK
  • TOTEM

Available Sound Types​

Block Breaking​

  • BLOCK_STONE_BREAK
  • BLOCK_WOOD_BREAK
  • BLOCK_GLASS_BREAK
  • BLOCK_METAL_BREAK

Tool Sounds​

  • ITEM_PICKAXE_DIG
  • ITEM_AXE_DIG
  • ITEM_SHOVEL_DIG
  • ITEM_HOE_DIG

Environmental​

  • BLOCK_WATER_AMBIENT
  • BLOCK_LAVA_AMBIENT
  • BLOCK_FIRE_AMBIENT

Interaction​

  • BLOCK_ENCHANTMENT_TABLE_USE
  • ENTITY_EXPERIENCE_ORB_PICKUP
  • ENTITY_GENERIC_EXPLODE

Action Bar Display​

The action bar shows:

  • Charges: ⚡ 3/3 (2s)
  • Durability: ⛏ 1500/1500
  • Economy: 💰 -$10.00 | 💰 +$5.00

Updates every second while holding tool.

Tool-Specific Defaults​

Pickaxe​

  • Particles: EXPLOSION_NORMAL
  • Sound: BLOCK_STONE_BREAK

Axe​

  • Particles: CRIT_MAGIC
  • Sound: BLOCK_WOOD_BREAK

Bucket​

  • Particles: WATER_SPLASH
  • Sound: ENTITY_EXPERIENCE_ORB_PICKUP

Hoe​

  • Particles: HEART
  • Sound: ENTITY_EXPERIENCE_ORB_PICKUP

Customization Examples​

Minimal Visuals​

tools:
  pickaxe:
    visuals:
      particles: false
      sound: false

Enhanced Visuals​

tools:
  pickaxe:
    visuals:
      particles: true
      particle-count: 20
      particle-spread: 1.0
      sound: true
      sound-volume: 2.0

Custom Theme​

tools:
  pickaxe:
    visuals:
      particle-type: "ENCHANTMENT_TABLE"
      particle-count: 10
      sound-type: "BLOCK_ENCHANTMENT_TABLE_USE"
      sound-pitch: 1.5

Performance Considerations​

  • Particle Count - Higher counts = more performance impact
  • Sound Volume - Higher volume = more server load
  • Action Bar - Updates every second, minimal impact

Next Steps​