config.yml

The config.yml file houses all operational settings, physics parameters, cosmetic definitions, and feature toggles for AerosPearls.

Full Configuration Reference

yaml

license:
  key: ''

prefix: "{prefix}"

disable-endermites: true
endermite-chance: 0.1

pearl-damage-self: 5
pearl-damage-other: 2

teleport-no-damage-ticks: 5

pearl-cooldown: 0.5
join-pearl-cooldown: 30
world-change-pearl-cooldown: 20

disable-fall-damage: true
cooldown-actionbar: true

pearl-sound: ENTITY_ENDERMAN_TELEPORT

through:
  pearlPassThroughEnabled: true
  pearlPassThroughBlocks:
    - OAK_FENCE
    - OAK_FENCE_GATE
    - LADDER
    - OAK_SLAB
    - STONE_SLAB
    - IRON_BARS

options:
  return-pearl-on-blocked: true
  pass-through-if-block-above: true
  disable-pearl-inside-blocks: true
  refund-on-void: true
  cancel-pearl-on-death: true

effects:
  enabled: true
  throw-particle: SPELL_WITCH
  teleport-particle: PORTAL

cooldown-visualizer:
  xp-bar: true
  xp-level: true

physics:
  enabled: true
  velocity-multiplier: 1.2
  gravity-modifier: 0.02
  hitbox-size: 0.25

cosmetics:
  enabled: true
  trails:
    'aerospearls.trail.flame': 'MOBSPAWNER_FLAMES'
    'aerospearls.trail.heart': 'HEART'
  sounds:
    'aerospearls.sound.dragon': 'ENTITY_ENDER_DRAGON_GROWL'

lag-compensation:
  enabled: true
  minimum-tps: 17.5

visualizer:
  enabled: true
  effect-radius: 32

Key Sections

Cooldowns & Damage

pearl-cooldown: Cooldown in seconds between pearl throws.
join-pearl-cooldown: Cooldown applied when a player joins the server to prevent immediate pearl rush tactics.
world-change-pearl-cooldown: Cooldown applied after switching worlds.
pearl-damage-self: Damage in half-hearts dealt to the thrower (set to 0 to disable self-damage).

Pass-Through & Options

through.pearlPassThroughBlocks: List of blocks that pearls can pass through if sufficient free space exists.
options.refund-on-void: Automatically refunds pearls if thrown into the void (Y < 0).
options.cancel-pearl-on-death: Cancels in-flight pearls if the thrower dies before landing.