[20% OFF] ✨ProgressiveUnlock ✨ [Folia] [GUI] [SQL] [CUSTOM ITEMS] [INGAME CONFIG EDITOR]

[20% OFF] ✨ProgressiveUnlock ✨ [Folia] [GUI] [SQL] [CUSTOM ITEMS] [INGAME CONFIG EDITOR] -----

Set specific requirements for most actions and make game more difficult for your players

Download Now
218.8 KB .jar

Smelting checker

Plugin can now check if smelting result is unlocked

Code (YAML):

onSmelt:
check : true
sendMessage : true
survivalModeOnly : false

----------, Yesterday at 6:55 PM

Smelt unlock check

Plugin can now check if smelting result is unlocked

----------, Yesterday at 6:47 PM

Advancements rewards!

Players can now get xp reward for advancements completions!

List of all advancements:

story/root - Minecraft - Start of the game
story/mine_stone - Stone Age - Mine stone with your new pickaxe
story/upgrade_tools - Getting an Upgrade - Construct a better pickaxe
story/smelt_iron - Acquire Hardware - Smelt an iron ingot
story/obtain_armor - Suit Up - Protect yourself with a piece of iron armor
story/lava_bucket - Hot Stuff - Fill a bucket with lava
story/iron_tools - Isn’t It Iron Pick - Make an iron pickaxe
story/deflect_arrow - Not Today, Thank You - Deflect an arrow with a shield
story/form_obsidian - Ice Bucket Challenge - Obtain obsidian
story/mine_diamond - Diamonds! - Acquire diamonds
story/enter_the_nether - We Need to Go Deeper - Build, light, and enter a Nether portal
story/shiny_gear - Cover Me with Diamonds - Diamond armor saves lives
story/enchant_item - Enchanter - Enchant an item at an Enchanting Table
story/cure_zombie_villager - Zombie Doctor - Cure a zombie villager
story/follow_ender_eye - Eye Spy - Follow an Eye of Ender
story/enter_the_end - The End? - Enter the End dimension

nether/root - Nether - Bring summer clothes
nether/return_to_sender - Return to Sender - Destroy a Ghast with its own fireball
nether/find_bastion - Those Were the Days - Enter a Bastion Remnant
nether/obtain_ancient_debris - Hidden in the Depths - Obtain ancient debris
nether/fast_travel - Subspace Bubble - Use the Nether to travel 7 km in the Overworld
nether/find_fortress - A Terrible Fortress - Break your way into a Nether Fortress
nether/obtain_crying_obsidian - Who is Cutting Onions? - Obtain crying obsidian
nether/distract_piglin - Oh Shiny - Distract Piglins with gold
nether/ride_strider - This Boat Has Legs - Ride a Strider with a Warped Fungus on a Stick
nether/uneasy_alliance - Uneasy Alliance - Rescue a Ghast from the Nether and kill it in the Overworld
nether/use_lodestone - Country Lode, Take Me Home - Use a Lodestone to locate a target
nether/netherite_armor - Cover Me in Debris - Get a full suit of Netherite armor
nether/explore_nether - Hot Tourist Destinations - Explore all Nether biomes
nether/summon_wither - Spooky Scary Skeleton - Summon the Wither
nether/brew_potion - Local Brewery - Brew a potion
nether/create_beacon - Bring Home the Beacon - Construct and place a beacon
nether/all_potions - A Furious Cocktail - Have every potion effect applied
nether/all_effects - How Did We Get Here? - Have every effect applied at the same time

end/root - The End - Enter the End
end/kill_dragon - Free the End - Kill the Ender Dragon
end/dragon_egg - The Next Generation - Hold the Dragon Egg
end/enter_end_gateway - Remote Getaway - Escape the End island using an End Gateway
end/find_end_city - The City at the End of the Game - Find an End City
end/elytra - Sky’s the Limit - Find Elytra
end/respawn_dragon - The End... Again... - Respawn the Ender Dragon

adventure/root - Adventure - Adventure time!
adventure/voluntary_exile - Voluntary Exile - Kill a raid captain
adventure/kill_a_mob - Monster Hunter - Kill any hostile monster
adventure/trade - What a Deal! - Successfully trade with a Villager
adventure/honey_block_slide - Sticky Situation - Slide down a honey block
adventure/ol_betsy - Ol’ Betsy - Shoot a crossbow
adventure/sleep_in_bed - Sweet Dreams - Sleep in a bed to change your respawn point
adventure/hero_of_the_village - Hero of the Village - Successfully defend a village from a raid
adventure/throw_trident - A Throwaway Joke - Throw a trident
adventure/shoot_arrow - Take Aim - Shoot something with a bow and arrow
adventure/kill_all_mobs - Monsters Hunted - Kill one of every hostile monster
adventure/totem_of_undying - Postmortal - Use a Totem of Undying to cheat death
adventure/summon_iron_golem - Hired Help - Summon an Iron Golem to help defend a village
adventure/two_birds_one_arrow - Two Birds, One Arrow - Kill two Phantoms with one arrow
adventure/whos_the_pillager_now - Who’s the Pillager Now? - Give a Pillager a taste of their own medicine
adventure/arbalistic - Arbalistic - Kill five different mobs with one crossbow shot
adventure/adventuring_time - Adventuring Time - Discover every Overworld biome
adventure/very_very_frightening - Very Very Frightening - Strike a Villager with lightning
adventure/sniper_duel - Sniper Duel - Kill a Skeleton from at least 50 meters away
adventure/bullseye - Bullseye - Hit the bullseye of a Target block from at least 30 meters away

xpMode.yml:

Code (Text):

xpRewards:
default: # default amount for unspecified blocks/entities
breakBlock: 1
placeBlock: 1
killMob: 10
tradeWithVillager: 5
craftItem: 2
# rules of specific items, mobs, blocks..
specific:
blocks: # block breaking
EMERALD_ORE: 20
DIAMOND_ORE: 30
GOLD_ORE: 15
IRON_ORE: 10
COAL_ORE: 5
ANCIENT_DEBRIS: 40
mobs: # mob killing
SKELETON: 12
CREEPER: 30
ENDERMAN: 30
WITHER: 100
ENDER_DRAGON: 400
trades: # trading with villagers with specific profession
FARMER: 10
LIBRARIAN: 15
WEAPONSMITH: 20
crafting: # item crafting
BEACON: 100
ENCHANTING_TABLE: 50
GOLDEN_APPLE: 20
TOTEM_OF_UNDYING: 150
advancements:
end/root:
reward: 100
message: "%prefix% &d You received %xp% XP for reaching the End!"
nether/root:
reward: 75
message: "%prefix% &c You received %xp% XP for entering the Nether!"
end/kill_dragon:
reward: 200
message: "%prefix% &6 You received %xp% XP for defeating the Ender Dragon!"
story/mine_diamond:
reward: 30
message: "%prefix% &6You just received %xp% XP for mining your first diamonds!"
story/iron_tools:
reward: 40
message: "%prefix% &You got your first iron tools! enjoy extra %xp% XP"

- Improved VIP groups for increased multiplier.
config.yml:

Code (Text):

Groups:
MiniVIP:
name: MiniVIP
multiplier: 1.2 # XP multiplier
VIP:
name: VIP group
multiplier: 1.5 # XP multiplier
VIP+:
name: VIP group
multiplier: 1.8 # XP multiplier
MegaVIP:
name: MegaVIP group
multiplier: 1 # XP multiplier

----------, Oct 26, 2025

Player head in unlockmenu, /pu reload command and bugfix

- fixed default example xpmode.yml files - there was invalid yaml
- added command /pu reload that reloads all configuration files.
- Added new config values and player head into /unlockmenu

Code (Text):

settings:
menu:
# Inventory positions in /unlockmenu.
# Keep values between 45 and 53.
positions:
filters: 50
search: 48
head: 49
arrow-previous: 45
arrow-next: 53

----------, Aug 27, 2025

Changelog colors

- /pu changelog now shows versions colored - color is based on importance.

----------, Aug 1, 2025

Added profile head, added menu positions into config.

- Added profile head into unlockmenu
- Added new config entry - slot positions of filters, search and head in /unlockmenu
- improved performance

----------, Jul 29, 2025

Improved performance

- code optimalization
- if you switch from xp to farming, you will get warning about broken player data instead of error.

----------, Jul 2, 2025

Removed forgotten debug message from console.

----------, Jun 28, 2025

hotfix

Removed forgotten debug message from console.

----------, Jun 28, 2025

ProgressiveQuest support!

Compatibility with new addon https://www.spigotmc.org/resources/progressivequests.126446/

----------, Jun 28, 2025

ingame config editor improvements

You are now able to edit level requirement for existing item
fixed bug that caused some values to stay hard-coded
Removed non-needed files from jar

----------, Jun 21, 2025

Ingame editor

- Added new command /pu configure. This will enable admin mode and allows player to click on any item in inventory to show information about item and set requirement directly from game! Supports both materials and custom items and doesn't require server restart!

Requires permission progressiveunlock,configure

- All config messages now supports {prefix} and prefix is editable in config.
- Added missing trident, gravel and iron_armor into example configs

----------, Jun 14, 2025

Ingame settings with GUI!

Added new command /pu configure. This will enable admin mode and allows player to click on any item in inventory to show information about item and set requirement directly from game! Supports both materials and custom items and doesn't require server restart!

Requires permission progressiveunlock,configure

----------, Jun 14, 2025

Commands!

Added admin commands!
these commands can only be used with permission progressiveunlock.admin

----------, Jun 8, 2025

Custom items update, bugfix, added support for xp below 1 (eg. 0.5)

- Custom items are now shown in /unlockmenu and in search results. You can search for them by material and name.
- Converted XP from int to float. It means you are now allowed to use values below 1 in XP rewards - for example 0.5. Database column will be updated automatically, please check log if everything changed correctly.
- Improved fetch check from database to ensure data are always loaded correctly.
- fixed mysql bug
- added automatic function to migrate from mysql to yml if database is disabled in config.

----------, May 30, 2025

Max HP limit

Added possibility to limit max HP for every level.
If no max defined, using default value 20.
1 HP = 0.5 heart
See xpmode.yml and farmingmode.yml

----------, May 26, 2025

Custom items!

Added custom items!
You can now define requirements for specific items based on their name and lore. By default, all items are unlocked. If you want to restrict access to specific custom items, simply define them here.
This works with any custom items created by any plugin, as long as they are defined correctly.
Enjoy!

Code (YAML):

items:
exampleItem : #Any unique ID. No spaces, no special characters, only numbers and letters.
material : WOODEN_PICKAXE
name : "&bExample item" #Ingame name of item ingame. Without _ and |
lore : "&aThis is example item with requirement" #Ingame name of item ingame. Without _ and |
lockedUntil : "level3" #Name of level or pack where item is unlocked.
# Test this item ingame!
# /give <player> wooden_pickaxe 1 name:&bExample_item lore:&aThis_is_example_item_with_requirement

----------, May 25, 2025

Config variables update

Fixed a bug where stripped logs and woods were missing in the "LOGS" and "PLANKS" config variables.
Added advanced logic to also check unlocked items by name and compare them to config variables — improving support for custom items.

----------, May 25, 2025

MYSQL SUPPORT!

Added MYSQL support!
Some code refactors to make code better editable to the future

config:

Code (YAML):

storage:
database:
useMysql : false
host : localhost
port : 3306
name : mc
user : root
password : ''

----------, May 18, 2025

Unlockmenu GUI filters!

Players are now able to filter shown items in /unlockmenu. They may select if they want to see craftables, blocks and materials. This function can be find under /unlockmenu - hopper next to the search sign. These filters don't affect search results

----------, May 16, 2025

Code improvement

Improved code quality

----------, May 15, 2025

Added example configs, new config variables

Added 3 example xp configs into jar. They will be added into folder of plugin automatically - also available on wiki: http://lupecz.eu/progressiveUnlock/?page=example-configs
New config variables!
COOKEDMEAT, RAWMEAT, PRESSURE_PLATES, BUTTONS, COPPER_BLOCKS, CROPS, FLOWERS, CORALS, BUNDLES, BOATS, FIREWORKS, RAILS, SAPLINGS, WALLS

----------, May 15, 2025

Folia support, added teleport check for end and nether

Added support for Folia
Added check if world is unlocked on teleport - for example, if player uses /tpa to someone who is in the end/nether

----------, May 12, 2025

Updater update

Updater now checks for importance of update.
Created wiki! http://lupecz.eu/progressiveUnlock/

----------, May 11, 2025

Updater update, new placeholder

- Updated updater to check for updates more often

Code (YAML):

update:
check_interval_minutes : 180 #how often should plugin check for updates?

- fixed minor bug that caused value with typo to be generated inside xpmode.yml after every load.

- adeed new placeHolder %progressiveunlock_requiredxp% - XP needed to next level

----------, May 10, 2025

Updater update

- Updated updater to check for updates more often

Code (YAML):

update:
check_interval_minutes : 180 #how often should plugin check for updates?

- fixed minor bug that caused value with typo to be generated inside xpmode.yml after every load.

- adeed new placeHolder %progressiveunlock_requiredxp% - XP needed to next level

----------, May 10, 2025

Performance updated

- improved performance

----------, May 10, 2025

PlaceHolderAPi, check on pickup, bugfix

- PlaceHolderAPI Support! We now support two variables:
%progressiveunlock_xp%
%progressiveunlock_level%

Fixed a bug that could cause XP to reset when using the unsafe /reload command — we still recommend avoiding the use of reload!

Added a new check for item pickup.

config.yml:

Code (Text):

onPickup:
check: true
sendMessage: true
survivalModeOnly: false

Code (Text):

blockLockedPickup: '&cYou are not allowed to pickup items that are not unlocked!'

----------, May 10, 2025

Added 1.21.5 support

Added support for 1.21.5
Removed support for versions below 1.19.
Updated to-do list om spigot

----------, May 9, 2025

We are blocking new actions!

Added the ability to disable feeding animals, shearing sheep, and trading with villagers.

XPMode and FarmingMode:
entities_actions:

shear
villagerTrades

Available options:

shear - sheep shearing
villagerTrades - trading with villagers
mobFeed - feeding mobs (e.g., sheepFeed, chickenFeed, etc., can be used to allow only specific mobs).
- mobFeed is a parent setting that allows player to feed all mobs.

config.yml:
Added under "checkUnlocked":

Code (Text):

onEntityActions:
check: true
sendMessage: true
survivalModeOnly: false

Additionally, added in messages:

Code (Text):

messages:
entity_action_not_allowed: '&cYou are not allowed to do this.'

Plan for the next release:

Ability to disable fishing, horse riding, boat usage, and minecart usage.

Planned for future releases (not the next one):

Ability to disable certain enchantments if the player does not have sufficient progress.
GUI for in-game settings.
Ability to set progress based on permission groups.

Versioning changes:

4.0.0 - Major version, significant changes, big feature additions.
4.1.0 - Medium adjustments, new features related to existing ones.
4.0.1 - Minor changes.

----------, Feb 8, 2025

Code improvement

Improved updater code

----------, Jan 10, 2025

Potions

Plugin can now check if player unlocked specific potion on consume.
Compatible with debug.

Config changes:
config.yml:
messages.potionLocked: '&cThis potion is locked!'

Code (YAML):

onPotion:
check : true
sendMessage : true

xpmode.yml (also supported by farmingmode.yml)

Code (YAML):

level3:
needed_xp : 300
items :
- IRON_ARMOR
- IRON_TOOLS
- IRON_SWORD
- BOW
- BLAZE_POWDER
- BEACON
- GOLDEN_TOOLS
- GOLD_INGOT
- GOLD_BLOCK
potions :
- weakness
- healing

----------, Jan 10, 2025

Added portal support, run command on unlock

ProgressiveUnlock can now check if a player has unlocked portals. To allow portal use, add 'NETHER_PORTAL' and 'END_PORTAL.' This is also configurable in config.
ProgressiveUnlock can now run commands when a player reaches a new level or unlocks a new pack. You can reward players with prizes, kits, or even add them to permission groups or grant specific permissions! This is configurable for each level or pack individually."

----------, Oct 22, 2024

New config value

Added new value in xpmode.yml - options.gainXPInCreative

----------, Oct 14, 2024

Compatibility with Public Crafting Tables

Plugin is now fully compatible and tested with Public Crafting tables. https://www.spigotmc.org/resources/public-crafting-tables.50686/

----------, Oct 14, 2024

Added DEBUG mode to make setting up the plugin easier.

Added DEBUG mode to make setting up the plugin easier. You can enable debug mode in the config . Debug mode should only be used for testing and configuring the plugin. If any action is blocked, debug mode will tell you the reason and how to fix it. Simply enable debug and try playing as a normal player for a while—the plugin will provide instructions. Please disable debug mode once you're done. OP is required, and if "survival mode only" is enabled for specific actions, you must also be in survival mode.

----------, Oct 12, 2024

Added DEBUG mode to make setting up the plugin easier.

Added DEBUG mode to make setting up the plugin easier. You can enable debug mode in the config. Debug mode should only be used for testing and configuring the plugin. If any action is blocked, debug mode will tell you the reason and how to fix it. Simply enable debug and try playing as a normal player for a while - the plugin will provide instructions. Please disable debug mode once you're done. OP is required, and if "survival mode only" is enabled for specific actions, you must also be in survival mode.

----------, Oct 12, 2024

Projectile checker

Plugin can now check if projectiles - eggs, snowballs, arrows, tridents, xpbottles and enderpearls are unlocked and can block them.

----------, Oct 9, 2024

Armor checker, new variable Leaves

Added variable Leaves
Plugin can now check if armor is unlocked and prevent equip.

----------, Oct 8, 2024

Sword prevention, updater improvements

Interact value from config now affects swords too.
Improved updater

----------, Oct 3, 2024

Survival Mode checker, bugfix

Added a Survival Mode checker. Placing, breaking, and interacting can now be blocked exclusively in Survival mode.

Fixed a broken config auto-updater. New values should be added automatically, but to ensure everything is correct, check the example from Spigot and compare it.

----------, Oct 2, 2024

Survival Mode checker, bugfix

Added a Survival Mode checker. Placing, breaking, and interacting can now be blocked exclusively in Survival mode.

Fixed a broken config auto-updater. New values should be added automatically, but to ensure everything is correct, check the example from Spigot and compare it.

----------, Oct 2, 2024

Place, interact and break prevention

The plugin can now check if a player has unlocked the block they are mining or placing, or the tool they are currently using. This check can be done with or without sending a message to the player. Fully configurable in config!

Added new config values and messages for these functions.

Added new variables: DIRTS and LOGS.

----------, Sep 30, 2024

bugfix

Fixed a bug that caused the crafting book to trigger the message 'recipe locked' even when the recipe was already unlocked.

----------, Sep 29, 2024

Improved update checker

Improved the update checker. It now checks for updates faster and also shows how many versions behind you are.

----------, Sep 28, 2024

Update checker, new variables

Added new variables:

STAIRS
SLABS
DOORS
FENCES
GLASS_PANES
BANNERS
SIGNS

Update Checker:

Added an update checker. There is no auto-updater yet for security reasons, but you will receive a notification if a new version is available. All configurations will be automatically updated with new entries if any are added after you download the new version of the plugin! [IMG]

New config value (xpmode.yaml)

options.allowUnlimitedXP - allow/disable XP on max level

----------, Sep 28, 2024

Major update

- Fixed duplicate messages. We can now handle packets to detect the use of the crafting book. However, this update now requires ProtocolLib, so make sure to download it.
- Fixed missing colors in some messages.
- Added new messages to the config.
- Fixed the "unlimited levels" issue and added a check for the max level — players will still earn XP even if they are at the max level.
- Added player names to playerData. We recommend resetting playerData.
- removed forgotten debug messages from console
- Major changes in config

Make sure to update your files!

An auto-updater will be released tomorrow!

----------, Sep 27, 2024

Config aliases

- Added command aliases into config

----------, Sep 23, 2024

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 17

First Release: Sep 22, 2024

Last Update: Yesterday at 6:55 PM

Category: ---------------