Skip to content

XP rules

Configure message XP, voice XP, multipliers, and the announcement template.

Message XP

SettingDefaultWhat it does
Message XP min / max15 / 25Random XP per qualifying message.
Message cooldown (seconds)60Time between awards for the same member. Stops spam farming.
Min message length0Minimum chars before a message counts. Set to 5–10 to reward more substantive posts.

Voice XP

SettingDefaultWhat it does
Voice XP per minute5Earned per minute spent in voice.
Count mutedtrueMuted members still earn.
Count deafenedfalseDeafened don't earn (sleep VC).
Count alonefalseAlone-in-channel doesn't earn.

Voice XP is awarded once per minute, so you won't see it flow in real-time — it ticks up at the top of each minute.

Multipliers

Two kinds:

  • Channel multipliers — e.g. #trading-floor → 2x. Bonus for active business-end channels.
  • Role multipliers — e.g. @Booster → 1.5x. Reward server boosters.

Multipliers stack multiplicatively. Channel 2x + role 1.5x = 3x.

Server-wide multiplier

xp_multiplier (default 1.0) is a global multiplier applied to everything. Useful for "double XP weekends" — bump to 2.0 for the event, drop back to 1.0 after.

XP blacklist

A list of channels where messages don't earn XP. See XP blacklist — typically off-topic, spam, bot-command channels.

Announcements

  • Mode — off / channel / current / dm
  • Channel — when mode = channel
  • Message — the template (see overview for placeholders)
  • Auto-delete after (seconds)0 keeps the message; >0 deletes after that many seconds
  • Also DM — additionally DM the user even in channel mode

Role stack vs replace

Per-guild toggle: when a member levels up and earns a new level-role, do they:

  • Stack — keep all previously-earned level-roles (so a max-level member has every level-role)
  • Replace — only the highest currently-earned level-role sticks; lower ones get stripped

Default is stack. Tiered ladders (Bronze → Silver → Gold) typically want replace.

Reset on leave

  • false (default) — XP persists across leave/rejoin
  • true — leaving wipes their XP

For most servers, persistence is the right call (welcome-backers feel welcomed-back).

Permissions

  • levelling.view — see settings
  • levelling.edit — change anything on this page

Limits

  • Message XP min/max: 0–1000
  • Cooldown: 0–3600s
  • Voice XP per minute: 0–1000
  • Multipliers: 0.1–10.0
  • Level cap: 500

Phantom is a product of Hydra Labs. The bot is run as a managed service; you do not need to host it yourself.