Lucky Rabbit Lootboxes v1.0.7

Open Source Announcement

Our plugin is now open source!

• After much effort, we've successfully created an environment where no sensitive data is exposed. You can now explore the source code and contribute!
• We’ve also enhanced the API for license verification, which now requires a special key only accessible to us.

If you'd like to help, feel free to join us here!

New Features

Detailed Documentation

• Added a comprehensive and detailed documentation for developers and contributors.

License Key Commands

• Introduced a new command: /lb config <category> licence-key add/remove XXXX-XXXX-XXXX-XX.
• This allows you to add or remove license keys directly via command. The plugin will instantly validate the key and display an appropriate message — no more editing configs or restarting the server!

Improved API Communication

• The plugin now avoids sending unnecessary API requests if the user has a PREMIUM or FREE version, optimizing performance.

New Permission: admin.config

• Added a new permission that grants access to the /lb config command.

Improvements

Open Source Structure

• Adjusted the codebase to remove sensitive data, making it safe for public contributions.

Streamlined API Communication

• Improved the communication system to prevent unnecessary server queries.

Known Issues

• None reported yet

New Feature: Improved Chance Distribution

Automatic Chance Distribution for Items

• Item chance distribution is now automatically calculated to ensure a total of 100%.
• If an item does not have a specified chance, the plugin will distribute chances equally, e.g.:
  • Single item: item 0 - 100%
  • Two items: item 0 - 50%, item 1 - 50%, etc.

Manual Chance Specification

• If an item has a defined chance, that value will remain fixed. Any manual changes to item chances must be set in the configuration file.
• To prevent errors, please verify that the total of all item chances does not exceed 100% — the plugin will return an error in chat if this limit is exceeded.

Minor Fixes and Improvements

Code Cleanup

• Removed additional unused classes to further enhance performance.

Known Issues
Item List Display Issue on Removal

• When items are removed, the chat list does not update immediately, though chances are recalculated correctly when new items are added.

Special Thanks

• Thanks to SquareShox for his big brain and contributions to this update!

Bugfixes and Improvements

Fixed Oraxen Item Display

• Resolved an issue with fetching and displaying Oraxen items correctly in the GUI.

Code Cleanup

• Removed unused classes from the codebase to improve performance and reduce clutter.

Known Issues
- None reported yet

Command Changes

Merged /lb remove and /lb place Commands

• These commands have been consolidated into a single /lb entity command for streamlined entity management:
  • /lb entity spawn <entity_id>: Spawns a lootbox entity at the player’s current location.
  • /lb entity despawn: Despawns the targeted lootbox entity by looking at the block where it is located.

Updated /lb help Menu

• Added information about the new /lb entity command in the help menu for easier reference.

GUI Improvements

Softened GUI Colors

• Updated GUI colors to softer, custom shades for a more polished visual experience.

Code Cleanup

• Removed unused classes from the codebase, enhancing performance and reducing clutter.

Known Issues

• Oraxen items do not load (will be fixed in next version)

Commands

/lb remove (NEW)

• Allows players to despawn a placed lootbox entity. To use, look at the block (not the entity) where the lootbox is located and execute the command.

/lb place

• To place a lootbox entity, stand at the desired location and execute the command. The entity will spawn at the player’s feet.

Note: These commands will soon be consolidated into a single /lb entity command with options for spawn and despawn.

Click to expand...

Bugfixes and Improvements

Minor Bugfixes

• Various small bugfixes to improve stability and user experience.

Known Issues

• None reported yet

Bugfixes and Improvements

- Fixed Critical Issue with Animation Spin
- Resolved a critical issue where users could remove items from the GUI during the animation spin. This fix ensures items remain secured in the GUI throughout animations.

- Minor Bugfixes
- Various small bugfixes to improve stability and user experience.

Known Issues
- None reported yet

Bugfixes and Improvements

- Adjusted GUI Permissions and Layouts
- Non-admin users can no longer open lootboxes from the /lb list menu, while admins retain full access.
- Removed the "Back to List" button from the entity GUI for a cleaner interface.

- Winning Item Sound and Animation
- Added new sounds for winning items, including a special sound and animation for legendary items visible to all players.

Added Features

- Range Support for Item Amounts
- Added support for specifying ranged item amounts in lootboxes. Use the format:

Code:

item:
  type: COAL
  amount: min-max

- Server Version Support
- Supported server versions now include 1.19, 1.20, and 1.21.

Example Updates

- Example Chest Enhancements
- Added examples of items with min-max amounts to the example chest configuration.

Command and Interface Improvements

- Pagination Fixes in /lb list
- Corrected the display of "next" and "previous" page options in /lb list.

- Improved Suggestions for /lb key add user (lootbox_id)
- Fixed the suggestion feature, which now properly suggests lootbox_id when using /lb key add.

- Simplified Help Menu
- Removed inaccessible commands from the /lb help menu for non-admin players, ensuring a streamlined experience.

Known Issues
- Items can be pulled out from GUI durning spinning animation (CRITICAL - FIXED in HOTFIX)

- Fixed License Handler Functions
- License handler functions now properly process JSON format, eliminating previous exceptions.

- Fixed Entity Metadata and Respawn Multiplication Error
- Resolved an issue with entity metadata settings and respawn multiplications.

- Enhanced License Server Security
- Added additional security measures to the license server backend to improve stability and protection.


Known Issues
- None reported yet