A feature-rich Minecraft plugin that introduces player levels based on statistics tracking for Paper 1.21.3.<\/p>\n
## Features<\/p>\n
### Core Features<\/p>\n
– **Dynamic Leveling**: Players gain levels as they play based on their in-game statistics
\n – **Balanced Scaling**: Higher levels require exponentially more XP
\n – **Configurable Stats**: Server owners choose which stats affect leveling
\n – **Level Rewards**: Automatically reward players when they reach certain levels
\n – **PlaceholderAPI Integration**: Use player level information in other plugins
\n – **Leaderboard**: View top players by level with pagination<\/p>\n
### Enhanced Features (v2.0)<\/p>\n
– **Awards System**: Achievement-based rewards for milestones and ranks
\n – **Progress Bar**: Visual XP progress indicator with percentage
\n – **Level-Up Announcements**: Broadcast messages when players level up
\n – **XP Boost System**: Give players temporary XP multipliers
\n – **Rank Display**: See your server rank in `\/level` command
\n – **Database Support**: SQLite or MySQL storage options<\/p>\n
## Requirements<\/p>\n
– Paper 1.21.3 or newer
\n – PlaceholderAPI with Statistic Expansion
\n – Java 17+<\/p>\n
## Installation<\/p>\n
1. Download the plugin JAR from the releases page
\n2. Place the JAR in your server’s `plugins` folder
\n3. Restart your server
\n4. Make sure PlaceholderAPI is installed
\n5. Install the Statistic expansion: `\/papi ecloud download Statistic` and `\/papi reload`
\n6. Configure the plugin to your liking in `plugins\/PlayerLevels\/config.yml`<\/p>\n
## Configuration<\/p>\n
The plugin is highly configurable. Here’s a breakdown of the main configuration sections:<\/p>\n
### Basic Settings<\/p>\n
“`yaml
\nsettings:
\n\u00a0 enable-plugin: true
\n\u00a0\u00a0
\n\u00a0 # Level-up announcements
\n\u00a0 level-up-broadcast: true
\n\u00a0 level-up-message: “&6%player% &ehas reached &aLevel %level%&e!”
\n\u00a0\u00a0
\n\u00a0 levels:
\n\u00a0 \u00a0 base-xp: 100\u00a0 \u00a0 \u00a0 \u00a0# Base XP required for level 1
\n\u00a0 \u00a0 xp-multiplier: 1.5 # XP increase per level (exponential scaling)
\n“`<\/p>\n
### XP Boost System<\/p>\n
“`yaml
\nxp-boost:
\n\u00a0 multiplier: 2.0\u00a0 \u00a0 # XP multiplier when boost is active
\n“`<\/p>\n
### Statistics Configuration<\/p>\n
You can configure which statistics count towards player levels and how much XP they provide:<\/p>\n
“`yaml
\nstatistics:
\n\u00a0 1:
\n\u00a0 \u00a0 statistic: “MINE_BLOCK”
\n\u00a0 \u00a0 material: “STONE”
\n\u00a0 \u00a0 xp-value: 5\u00a0 \u00a0 \u00a0 # Gain 5 XP per stone mined
\n\u00a0 2:
\n\u00a0 \u00a0 statistic: “KILL_ENTITY”
\n\u00a0 \u00a0 entity: “ZOMBIE”
\n\u00a0 \u00a0 xp-value: 20\u00a0 \u00a0 \u00a0# Gain 20 XP per zombie killed
\n“`<\/p>\n
The `statistic` field should be a valid Minecraft statistic name. For statistics related to blocks, include the `material` field. For statistics related to entities, include the `entity` field.<\/p>\n
Negative XP values can be used to penalize certain actions (like deaths).<\/p>\n
### Level Rewards<\/p>\n
Configure rewards for reaching specific levels:<\/p>\n
“`yaml
\nrewards:
\n\u00a0 5:
\n\u00a0 \u00a0 commands:
\n\u00a0 \u00a0 \u00a0 – “give %player% diamond 1”
\n\u00a0 \u00a0 message: “&aYou reached Level 5! Enjoy a diamond!”
\n\u00a0 10:
\n\u00a0 \u00a0 commands:
\n\u00a0 \u00a0 \u00a0 – “give %player% diamond 5”
\n\u00a0 \u00a0 \u00a0 – “eco give %player% 1000”
\n\u00a0 \u00a0 message: “&eLevel 10! You got 5 diamonds and $1,000!”
\n“`<\/p>\n
### Awards System (New!)<\/p>\n
Create achievement awards that players can earn:<\/p>\n
“`yaml
\nawards:
\n\u00a0 level_10_pioneer:
\n\u00a0 \u00a0 display-name: “&6Level 10 Pioneer”
\n\u00a0 \u00a0 requirement: “level=10”
\n\u00a0 \u00a0 message: “&a\u2728 Achievement Unlocked: &6Level 10 Pioneer&a!”
\n\u00a0 \u00a0 commands:
\n\u00a0 \u00a0 \u00a0 – “give %player% golden_apple 3”
\n\u00a0 top_player:
\n\u00a0 \u00a0 display-name: “&e&l\u2b50 #1 Player”
\n\u00a0 \u00a0 requirement: “rank=1”
\n\u00a0 \u00a0 message: “&6&l\u2728 You’re #1! You earned the Top Player award!”
\n\u00a0 \u00a0 commands:
\n\u00a0 \u00a0 \u00a0 – “give %player% diamond_block 10”
\n“`<\/p>\n
Requirements can be:<\/p>\n
– `level=X` – Player must reach level X
\n – `rank=X` – Player must reach rank X or better<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | **Examples:**<\/p>\n – `\/level` – View your stats ## Placeholders<\/p>\n The plugin provides the following PlaceholderAPI placeholders:<\/p>\n ### Player Placeholders<\/p>\n – `%playerlevels_level%`: Player’s current level ### Leaderboard Placeholders<\/p>\n These placeholders work without player context, making them ideal for holographic displays:<\/p>\n – `%playerlevels_top_ ### Hologram Example<\/p>\n Using DecentHolograms or similar plugins:<\/p>\n “`yaml ### Scoreboard Example<\/p>\n “`yaml ## Storage<\/p>\n By default, the plugin uses SQLite for data storage. You can switch to MySQL by changing the configuration:<\/p>\n “`yaml ## Permissions<\/p>\n | Permission | Description | Default | A Minecraft plugin that introduces player levels based on statistics tracking<\/p>\n","protected":false},"featured_media":122743,"template":"","meta":{"_minecraft_slug":"playerlevel","_minecraft_project_id":"9fWC7PN5","_minecraft_author":"Flow2581","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":47,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playerlevel.zip","_minecraft_size_bytes":50356,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:20:21.453551Z","_minecraft_date_created":"2025-10-23T06:24:49.393672Z","_minecraft_date_modified":"2025-10-20T01:15:13.093401Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playerlevel","_minecraft_icon_attachment_id":122743,"_minecraft_imported_at":"2026-06-07T05:14:12+00:00","_minecraft_import_hash":"d3cc8df94e6c867ad9d45fddeb7348cc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,92],"mod_loader":[130,132],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-122742","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-utility","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/level` | View your current level, rank, and progress | `playerlevels.use` |
\n| `\/level
\n| `\/level awards [player]` | View your awards (or another player’s) | `playerlevels.use` |
\n| `\/level reload` | Reload the plugin configuration | `playerlevels.admin` |
\n| `\/level set
\n| `\/level boost
\n| `\/leveltop [limit] [page]` | Show the leaderboard of highest levels | `playerlevels.leaderboard` |<\/p>\n
\n – `\/level awards` – View your awards
\n – `\/level Steve` – View Steve’s stats
\n – `\/level boost Steve 60` – Give Steve 1 hour of 2x XP
\n – `\/leveltop` – Show top 10 players (page 1)
\n – `\/leveltop 20` – Show top 20 players (page 1)
\n – `\/leveltop 10 2` – Show top 10 players on page 2<\/p>\n
\n – `%playerlevels_xp%`: Player’s total XP points
\n – `%playerlevels_xp_needed%`: XP needed for next level
\n – `%playerlevels_progress%`: Visual progress bar with percentage
\n – `%playerlevels_rank%`: Player’s server rank
\n – `%playerlevels_awards%`: Number of awards earned<\/p>\n
\n – `%playerlevels_top_
\n – `%playerlevels_top_
\n – `%playerlevels_top_
\n – `%playerlevels_total_players%`: Total number of players in database<\/p>\n
\nlines:
\n\u00a0 – ‘&6&l\u2694 Top Players \u2694’
\n\u00a0 – ‘&e#1 &f%playerlevels_top_1_name% &7- &aLevel %playerlevels_top_1_level%’
\n\u00a0 – ‘&e#2 &f%playerlevels_top_2_name% &7- &aLevel %playerlevels_top_2_level%’
\n\u00a0 – ‘&e#3 &f%playerlevels_top_3_name% &7- &aLevel %playerlevels_top_3_level%’
\n\u00a0 – ”
\n\u00a0 – ‘&7Total Players: &f%playerlevels_total_players%’
\n“`<\/p>\n
\n# In your scoreboard plugin config
\nlines:
\n\u00a0 – ‘&6&lYour Stats’
\n\u00a0 – ‘&eLevel: &f%playerlevels_level%’
\n\u00a0 – ‘&eRank: &f#%playerlevels_rank%’
\n\u00a0 – ‘%playerlevels_progress%’
\n\u00a0 – ‘&eAwards: &f%playerlevels_awards%’
\n“`<\/p>\n
\nstorage:
\n\u00a0 type: “mysql”
\n\u00a0 mysql:
\n\u00a0 \u00a0 host: “localhost”
\n\u00a0 \u00a0 port: 3306
\n\u00a0 \u00a0 database: “minecraft”
\n\u00a0 \u00a0 username: “root”
\n\u00a0 \u00a0 password: “”
\n“`<\/p>\n
\n|————|————-|———|
\n| `playerlevels.use` | Allows checking own level | `true` |
\n| `playerlevels.<\/p>\n","protected":false},"excerpt":{"rendered":"