Introducing our Phantom Momentum which offers a unique experience for your server, making it more engaging and encourages player retention. This plugin offers unlimited customizability, from the messages, boosts, boss bar and much more. It’s coded with performance in mind and for big player bases, without compromising any player experience!
Example Default Configuration
Shown below if the default configuration you will generate upon a fresh install of Phantom Momentum, you can modify all the configurations below to your liking!
# This is the config file for PhantomMomentum
# Please put your license key inside of the LICENSE field ''.
# Join our discord to receive this key upon verifying - discord.gg/nWgTDTTYQt
LICENSE: 'YOUR-LICENSE-HERE'
Debug: true
Settings:
## This will generate a SQL database to store every player's momentum level if they have one, if they leave the server, their momentum level will be saved.
## This will also save data if the server crashes.
SaveMomentum:
Enabled: true
Scheduler:
Interval: 300 # ## This will save the data every 5 minutes. This is in seconds.
ListenerFilter:
## This will allow you to register certain listeners to save data, for example. If the player just quits, you can make it not save their data. However
## if the server crashes, it will save their data.
PluginDisable: true
PlayerQuit: true
DataRetention:
## If the player does not join the server within the specified time, their data will be deleted.
## If the player joins the server, the data will be saved again.
Enabled: true
Time: 1 # This is in minutes.
AllowedPickaxes:
- "DIAMOND_PICKAXE"
- "GOLDEN_PICKAXE"
- "IRON_PICKAXE"
- "STONE_PICKAXE"
- "WOODEN_PICKAXE"
BlacklistedWorlds:
- "EdPrivateMines"
- "gg"
- "example"
## Countdown delay is used to reset the momentum level if the player does not mine a block within the time specified.
MomentumResetCountdownDelay: 30
MaxMomentumLevels: 10
ProgressionDecrease: 25 ## IN PERCENTAGE! This will decrease the momentum level by 25% if the player does not mine a block within the time specified.
Bossbar:
Title: '&d&lMomentum &8| &a%blocks% &8/ &c%requiredBlocks% &8| &dReward: %reward%'
Color: 'GREEN'
Style: 'SOLID'
Title:
Levelup:
TogglePermission: 'momentum.title.levelup' ## This will allow you to make a command to toggle the title with this permission
Title: '&a&lLevel Up!'
Subtitle: '&7You are now level &a%level%&7!'
FadeIn: 20
Stay: 60
FadeOut: 20
MomentumDecrease:
TogglePermission: 'momentum.title.decrease' ## This will allow you to make a command to toggle the title with this permission
Title: '&c&lMomentum Decreased!'
Subtitle: '&7You have not mined a block in %time% seconds!'
FadeIn: 20
Stay: 60
FadeOut: 20
## Each reward will be parsed as %reward%, and each boost is seperate. Meaning the previous boost will not be added to the next one.
MomentumLevels:
0:
BlocksRequired: 200
RewardText: "&eToken &6Boost &8(&7+1%&8)" ## This will be parsed as %reward%
Boosts:
- 'edprison-tokens:0.01'
1:
BlocksRequired: 400
RewardText: "&eToken &6Boost &8(&7+5%&8)" ## This will be parsed as %reward%
Boosts:
- 'edprison-tokens:0.05'
2:
BlocksRequired: 800
RewardText: "&eToken &6Boost &8(&7+10%&8)" ## This will be parsed as %reward%
Boosts:
- 'edprison-tokens:0.10'
3:
BlocksRequired: 1600
RewardText: "&eToken &6Boost &8(&7+15%&8)" ## This will be parsed as %reward%
Boosts:
- 'edprison-tokens:0.15'
4:
BlocksRequired: 3400
RewardText: "&eToken &6Boost &8(&7+20%&8)" ## This will be parsed as %reward%
Boosts:
- 'edprison-tokens:0.20'
5:
BlocksRequired: 4800
RewardText: "&eToken &6Boost &8(&7+25%&8)" ## This will be parsed as %reward%
Boosts:
- 'edprison-tokens:0.25'
Messages:
Prefix: "&d&lPhantom&5&lMomentum &8» "
MOMENTUM_LEVELUP:
Sound:
Enable: true
Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
Message:
Enable: true
Value: '&2&lLevel up! &aYou are now level &f%level%&a!'
RELOAD:
Sound:
Enable: true
Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
Message:
Enable: true
Value: '&2Success! &aThe plugin has been reloaded!'
RESET_PLAYER:
Sound:
Enable: true
Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
Message:
Enable: true
Value: '&2Success! &aYou have reset &f%player%&''s &amomentum level!'
SET_PLAYER_LEVEL:
Sound:
Enable: true
Value: ENTITY_PLAYER_LEVELUP;1.0;1.0
Message:
Enable: true
Value: '&2Success! &aYou have set &f%player%&''s &amomentum level to &f%level%&a!'
Placeholders
Bossbar:
-> %blocks% | Current blocks mined
-> %requiredBlocks% | Blocks required for next level
-> %reward% | Reward Display Text
Bossbar Title:
-> %time% | Returns how much time the user hasn't been mining for
-> %level% | Returns the level reached upon levelling up
Messages:
-> %player% | Returns the player's IGN
-> %level% | Returns the level reached when levelling up or if set to via commands.
Features
Performance friendly
Supports 1.8 - 1.21.1
Hex Color support (#4493fe) and legacy support (&6Example)
Entirely configurable
Endless momentum levels and configurable rewards
Reload - Instantly flushes cache, and re-caches momentum boosts, ensuring they're applied to all players
Data Retention - This lets you decide if you want to clear momentum after x time
Listener Filter - You can easily filter if you want a player to lose momentum on crash or logout.
Momentum Decreaser - Will slowly decrease players momentum progress after x time
