Skip to 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