Cosmetics

Cosmetics live in cosmetics.yml. They are free features. Prices are optional and only work when Vault plus an economy plugin is installed.

Global Settings

enabled: true
update-interval-ticks: 4
select-sound:
  enabled: true
  sound: ENTITY_EXPERIENCE_ORB_PICKUP
  volume: 1
  pitch: 1.4

Cosmetic Fields

blue-aura:
  enabled: true
  particle: DUST
  color: "#55ccff"
  size: 1.1
  animation: aura
  radius: 0.9
  spread: 0.025
  count-per-point: 2
  max-particles: 9
  permission: "atlaslobby.cosmetic.blue-aura"
  price: 0
  material: LIGHT_BLUE_DYE
  name: "&#55ccffBlue Aura"
  lore:
    - "&7Soft blue particles around you."

Supported Animations

aura
ring
spiral
double_helix
orbit
trail
burst
steps
crown
pulse
sphere
glyph
comet
vortex

Useful Options

Option	Purpose
`particle`	Bukkit particle name.
`animation`	Animation type.
`color`	Dust particle color.
`rainbow`	Animated rainbow dust.
`size`	Dust particle size.
`radius`	Animation radius.
`height`	Animation height.
`speed`	Rotation/update speed.
`bob`	Orbit vertical bob amount.
`pulse-size`	Pulse expansion amount.
`spread`	Particle spread.
`count-per-point`	Particles per calculated point.
`max-particles`	Per-player update particle budget.
`permission`	Cosmetic permission.
`price`	Optional Vault economy price.

Prices and Vault

If price is greater than zero, AtlasLobby checks Vault. If Vault or an economy provider is missing, the cosmetic cannot be purchased and a configurable message is shown.

Purchased cosmetics are stored in data/players.yml under unlocked-cosmetics.

Performance

AtlasLobby uses one shared repeating task for particles. It skips players with no selected cosmetic, players outside allowed worlds, players without permission, and players who disabled particles in data.