CrateBundles

### 💬 Primary Support Channel (Preferred)

All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our (https://discord.gg/48sZCbdHzJ).** We actively monitor the server and will respond as soon as possible. This ensures that the whole community can benefit from the discussion and solutions.

### 🆘 Urgent Private Messaging (PM) Policy

While we prefer all issues to be handled via the Discord server first, you are welcome to PM me directly under specific urgent circumstances*:

Allowed Reason: Your server is crashing or experiencing critical, game-breaking errors directly related to one of my mods/plugins. Requirement: You must be the owner of the server. Time Zone: I am operating in the (CET/CEST) Time Zone. PM Hours: Please only send private messages between 10:00 AM and 10:00 PM (Brussels Time).

I will endeavor to answer your PM as soon as I can to be helpful and see what I can do to resolve your urgent issue. However, please understand that immediate responses are not guaranteed, and private messaging is a professional courtesy, not an entitlement. Thank you for your understanding and cooperation!

Key Features:

Deeply Customizable Reward Crates: Define unlimited "Bundle Types" (e.g., Vote Crate, Legendary Key) stored in the configuration. Configure rewards as Items (with custom names, lore, NBT, enchantments, and counts), Commands (executed by the server, with player placeholders), or Kits (MULTI rewards) containing multiple sub-rewards. Assign weights to each reward to control drop chances. Set custom display names, lore, the base Minecraft bundle item (e.g., `minecraft:red_bundle`, `minecraft:black_bundle`), and even add a cosmetic enchantment glint for each Bundle Type.

Animated Crate Opening: Engage players with a visually appealing GUI animation when they open a Bundle. Choose from 8 different item presentation styles (controlled by `itemCycleVariant`) that dictate how items appear and move during the rolling animation (e.g., Standard Single, Dual Horizontal Line Scroll, Diagonal Sweep, Random Flash & Hold). Select from over a dozen pane animation styles per Bundle Type (e.g., Rainbow Wave, Border Chase, Spiral In, Ambient Sparkle, Row Pulse, Center Pulse, and more!) to make each crate's background feel unique. Customize the opening GUI layout itself with 9 different structural variants, affecting row count and reward placement.

Comprehensive In-Game & File Configuration: GUI-Based Management: Admins can use commands like ``/bundle modify `` to open intuitive GUIs for:     Adding/removing rewards from bundles.     Editing item/command properties (count, rarity/weight, display names, NBT aspects).     Managing kit contents, icons, and properties (display name, icon, weight, description).     Changing bundle animation styles (pane animation, item cycle variant, GUI layout). Chat-Driven Editing: Configure specific properties like command preview names, command strings, command preview lore (descriptions), and kit metadata through guided chat prompts initiated from the GUIs. JSON Configuration: All settings are stored in human-readable JSON files (`cratebundles.json`, `cratebundles_messages.json`) for easy backup, sharing, or advanced manual editing. A detailed default configuration is generated to get you started.

Advanced Kit System (MULTI Rewards): Create "Kits" that grant multiple items and/or execute multiple commands as a single reward. Kits can have custom display icons (any item, with NBT), names, descriptions, and weights within their parent bundle. Easily convert existing Item or Command rewards into new Kits via the Item Property Editor GUI. ~~If a kit contains only one Item or Command reward after editing, it can automatically "unwrap" back into that single reward type, simplifying your configuration.~~

Player-Friendly Features: Bundle Previews: Players can shift-right-click a Bundle to see its potential rewards. Admins can use ``/bundle list`` (hovering over bundle names shows the item) or toggle ``/bundle adminlore`` for an enhanced preview mode with more details. Kit Redeem Chest: If a player's inventory is full when winning a Kit, they receive a special "Kit Redeem Chest" (a custom player head item) to claim