BattlePass Ultimate (Free version)

No new features. Fixes a reward duplication bug, season switching, and lag when opening the menu. Recommended for everyone running 2.2.4, and important if you use multi-server. Drop-in replacement: same config, same commands. Back up your database first, claimed rewards move to a new table (see the bottom). Rewards · The same reward could be claimed several times in multi-server mode by clicking fast. The claim is now confirmed by the database before the reward is given. · A reward could be lost if the player disconnected right as they claimed it: marked as claimed, never delivered. Now it stays claimable. · Crafting paid EXP for items the player never received when shift-clicking with a nearly full inventory. Seasons · Switching battlepass did not switch the data table. The plugin kept using the old season's table until a restart. · After a season change every reward looked already claimed. Claims are now tied to the specific battlepass, so a new season starts clean. · The end date could not be set from the editor, so auto-switch was impossible to configure in game. In Edit Dates: left click for the start date, right click for the end date. Performance · Opening the menu ran a database query for every line of text, on the main thread. On a menu with a dozen rewards that is over a hundred queries per open, and in multi-server mode it could visibly freeze the server. Everything loads in the background now. · SQLite no longer hits "database is locked" under load. Also fixed · The automatic backup zip contained no battlepass at all, it was looking in the wrong folder. Now includes your battlepasses, rewards and config.yml. · Reloading the plugin left the in-game editor unable to read chat input until a full restart. · Two staff editing at the same time overwrote each other, and changing the EXP table from the editor was lost on restart. · Old colour codes mixed with modern tags broke the text: <gold>Hello &7there showed the tag literally. · levels.maxlevel is now actually applied instead of being ignored. · A typo in a material name no longer stops a menu from opening, and a missing line in messages.yml no longer breaks the command that needed it. Your database Claimed rewards move to a new table that also records which battlepass they belong to. This is what makes a new season start clean. The copy is automatic on first start and your old table is kept untouched as a backup. Levels and experience are not affected. Existing claims get attributed to the battlepass active when you first start 2.2.5, which is all the old format allowed. Back up the database before updating anyway.

Just replace the jar. A new expsources.yml is generated next to your config, disabled by default: nothing changes on your server until you turn it on. New: EXP Sources The most requested feature: players earn battlepass EXP by playing, instead of only through commands. Seven sources, each one independent · Mob kill: a different amount per entity type (2 for a zombie, 500 for the ender dragon, your call) · Player kill: with a cooldown on the same victim · Block break and Block place: per material · Fishing · Crafting: per crafted item · Playtime: EXP every X minutes, with anti-AFK Configure it all in game /battlepassadmin -> EXP Sources. Turn the module or a single source on and off, set the values, add or remove entities, blocks and items, all from the menu. Every change is saved and applied immediately: no restart, no reload. Anti-farm included · Mobs from a spawner give nothing · A block placed by a player gives nothing when broken again, so place/break loops are worthless · The same victim does not pay twice within the cooldown you set Built to be cheap · While the module is off, the plugin registers no listener and no task at all · The same goes for each source: if you only use mob kills, the plugin never receives a single block or movement event · EXP is accumulated in memory and written with one database update per player every few seconds, so a mob grinder does not turn into one query per kill Tuning knobs: a global multiplier (set it to 2.0 for a double-EXP weekend), an optional permission to reserve it to a rank, a world whitelist, and an option to only grant EXP while the season is running. Every single option is documented inside expsources.yml. Fixed · Auto-switch never triggered. Every start/end date check was silently failing: the dates the plugin itself shipped are read by YAML as timestamps and not as text, so the comparison always threw. Auto-switch, the season window and the dates shown in the editor now work. If you use auto-switch and your current battlepass is already past its end date, it will now actually switch: check your dates after updating. · The in-game editor showed dates as Mon Jan 01 01:00:00 CET 2024 instead of the real value. · The default battlepass.yml ended on 2024-12-31; new installs now end in 2099. · Folia: auto-switch crashed the scheduler, and the editor could not read chat input. Both fixed. · EXP granted to a player who was leaving the server could be lost, and two gains landing at the same instant could overwrite each other.

Just replace the jar. Upgrading is automatic: on the first start your config.yml is updated and backed up, your battlepasses are left untouched. The in-game editor now works. Battlepasses created from it were unusable: the menu refused to open, or opened completely empty. Create, activate, use: it works. And retyping the name of a battlepass you already have no longer wipes its settings. For your players · Rewards were lost with a full inventory. The item vanished while the reward stayed claimed forever. Players are now asked to free a slot and can claim it after. · No more level-up spam at max level, and EXP no longer grows past the maximum. · New players are no longer greeted by a red "Free Rewards Locked" barrier. For you · Admin commands now work from your host panel and console. They did nothing there before. · /bpa reset applies instantly, no relog needed. /bpa reload no longer errors from the console. · No more false "new version available" notices. · Removed the warning printed at every single startup. Two new optional settings: update-checker to turn update notices off, and claim.require-free-slots to tune the inventory check (set it to 0 if your rewards never give items).

InventoryView error fix

Dependency update - Version update If you have any issue join in the discord

· New explainations on configs · A lot of Bug fix · New add reward options

· Fix startup on spigot · Active battlepass permission fix

Startup error fix

· Folia bug fix · Version support · dependencies updated!

New configuration in config.yml: # Message notification settings # You can disable messages and customize sounds for each notification type message-notifications: # Default sound for all messages (can be overridden per message type) default-sound: enabled: true name: BLOCK_NOTE_BLOCK_BELL volume: 0.5 pitch: 1.0 # Experience gain notification exp-gain: message-enabled: true sound: enabled: true name: BLOCK_NOTE_BLOCK_PLING volume: 0.3 pitch: 1.2 # Level up notification level-up: message-enabled: true sound: enabled: true name: ENTITY_PLAYER_LEVELUP volume: 1.0 pitch: 1.0 - Optimizations with Message options cache - Dependencies update

· Removed legacy colors from some admin messages · Removed display_item section in battlepass rewards system · Added commands support for display-items # commands: # - "player: say Hello!" # Player executes /say Hello! # - "console: give %player% diamond 1" # Console gives diamond to player # - "close" # Closes the GUI

Auto-Switch Feature (Premium) Automatic Battlepass Switching: Premium users can now configure battlepasses to automatically switch to the next season when the current one expires, with configurable next battlepass or auto-detection of available seasons.

Added Version support

· Optimized Editor Input · Fixxed an issue with Editor Input

· Dependencies updated · 1.21.3 support

· Fixxed broken config.yml · Added new command /bpa open <player> for force open battlepass gui · Improved tab completer for battlepass admin commands · updated gradle to 8.10.2 · updated dependencies in plugin.yml and paper loader · Added new conditions format Code (YAML): conditions: - type : pages value : [1, 2 ] # This item will only appear on pages 1 and 2 - type : permission value : "al.battlepass.event" # Player must have this permission - type : level value : 10 # Player must be at least level 10 · Other improvements

· Fixxed support for versions 1.21 and 1.20.6 · Updated command API

- Bug fix for commandAPI 9.5.1 - Fix an error while trying to connect the database but the folder its not loaded first (only first startup error) - An error while can't find the version of server - Library update: sqlite-jdbc:3.46.0.0 - Gradle updated from 8.4 to 8.8

· 1.21 api support · Updated CommandAPI to 9.5.0 · Solved an issue with required_exp placeholder

IF YOU DIDN'T UPDATE FROM 1.0.65 READ LATEST CHANGELOG! IF YOU DIDN'T UPDATE FROM 1.0.65 READ LATEST CHANGELOG! IF YOU DIDN'T UPDATE FROM 1.0.65 READ LATEST CHANGELOG! · 1.20.6 SUPPORT · Libraries update · Updates kyori api to 4.17 · kyori bukkit to 4.3.3 · gson to 2.11.0 · Changed enchantment to MENDING to make it work with 1.20.6 and backward versions · Updated folia to 1.20.4 · Updatd spigot to 1.20.6 · Updated commandapi and inventoryframework I'm working on a new version that will break all battlepass but will include a lot of new features and important performance improvements!

Please make a backup first, of your local database. If you are using the local database this update will break your database because h2database was upgraded to 224! · New local database support SQLITE this will be the new default local database, because its more stable and it don't will break every changed version. I didn't remove h2database, its avaiable disabiling sqlite in the config. · Now /battlepassadmin setlevel support console command · Now /battlepassadmin reload support console command · Now /battlepassadmin setexp support console command · Now /battlepassadmin reset support console command · Now /battlepassadmin help support console command · Updated help command on console · Corrected the wrong use of arguments in commandapi · Use the correctly use of ResultSet in the database structure · Changed the database structure in config.yml · Improvements to Database system in code · Improved some database error message from console. · Updated all kyori apis to 4.16 and other · Folia from 1.19.4 to 1.20.1 · h2databse from 222 to 224 (This will break your local database) · Added new API for Guis IF its not implemented yet in the code. · Code is more cleaner · Small code improvements · A lot of refactoring

Fixxed spigot issue

Fix few issue with spigot version

Other missing fixes for Spigot version

· Contains bug fix to Spigot version · Fixxed an issue that don't give rewards commands

Added legacy color support!

· Prevent errors in premium section on missconfigured · Removed chat action on adding rewards · Improvements to editor

· Prevent an issue with editor if the displayname is null

· Probably fix issues with exclude rewards · Code improvements

· Added missing parser to placeholders in decorative items!

· Solved an issue of Multi server support · Fixxed multi server cache wrong remove · Improved /battlepassadmin bugreport

· Fixxed placeholder bound exception on %albattlepass_required_exp%

· REMOVED MIGRATION SYSTEM! If you ware using a version under 1.0.54 use 1.0.55 and after use this version! · Fixxed a bug while claiming rewards.

· REMOVED MIGRATION SYSTEM! If you ware using a version under 1.0.54 use 1.0.55 and after use this version! · Small bug fix to null materials

· Solved incompatibilities with Spigot version · Removed debug

Important Notice! In this release, there's a database migration. It is highly recommended to perform a backup before migrating to avoid any unexpected errors. What's New in This Version: · We have finally added definitive support for MULTI SERVER! · Migration of the rewards table. · Minor improvements to the code. What's Coming Next: · Various issues on Spigot will be resolved, removing the different code versions between Paper and Spigot. · A menu for display items will be added. · Further improvements will be made to the menu. · Support for DiscordBOT will be introduced. · Support for customizable plugin arguments will be added.

· Fixxed commands issues in 1.19.4

· Fixxed /battlepass command aliases · Added initial multi server support. (for this i need to rework all database structure and in the next update will be reworked all the database, but i'm creating an automatically migration system integrated in the plugin)

· Fixxed rare warning issue with while adding experience

· Removed outdated free & premium rewards slots system · Changed icon of premium rewards in rewards section · Added initial rewards slots editor in the rewards pages · General improvements

· Reworked all command, now all commands using CommandAPI and i don't have duplicates from spigot and paper. · A really lot of improvements to code, more readbility and clean up. · Now PlaceholderAPI in spigot version is a softdepend. · Small bug fix Let me know if you have any problem! discord.gg/S8GjzxWjmP

The last update seems stable, but try it on local before production. · Added more support for versions like 1.16.5, 1.17, 1.18. · Added last update for spigot version

VERSION THAT MAY NOT BE STABLE This version may not be stable, it has been tested but contains many changes, if you have problems join the discord! · Big changes to battlepass rewards slot and page logic: now you can decide where you can put rewards · Edited default-battlepass on config.yml adding new rewards logic · Reworked the default battlepass.yml file with a really default battlepass · Added new method that check and fix if battlepass files don't have sections · Updates for the battlepass editor will arrive soon · This update is currently only in the paper version, once completed it will also arrive for spigot

· Fixed an issue when a new battlepass was created and the %battlepass% placeholder was not parsed · Fixed an issue with the gui title cache when changing the active battlepass · Small improvements

· Fixxed startup issue · Fixxed weight · And a lot of improvements and fix to dependencies

Added experimental versions support

· Free battlepass permission: now you can define the permission for take free rewards! set it to none if you don't want it · Added some comments to default battlepass.yml file · Translated some parts · Small improvements · Added free battlepass permission to battlepassadmin editor.

Fixxed Paper compatibility

· Displayitems editor (not finished) · Spigot support (paperlibs loading bug fix with ShadowJar)

· Fixxed spaces in rewards section in default battlepass.yml file · (in 1.0.46 version i have added folia support!)

· Fixxed a several issue that don't give rewards · Added new section display-items (only file editing actually)

· Added folia support!

· BACKUP SYSTEM! · Some problems can happen every now and then, which is why I decided to insert a backup system, it will create backups in the backup folder that you will find in the plugin folder and create a backup every 12 hours

· Fixxed an rare issue on loading files

· Fixxed an issue with /battlepassadmin reset <playerName>

· 1.20.4 (api update spigot and paper) · Added new placeholder! %albattlepass_exp_<level>% return the require exp of certain level example: %albattlepass_exp_1% return the amount of exp you need to level 1 · Updated HikariCP from 5.0.1 to 5.1.0

· Added exclude item section in battlepass.yml config which allows you to exclude from premium or free rewards from the battlepass Code (YAML): exclude-rewards: free : - 0 - 1 premium : - 2 - 3

· Prevent an issue if you don't have any battlepass as active · Prevent an issue if you remove the active battlepass file

PlaceholdersAPI Integration: · Implemented support for PlaceholdersAPI in the rewards GUI: · Display Name: Now supports PlaceholdersAPI, enhancing customization. · Lore: Enhanced with PlaceholdersAPI support, allowing for dynamic content within the rewards GUI.

· Added enchanted option on items Code (YAML): rewards: 0: premium: commands : - "give %player% paper 1" displayitem: material : "PAPER" customdata : 100 name : "<gray>Level 0 (Premium)" enchanted : true lore : - "<yellow>This is a premium reward" free: commands : - "give %player% paper 1" displayitem: material : "PAPER" customdata : 100 enchanted : false name : "<gray>Level 0 (Free)" lore : - "<gray>This is a free reward"

· I have made a lot of improvements to updatechecker because a lot of people don't update the plugin:

· Added new Display item section! now you can modify previous page and next page · Improved some parts of code · Changed display items of main page of editor.

Removed license system

· License Key system! Since one of my plugins was recently leaked, I decided to work on a license key system. To get your license, enter the discord, open a ticket, and I will assign you a license as soon as possible! · Discord link: discord.gg/S8GjzxWjmP Attention, if the key does not exist the plugin will be put in the Free version so it will still be usable, even if the license server goes offline the plugin will continue to work

· Improved the exptable section adding GuiEditor! · Improved exptable system · Code improvements Please let me know if you have any issue! Join now in discord: discord.gg/S8GjzxWjmP

· Customizable aliases for /battlepassadmin and battlepass · Compatibility with customizable aliases for Spigot version · Improvements to code

· Fixxed all issues on startup about Exptable · Improved error handling · Thank you so much to Deveroonie to report the issue!

· NEW FEATURE! EXPTABLE: Now you can change the exp curve in the new file exptable. · Improved a lot ActiveBattlepasss system. · For the moment the changing of exptable require to restart the server. · Can have small issue let me know joining in discord! Code (YAML): tables: default : #this is the name of the table you need to define in EDITOR - 100 # this is the amount of exp you need to level up from level 1 to level 2 - 200 # level 2 to level 3 - 300 - 400 - 500 - 600 - 700 - 800 - 900 - 1000 - 1100 - 1200 - 1300 - 1400 - 1500 - 1600 - 1700 - 1800 - 1900 - 2000 - 2100 - 2200 - 2300 - 2400 - 2500 - 2600 - 2700 - 2800 - 2900 - 3000 example : - 1000 - 2000 - 3000 - 4000 - 5000 - 6000 - 7000 - 8000 - 9000 - 10000

· Removed small part of duplicated code · NEW IMPORTANT FEATURE: New admin commands avaiable! · /battlepassadmin setlevel <player> <level> - this command only change the level of user · /battlepassadmin setexp <player> <exp> - this command change the experience of user · /battlepassadmin reset <player> (This remove the data of taked rewards) · Added new messages related to new commands

· Added a description to add Reward and colors. · Changed id to level, and added missing lore in premium rewards. · Added decription to commands, customdata, material, name and color support. · Reworked Lore system of editing item now working fine and you can remove lines · Added messages on setting values to items options

· Added support of multislot for previous and next page · Example: Code (YAML): previous-page: material : "ARROW" name : "<gray>Previous page" customdata : 100 lore : - "<gray>Click to go to the previous page" slot : - 9 - 10 next-page: material : "ARROW" name : "<gray>Next page" customdata : 100 lore : - "<gray>Click to go to the next page" slot : - 16 - 17

· [NEW FEATURE] Sound system in battlepass rewards gui! · Now you can set and customize all sound from any action on battlepass gui · The new config part will be auto generated on start, if you want you can copy and paste this to conifg.yml Code (Text): custom_sounds: enabled: true # This sound is used when player click a premium slot # without premium permission no-premium-permission-sound: enabled: true name: BLOCK_ANVIL_LAND volume: 1.0 pitch: 1.0 premium-reward-claimed: enabled: true name: ENTITY_PLAYER_LEVELUP volume: 1.0 pitch: 1.0 reward-already-claimed: enabled: true name: ENTITY_VILLAGER_NO volume: 1.0 pitch: 1.0 free-reward-claimed: enabled: true name: BLOCK_NOTE_BLOCK_PLING volume: 1.0 pitch: 1.0 level-not-reached: enabled: true name: ENTITY_ENDERMAN_TELEPORT volume: 1.0 pitch: 1.0

· New battlepass info command · Now /battlepass info its customizable in messages.yml · Now /battlepass info user have a permission: anotherlevel.battlepass.info.other

· Solved an issue that regenerate the config.yml every reload. · Added Materials checker in Premium and free rewards gui. · and prevented to add not existing materials. · Added new message invalid-material

Fixxed an issue on creating a new battlepass

Fixxed same issue on creating a new battlepass on paper

· Solved all bugs from Spigot version · Updated the spigot version with all of newest updates · Small improvements to code

· Fixxed an issue with config.yml

· Finally added the back button in all editorGUI · Code improvements

· Fixxed a several bug when adding rewards · Added missing message on create a reward · Added other informations in reward section · Reworked some part of code · Added more descriptions · General improvements · switch from maven to gradle

· Added new command /bpa report to give informations to help dev to find issue

· Added string list regeneration if don't exist on messages.yml file · Added descriptions in the main editor gui · Added new messages when edit commands and on creation of rewards · Small improvements to code · Removed other debug

· Prevent error if material was wrong and give a lot of wrong material · Added new placeholder %albattlepass_required_exp% · Updated PlaceholderAPI docs: https://docs.anotherlevel.it/documentation/battlepass/pla… · Updated placeholderAPI to 2.11.4 · Added new message for change the loading value of placeholders

· Message regeneration on startup (that generate missing messages of messages.yml if missing) · New 10 message that explain what you need to write in chat · Rework of some part of reload command · Fix to lastOpenGui on editor that open last gui when you are editing · Now when you write cancel to cancel an action will reopen the last gui · Removed debug · Better handling between exceptions · Reworked some part of codes · Fixxed spigot bug while creating a new battlepass. · Fixxed change value on buttons: gui-title, exptable, database-table, start-free-items, start-premium-items, gui-size · Optimized some part of code (These changes are not synched with Spigot version on 1.1 RELEASE i will convert all of these to spigot version)

· Better error handling · Adding message on startup errors · Added the correct version on logs · Fixxed errors on spigot version

· Improved the code removing some unused code · Solved an issue with 1.19 version

· Fixxed other startup errors · Fixxed other bugs Tested and working