Skip to content

XP rules ​

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

Phantom XP rules for a Discord server, including per-message XP and voice XP ratesLevelling → XP Settings.

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.