First Setup

Once AerosPearls is installed and your license is verified, you can tailor the plugin to your server's playstyle.

Initial Configuration Overview

By default, AerosPearls comes pre-configured with balanced settings suited for competitive PvP:

• Cooldown: 0.5s default throw cooldown.
• Damage: 5.0 hearts damage to self, 2.0 to others.
• Fall Damage: Disabled on pearl land (disable-fall-damage: true).
• Pass Through: Slabs, fence gates, ladders, and iron bars can be passed through safely when free space is present.
• Cooldown Visualizer: Dynamic XP bar drain and actionbar countdowns enabled.
• Trajectory Visualizer: Real-time particle arc prediction enabled.

Common Server Profiles

1. Hardcore Factions (HCF)

• Lower pearl damage or disable self-damage entirely (pearl-damage-self: 0).
• Set cooldown to 15.0s or 10.0s.
• Enable Anti-Glitch RayTracing (disable-pearl-inside-blocks: true) to prevent clipping into enemy bases.
• Enable lag-compensation to refund pearls if TPS drops below 17.5.

2. Practice / Duels

• Zero pearl damage (pearl-damage-self: 0).
• Quick cooldown (pearl-cooldown: 0.0 or 0.5).
• Boost velocity (velocity-multiplier: 1.2 or 1.3) to match classic 1.7/1.8 fast-paced combat.

3. Survival / RPG

• Enable MMO Pearls (/aerospearls give <player> swapper 16 or ghost 16).
• Set up permission-based rank cosmetics in Tebex or server store.