Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
Licensed Primly Documentation
Published 2 months ago
⚠️ This plugin is no longer being updated.
ChatXP
ChatXP is a Minecraft chat-leveling plugin that rewards players for active, non-spammy chat activity.
Features
- Leaderboard: Check who is the best
- Anti-Spam: Plugin block's xp gaining when spamming
- Reset: Can reset all players' xp weekly/monthly/yearly
- More features: Let's download it to see it's full potential
Commands & Permissions
| Command | Alias | Description | Permission |
|---|---|---|---|
/xpcheck |
/xpc |
Shows your current ChatXP level, XP, rank, and next-level progress | - |
/xpcheck <player> |
- | Shows another online player's ChatXP stats | chatxp.check.others |
/xptop |
/xpboard |
Shows the ChatXP leaderboard | - |
/xpcreload |
- | Reloads configuration | chatxp.reload |
Booster Permissions
When booster.enabled is true, ChatXP checks a player's effective permissions for the largest chatxp.booster.<value> multiplier.
| Permission | Result |
|---|---|
chatxp.booster.1.25 |
1.25x XP |
chatxp.booster.125 |
1.25x XP when booster.support-whole-number-percent is true |
chatxp.booster.15 |
1.5x XP when booster.support-whole-number-percent is true |
chatxp.booster.2 |
2x XP |
Placeholders
| Placeholder | Meaning |
|---|---|
%chatxp_xp% |
Player's current formatted XP |
%chatxp_xp_count% |
Same as %chatxp_xp% |
%chatxp_level% |
Player's current ChatXP level |
%chatxp_next_xp% |
Required XP threshold for the player's next level |
%chatxp_progress_percent% |
Player's progress percentage toward the next level |
%chatxp_rank% |
Player's leaderboard rank |
Configuration
config.yml
# ╔════════════════════════════════════════════════════════════════════╗
# ║ CHATXP PLUGIN CONFIG ║
# ║ Update: May 29, 2026 ║
# ╚════════════════════════════════════════════════════════════════════╝
# Internal version tracking - DO NOT CHANGE THIS VALUE
config-version: "2026+1.0.2"
# ╔════════════════════════════════════════════════════════════════════╗
# ║ GENERAL SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
# Displayed before all plugin messages in chat
Prefix: "&e&lChatXP &7"&r "
xp:
# Base XP every valid chat message gives
per-message: 8.0
# Additional XP per visible character in the message
per-character: 0.12
# Hard cap to avoid giant messages farming too much XP
max-per-message: 30.0
# Ignore small messages like "." or "ok"
min-message-length: 2
# Time between rewarded messages per player (in seconds)
cooldown-seconds: 3
anti-duplicate:
# If true, sending the exact same message twice in a row won't give XP
enabled: true
leveling:
# XP required for level 1 (from level 0)
base-xp: 100.0
# Every next level multiplies required XP by this amount
growth-multiplier: 1.18
# Safety cap
max-level: 500
# Run console commands when players reach specific ChatXP levels
# Supported placeholders: %player%, %uuid%, %level%
rewards:
5:
- "give %player% diamond 1"
10:
- "lp user %player% permission set chat.color"
reset:
# If true, all saved ChatXP XP and levels reset when a new cooldown period starts
enable: false
# Valid cooldown values: daily, monthly, yearly
cooldown: monthly
booster:
enabled: true
# If true, permission suffix of 125 is interpreted as 1.25x
support-whole-number-percent: true
format:
# Simple formatter for decimal values in chat messages
decimals: 2
leaderboard:
# How many players to show with /xptop
default-size: 10
messages:
xpcheck-self: "&fLevel: &d%level% &7| &fXP: &d%xp%&7/&d%next_xp% &7| &fRank: &d#%rank% &7| &fProgress: &d%progress%%"
xpcheck-other: "&d%player% &f- Level: &d%level% &7| &fXP: &f%xp%&7/&f%next_xp% &7| &fRank: &d#%rank% &7| &fProgress: &d%progress%%"
xptop-header: "&dChatXP Leaderboard &7(Top %size%)"
xptop-line: "&7#%place% &d%player% &7- &fLvl: &d%level% &7| &fXP: &d%xp%"
xptop-empty: "&7No player chat data found yet."
no-permission: "&cYou don't have permission to use this command!"
player-not-found: "&cThat player is not online right now!"
level-up-broadcast: "&d%player% &fhas reached chat level &d%level%&f!"
level-up-personal: "&dLevel up! &fYou are now chat level &d%level%&e."
Note: This plugin is AI optimized but wont ever be rewritten by it or dramatically changed. Because sometimes bug/problem appears and I don't know everything, help is needed.