Mob Visuals

The visual-settings section controls how mobs appear and display information to players.

Structure

Complete visual settings

visual-settings:
  # Glowing outline effect
  glow:
    enabled: true
    color: 'RED'
  
  # Boss bar displayed when targeting mob
  boss-bar:
    enabled: true
    display: '&cMy Mob &4❤&c%health%'
    color: 'RED'
    overlay: 'PROGRESS'
    flags:
      create-fog: false
      darken-sky: false
      play-boss-music: false
  
  # Damage numbers that appear when hitting mob
  damage-indicator:
    enabled: true
    display: '&c-%damage% &4❤'
    style: 'modern'

Glow Effect

Add a glowing outline around the mob visible through walls.

Enabled

glow:
  enabled: true
  color: 'RED'

Disabled

In-Game Example

Boss Bar

Display a health bar at the top of the screen when players target the mob.

Basic Configuration

Simple boss bar

boss-bar:
  enabled: true
  display: '&cMy Mob'
  color: 'RED'
  overlay: 'PROGRESS'

enabled

Enable or disable the boss bar.

# Show boss bar
boss-bar:
  enabled: true

# No boss bar
boss-bar:
  enabled: false

display

The text shown on the boss bar.

Supports:

• Color codes

• Placeholders (%health%, %max_health%)

• PlaceholderAPI placeholders

Simple

display: '&cZombie Boss'

With Health

With Percentage

Advanced

color

The boss bar color.

Available colors:

Color	Visual
BLUE	Blue bar
GREEN	Green bar
PINK	Pink bar
PURPLE	Purple bar
RED	Red bar
WHITE	White bar
YELLOW	Yellow bar

# Red boss bar (aggressive)
color: 'RED'

# Green boss bar (friendly)
color: 'GREEN'

# Purple boss bar (rare/epic)
color: 'PURPLE'

overlay

The boss bar style/segmentation.

Available overlays:

Overlay	Description
PROGRESS	Smooth bar (no segments)
NOTCHED_6	Bar divided into 6 segments
NOTCHED_10	Bar divided into 10 segments
NOTCHED_12	Bar divided into 12 segments
NOTCHED_20	Bar divided into 20 segments

Smooth Bar

overlay: 'PROGRESS'

Segmented

flags

Optional effects that apply when the boss bar is visible.

Boss bar flags

flags:
  create-fog: false          # Create fog effect
  darken-sky: false          # Darken the sky
  play-boss-music: false     # Play boss music

Use cases:

# Normal mob - no special effects
flags:
  create-fog: false
  darken-sky: false
  play-boss-music: false

# Epic boss - dramatic effects
flags:
  create-fog: true
  darken-sky: true
  play-boss-music: true

# Mini-boss - subtle effects
flags:
  create-fog: true
  darken-sky: false
  play-boss-music: false

Performance Note: Fog effects can potentially have a slight FPS impact on the client (tests will be released soon)

In-Game Fog Example

Darken Sky Example

Damage Indicator

Display damage numbers when the mob is hit.

Configuration

Damage indicator

damage-indicator:
  enabled: true
  display: '&c-%damage% &4❤'
  style: 'phantom'

enabled

Enable or disable damage indicators.

# Show damage numbers
damage-indicator:
  enabled: true

# No damage display
damage-indicator:
  enabled: false

display

The format for damage numbers.

Available Placeholder:

• %damage% - The damage dealt (rounded)

Simple

display: '&c-%damage%'

With Heart

Colorful

With Symbol

Troubleshooting

Boss Bar Not Showing

Problem: Boss bar doesn't appear when targeting mob

Solutions:

• Ensure enabled: true

• Check display text is not empty

• Verify color and overlay are valid values

# WRONG
boss-bar:
  enabled: true
  display: ''  # Empty display

# CORRECT
boss-bar:
  enabled: true
  display: '&cMy Mob'

Glow Not Visible

Problem: Glow effect not showing

Solutions:

• Verify enabled: true

• Check color is a valid option

• Ensure mob is spawned correctly

Damage Numbers Not Appearing

Problem: No damage indicators when hitting mob

Solutions:

• Check enabled: true

• Verify display contains %damage% placeholder

# WRONG
damage-indicator:
  enabled: true
  display: '&cDamage'  # Missing %damage% placeholder

# CORRECT
damage-indicator:
  enabled: true
  display: '&c-%damage% &4❤'