XPTweak 1.19+ to 1.21.11

Advanced XP Management and Economy System



Best 2 commands choised by players: ( to Storage/Sell xp Bottles )
Example: /xptc lvl 30 or /xptc max



Changelogs:

v1.3:
In this latest version 1.3 of the XPTweak plugin, an option has been implemented allowing server owners to decide how many XP points will be distributed in the defined orbs during the XP shower.

v1.2:
Partial Inventory Storage ( /xpt inv ): Smart storage that fills your available inventory slots with XP bottles and keeps the remaining experience in your bar, preventing inventory overflow issues.
Real-Time Rain Timer ( /xpt time ): Added a precise countdown clock showing exactly how long until the next XP Rain in a clean `00h:00m:00s` format.
XP Inspection ( /xpt inspect <player> ): New auditing tool that allows checking any player's exact level and total experience points.
Enhanced Rain Announcements: You can now configure a custom location-instruction (like /warp xp) in the config, which will be automatically included in both In-game and Discord announcements.
Localized Time Units: All time-related messages (hours, minutes, seconds) are now fully translatable across all 4 supported languages.
Stability & Safety: Improved command argument handling and added internal task cleanup to prevent duplicate messages during reloads.
Bug Fix - Duplicate Announcements: Fixed a critical issue where rain announcements were sent multiple times. Integrated a unique task ID system and improved scheduler cleanup during reloads to ensure clean messaging.

v1.1:
Fixed /xpt all command giving all player experience in bottles to inventory full!
- Old situation, rest of xp lose.
- New situation:
- payer receive warn about inventory
- if player decide accept, it rest of bottles dropped on the ground.

Optimization:
Moved Help /xpt [command] from config to both 4 language message files.
Added /xptc command on help list.
Recommed give that permission xptweak.user.custom for players create custom unique bottle xp.
To negate /xpt all command type:
/lp group default permission set xptweak.user.store false

1.0 Initial release with multi-version support (1.19 to 1.21+), Folia compatibility, and precision XP storage. Integrated SQL database for persistent player preferences and transaction logs.

Initial Project
│➜ Precision XP Engine: Advanced formulas to calculate
│➜ exact experience points for levels 0-16, 17-31, and 32+,
│➜ preventing any loss during storage or transfer.
│➜ NBT Custom Bottles: Create specialized XP bottles
│➜ using PersistentDataContainer (PDC) that store exact
│➜ points and display the creator's name.
│➜ Dynamic XP Auctions: Start auctions for your levels
│➜ with regressive timers and real-time bidding, fully
│➜ integrated with Vault economy.
│➜ Auction Privacy: New /xpt auc list command allows
│➜ players to toggle auction messages on or off.
│➜ Preferences are saved permanently in the database.
│➜ Secure P2P Donations: Player-to-player XP transfer
│➜ system requiring manual acceptance to prevent
│➜ inventory or chat spam.
│➜ Scheduled XP Rain: Region-based events via WorldGuard
│➜ flags (xpt-rain) with sky-drop effects and
│➜ customizable timers.
│➜ Discord Integration: Dedicated webhooks for
│➜ reporting donations, auction sales, and
│➜ XP rain announcements.
│➜ Death Recovery: Optional feature to drop 100% of
│➜ player XP as a custom NBT bottle upon death,
│➜ preventing entity lag from standard orbs.
│➜ Localized Language Core: Full support for English (EN),
│➜ Portuguese (PT), Spanish (ES), and Russian (RU)
│➜ configurable via config.yml.

Update Instructions: It is highly recommended to use Vault and WorldGuard 7+ for full feature availability.

Main Features
│➜ Folia & Paper Ready: Built with region-aware
│➜ scheduling logic to ensure 100% compatibility
│➜ with multi-threaded server environments.
│➜ Dual Database Support: Choose between SQLite for
│➜ standalone servers or MySQL for BungeeCord/Velocity
│➜ networks.
│➜ Asynchronous Processing: Webhooks and database
│➜ saves run outside the main thread to ensure zero
│➜ impact on server TPS.
│➜ WorldGuard Integration: Custom 'xpt-rain' flag
│➜ allows admins to define specific arenas for
│➜ experience events.
│➜ Smart Help Menu: Interactive and customizable
│➜ help guide integrated into the config.yml.

Commands
│➜ xpt help Help command to view all available tools.
│➜ xpt max/lvl Converts your experience levels into bottles.
│➜ xpt give Sends an XP donation request to a player.
│➜ xpt accept Accepts a pending experience donation.
│➜ xpt auc <lvl> <price> Starts an XP auction with a starting price.
│➜ xpt auc list Toggles auction messages in your chat.
│➜ xpt bid [x1|x2] Places a bid on the currently active auction.
│➜ xpt rain Triggers a manual XP Rain event in the region.
│➜ xpt reload Hot-reloads all configurations and language files.
│➜ xptc Admin command to create custom NBT XP bottles.

"You can give " xptweak.user.custom " permission for players generate a unique Bottle Custom of XP with his name to sell or storage it." The difference of normal /xpt max is becasue /xpt generate vanilla bottles of xp to storage all xp in default minecraft math generating bottles, and xptc command generate a unique bottle with all player xp."

Permissions
Remeber you dont need to it all (default enabled)
just /xptc must be gived! (xptweak.user.custom)

│➜ xptweak.user.base Access to help and acceptance commands.
│➜ xptweak.user.store Permission to store XP into bottles.
│➜ xptweak.user.give Permission to donate XP to others.
│➜ xptweak.user.auction Permission to start or bid in auctions.
│➜ xptweak.user.custom Admin permission to create NBT bottles.
│➜ xptweak.admin.reload Master permission to reload the plugin.
│➜ xptweak.admin.rain Master permission to trigger rain events.

Configuration (config.yml)
│➜ database: Configure SQLite or MySQL for logs and
│➜ player preferences.
│➜ webhooks: Set dedicated URLs for different
│➜ server events (Rain, Auctions, Donations).
│➜ language: Switch between en, pt, es, or ru.

Important Notice
│➜ Compatible with Minecraft 1.19.x to 1.21.x.
│➜ Required Dependencies: Vault (for Economy) and
│➜ WorldGuard (for XP Rain).
│➜ Developed for high-performance production environments.

Developed with ❤️ by Comonier