Docs

Custom MMO Pearls

AerosPearls 2.0 introduces special custom pearl items with unique mechanics that elevate gameplay for Survival, Factions, RPG, and Minigame servers.

Available Pearl Types

1. Swapper Pearl (swapper)

  • Visuals: Purple displayName with custom lore.
  • Mechanic: When thrown, if the pearl strikes an enemy player, the thrower and the target instantly swap positions in the world.
  • Use Case: Perfect for pulling enemies off high ground, disorienting defenders during base raids, or setting up ambush combos in team fights.

2. Ghost Pearl (ghost)

  • Visuals: Dark grey/black displayName with stealth lore.
  • Mechanic: Travels completely silently, without any launch or landing sound effects, and with zero particle trails.
  • Use Case: Tactical stealth plays, sneaking into enemy territory, or escaping unnoticed during chaotic team fights.

Administration & Delivery

Administrators can give custom pearls to players using the command:

/aerospearls give <player> <swapper|ghost> [amount]

Permission

  • aerospearls.give: Allows running the /aerospearls give command.

Item Identification

Custom pearls are identified through persistent item metadata (aerospearls-pearl:<type>), ensuring they cannot be faked or duplicated through standard renaming in anvils.

Custom MMO Pearls | AerosPearls Docs