Progression
Player levels, daily and weekly quests and achievements, all earned by playing normally.
The Progression module gives your players goals. Everything they do on the server (mining, fighting, fishing, walking, playing) earns them XP and levels, moves their quests forward and unlocks achievements. You decide what each activity is worth and what players win along the way.
This module requires the complete edition. See editions.
Features
- Levels. Players earn XP from their activities and climb levels on a curve you control. Each level up shows a title on screen with a sound, and you can announce milestones to the whole server.
- Level rewards. Give money and run commands when a player reaches a chosen level.
- Daily and weekly quests. Each player gets a random selection of quests from your lists, up to 7 per period. Daily quests reset at midnight, weekly quests reset on Monday. A player gets the same quests on every server of your network.
- Achievements. Permanent goals with a name and an icon, such as "Break 1,000 blocks" or "Reach level 50". You can announce each unlock to everyone.
- Rewards for every goal. Quests and achievements can give XP, money in any currency and console commands.
- Action bar feedback. Players see the XP they just earned and their quest progress above the hotbar.
- Lifetime statistics. Every tracked activity is also counted for life, so you can rank players by it in leaderboards.
- Anti farm protection. Common XP farms are filtered out. The details are under Tips below.
Tracked activities:
| Activity | Counted |
|---|---|
| Break blocks | per block (crops only when fully grown) |
| Place blocks | per block |
| Defeat mobs | per mob (mobs from spawners do not count) |
| Defeat players | per player |
| Fish | per catch |
| Craft | per item crafted |
| Eat | per meal |
| Walk | per block walked |
| Playtime | per active minute (AFK time does not count) |
| Chat | per message |
| Breed animals | per birth |
| Enchant | per item enchanted |
| Trade with villagers | per trade |
| Daily reward | per claim of the daily reward |
| Reach a level | achievements only |
Setting it up
Open the Progression module in the web editor. The Editor tab has three sections: Levels, Quests and Achievements. The Settings tab holds the switches and tracking options.
Levels
In Level curve, set:
- XP for the first level: the XP needed to go from level 1 to level 2. Default: 100.
- Multiplier per level: each next level needs this many times the XP of the previous one. Default: 1.15.
- Maximum level: default 100, up to 1000.
The editor draws the curve and tells you how much XP the maximum level takes in total.
In XP sources, set how much XP each activity gives. Use 0 to give nothing.
| Activity | Default XP |
|---|---|
| Break blocks | 1 per block |
| Place blocks | 0 |
| Defeat mobs | 4 per mob |
| Defeat players | 15 per player |
| Fish | 6 per catch |
| Craft | 0.5 per item |
| Eat | 1 per meal |
| Walk | 0.02 per block |
| Playtime | 5 per active minute |
| Chat | 0 |
| Breed animals | 3 per birth |
| Enchant | 10 per enchant |
| Trade with villagers | 4 per trade |
| Daily reward | 50 per claim |
In Level rewards, click Add a milestone to give money (in the currency of your choice) and run commands when a player reaches a level. By default players get money at levels 5, 10, 25, 50 and 100. Commands are typed one per line and run from the console; {player} is replaced by the player name.
The Top players list shows your 10 players with the most XP.
Quests
Build two lists: Daily quests and Weekly quests. Next to each list, Per player sets how many quests each player receives per period (0 to 7). If a list has fewer quests than that number, players get all of them.
Each quest card has:
- Icon and ID. The ID must be unique in its list.
- Name. Leave it empty to use an automatic description, such as "Break 64 stone", shown in the language of each player.
- Activity and Amount: what the player has to do and how many times.
- Targets, for activities that have one (blocks, items, mobs, animals). Add targets to narrow the quest down, for example only diamond ore. Without targets, anything counts.
- Rewards: XP, money with its currency, and commands.
The badge on each card shows how many players finished it during the current period.
Achievements
Achievements work like quests, but they are permanent and every player has all of them. They can also use the Reach a level activity. The badge shows how many players unlocked each one.
Settings tab
| Setting | What it does | Default |
|---|---|---|
| Levels enabled | Turns levels and XP on or off. | On |
| XP for the first level | Same as in the editor. | 100 |
| Difficulty growth | Same as the multiplier per level. | 1.15 |
| Maximum level | Same as in the editor. | 100 |
| XP gained in the action bar | Shows the XP earned and a progress bar above the hotbar. | On |
| Announce every X levels | Tells all players when someone reaches a multiple of this level. 0 to never announce. | 10 |
| Quests enabled | Turns daily and weekly quests on or off. | On |
| Daily quests per player | Same as Per player in the editor. | 3 |
| Weekly quests per player | Same as Per player in the editor. | 3 |
| Progress in the action bar | Shows quest progress above the hotbar. | On |
| Time zone | When daily and weekly quests reset, for example Europe/Paris or America/Montreal. Empty uses the server time zone. |
Empty |
| Achievements enabled | Turns achievements on or off. | On |
| Announce achievements to everyone | Tells all players when someone unlocks an achievement. | On |
| Ignore creative and spectator modes | Only survival and adventure count. | On |
| Ignore blocks placed by players | Breaking a block a player placed earns nothing. Fully grown crops still count. | On |
| Worlds without progression | Nothing is tracked in these worlds. | Empty |
Commands
| Command | What it does | Permission |
|---|---|---|
/quests (also /quest, /missions) |
Opens the quests menu: level, daily quests, weekly quests and a button to the achievements. | inglis.progress.quests (everyone) |
/achievements (also /achievement, /ach) |
Opens the achievements menu. | inglis.progress.achievements (everyone) |
/level [player] (also /lvl, /xp) |
Shows your level and XP, or those of another online player. | inglis.progress.level (everyone) |
/level give <player> <amount> |
Gives XP to an online player. | inglis.progress.admin (operators) |
Placeholders
| Placeholder | Shows |
|---|---|
%ingliscore_level% |
Current level |
%ingliscore_level_xp% |
XP earned inside the current level |
%ingliscore_level_needed% |
XP needed to finish the current level |
%ingliscore_level_percent% |
Progress toward the next level, in percent |
%ingliscore_level_bar% |
A small colored progress bar |
%ingliscore_xp_total% |
Total XP |
%ingliscore_achievements_unlocked% |
Achievements unlocked by the player |
%ingliscore_achievements_total% |
Number of achievements on the server |
See placeholders for how to use them.
Tips
- In the menus module, the Automatic content of a slot can show the player level, a quests button, an achievements button, or a specific daily or weekly quest.
- The battle pass uses the same activities and gives pass XP for every finished quest.
- To keep progression fair, some activity is ignored: walking in vehicles, while flying, gliding, swimming or carried by water; fishing and walking when the player has not moved their view for 5 minutes or is AFK; chat messages shorter than 3 characters or sent less than 3 seconds apart; placing a block where the player broke one in the last 10 minutes; killing a player who shares the same IP, or the same player again within 10 minutes.
- Place blocks and Chat give no XP by default because they are easy to farm. Keep their value low if you turn them on.