Cosmetics & Trails (Monetization)

AerosPearls includes a powerful cosmetic system designed to help server owners monetize their servers through store packages (Tebex, CraftingStore) by offering VIP particle trails and custom teleport sounds.

Permission-Based Cosmetics

Instead of forcing players into complex menus, cosmetics in AerosPearls can be granted instantly via permissions. When a player with the appropriate permission throws an ender pearl, the plugin automatically renders their custom trail and plays their custom landing sound.

Configuration

In config.yml:

yaml

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

Adding New Trails

You can map any valid Bukkit Effect particle name to any custom permission node. When a player has multiple permissions, the first matching permission in the list takes priority.

Examples:

aerospearls.trail.flame: Spawns blaze/mob spawner flame particles.
aerospearls.trail.heart: Spawns love heart particles.
aerospearls.trail.portal: Spawns purple Nether portal particles.
aerospearls.trail.witch: Spawns magic purple witch particles.

Adding New Teleport Sounds

Using the cross-version XSound library, sounds work seamlessly across 1.8 through 1.20+:

aerospearls.sound.dragon: Plays the ferocious ender dragon growl on landing.
aerospearls.sound.wither: Plays a wither spawn or shoot sound.
aerospearls.sound.levelup: Plays an experience level up chime.