RCrates v0.3-SNAPSHOT-0724

Changelog:

- Particles & Holograms changed
The height of holograms and particles now has no limit. You can put the height you want completely.

- Global menu fix
Fixed a menu clicking error. Before, using Shift + Any type of click did not work. Now that has been completely solved and works without problems. This applies to all plugin menus!

- Shift clicks + drop added to /crates menu.
Now in the /crates menu, you can put custom actions for shift clicks (left and right) and drop.
If you wish, you can now open all the keys that the user has (virtual).

YAML:

Using "crate;;open-all:(crate name)".

Be careful with this, because it is not completely optimized and if many people do it with many keys they can lag the server!

[menu.yml] data to add:

YAML:

# ...existing code...
crates_menu:
  # ...existing code...
  items:
    (slot):
      # ...existing code...
      actions:
        # ...existing code... (below "right_click")
        shift_left_click:
          - 'crate;;open:PartnerPackage'
          - 'message;;&aOpening partner packages'
        shift_right_click:
          - 'crate;;preview:PartnerPackage'
          - 'message;;&cPreviewing partner package rewards'
        drop:
          - 'crate;;open-all:PartnerPackage'
          - 'message;;&aOpening all partner packages'

Changelog:

- Error opening keys fixed
Error opening a key with the confirmation menu activated, which took out a key before confirming, has been completely fixed.

Changelog:

- Fixed a critical error that was preventing the plugin from starting.
This resolves startup interruptions and ensures the plugin loads correctly.

- New Option to decide to save crates
An option was added to be able to save the crates in the "crates.yml" as before or by file, before in "/data/crates.yml" now in "/data/crates/(name).yml", this You can decide, continue using the previous or new method. To make everything easier, a command called "/crate convert <normal|each|each-clear>", "normal" was added: change the crates from "each" to "normal". "each": vice versa to the previous one, basically change from "normal" to "each", and finally "each-clear": delete all crates in the "data/crates/*.yml".

- Fixed bug when opening a key having rewards disabled
Fixed a bug when wanting to open a disabled rewards key, this caused you to receive the rewards even if it was disabled.

- Custom confirmation menu
Now you can modify the confirmation menu as you wish! This includes custom items, custom rewards and among others!

- Hex & Gradient Support
You can now use hex colors and gradient in messages. Example: "This is a message with &{gradient:#FF0000:#00FF00:gradient text} and also with hexadecimal colors like this &#FFFF00 and this &#00FFFF."

[config.yml] data to add:

YAML:

# ...existing code... (below "enable-placeholderapi")
save-type: "normal" # How the crates should be saved. Options: 'each' (saves each crate in its own file on data/crates/) or 'normal' (saves all crates in a single file).

fill:
  enabled: true # If the fill is enabled.
  material: 'GRAY_STAINED_GLASS_PANE' # The material of the fill item.
  name: '&7Fill' # The display name of the fill item.
  lore: # The lore of the fill item.
  - '&7This is a fill item.'
  - '&7It is used to fill empty slots.'
  amount: 1 # The amount of the fill item.
  data: 0 # The data value of the fill item.
# ...existing code...

[menu.yml] data to add:

YAML:

# ...existing code... (below "crates_menu")
reward_confirm_menu:
  enabled: true
  title: "&8Confirm Your Reward"
  size: 27

  items:
    11:
      item:
        material: RED_STAINED_GLASS_PANE
        data: 14
        display_name: "&cDecline"
        lore:
          - "&7Cancel and return"
      actions:
        left_click:
          - "decline"
        right_click:
          - "decline"

    13:
      item:
        material: "{reward-item}"
      actions:
        left_click: []
        right_click: []

    15:
      item:
        material: LIME_STAINED_GLASS_PANE
        data: 5
        display_name: "&aAccept"
        lore:
          - "&7Confirm & claim:"
          - "&fName: {reward-name}"
          - "&fAmount: {reward-amount}"
      actions:
        left_click:
          - "accept"
        right_click:
          - "accept"

    26:
      item:
        material: PAPER
        data: 0
        display_name: "&eDebug Info"
        lore:
          - "&7This is your reward:"
          - "{reward-name}"
          - "{reward-lore}"
      actions:
        left_click:
          - "message;;&eHi!"
        right_click:
          - "close"

You can adjust these settings for each crate.

I hope I haven't forgotten anything, if there is any error in the plugin, sorry, remember to report it to me!
More updates are coming soon!

Thanks to those who support the plugin, i appreciate!
Gracias a los apoyan el plugin, lo agradezco!

Changelog:

- Fixed critical crate menu issue!
Fixed an issue where using the crates menu could cause unexpected errors or behavior.
The crate management menu now works smoothly when editing or managing crates.

- Added reward accept/reject option for choose type crates!
You can now configure crates with the open type set to choose, allowing players to accept or reject a reward before receiving it.
This adds more interaction and choice when opening crates!

- Added option to give item for each slot!
A new option allows you to enable or disable giving the physical item for each reward slot when opening a crate.
This does not remove the existing option — you can still disable giving all items globally if you prefer.
Players can now receive the actual item per slot, or just get rewards through commands — your choice!

- Added crate model system (BETA)!
You can now set a model type for your crates — in beta!

| "normal": Use default vanilla model (no custom model data).
| "custom": Use custom model data to give crates a custom appearance. (More animation options coming soon!)

This gives you more ways to customize how your crates look in-game.

[crates.yml] data to add:

YAML:

crates:
  (name):
    crate:
      model:
        data: 0
        type: "normal" # options: "normal" | "custom"

[language.yml] data to add:

YAML:

CRATES:
  MENU:
    # ...existing code...
    CHOOSE:
      # ...existing code...
      DECLINED: '&cYou declined the reward.'
    CONFIRM:
      TITLE: '&bConfirm Reward'
      ACCEPT: '&a&lAccept'
      DECLINE: '&c&lDecline'

You can adjust these settings for each crate to fit your server’s style.
More features for animated models are on the way!

Changelog:

- Fixed critical DecentHolograms support!
Fixed a critical issue with the DecentHolograms integration.
RCrates now works smoothly with DecentHolograms, resolving errors that could prevent holograms from updating properly and ensuring seamless compatibility for your hologram displays.

- Added an option to give items when opening crates!
Added an option to enable or disable giving items when opening a crate.
This lets you decide whether players receive the physical items directly in their inventory or only get rewards through commands — giving you more flexibility for custom crate setups.

[crates.yml] data to add:

YAML:

crates:
  (name):
    key:
      open:
        items-enabled: (true = activate | false = deactivate)

You can adjust these settings as needed for your server’s style.

Changelog:

- Fixed support for Minecraft 1.21!
Support for 1.21+ fixed. Bug that did not show the /crate editor menu items, particles and other blocks did not work, this has been fully fixed and the plugin is ready to use.

No configuration changes are required — just update your server jar and enjoy!

You can adjust any settings or test thoroughly on your setup to ensure everything works smoothly.

Changelog:

- Added support for Minecraft 1.21!
RCrates now fully supports the latest 1.21 version, ensuring compatibility with new features, blocks, and items. This keeps your crates experience up-to-date with the newest game version.

- Added support for Purpur servers!
Purpur users can now run RCrates without issues, taking advantage of its additional performance and gameplay features while enjoying full crate functionality.

No configuration changes are required — just update your server jar and enjoy!

You can adjust any settings or test thoroughly on your setup to ensure everything works smoothly.

Changelog:

- Added a new "Choose Reward" menu for crates!
Players can now select their preferred rewards when opening a crate, up to the allowed number of prizes. The menu displays all possible rewards, their chances (if enabled), and provides feedback messages for selections, limits, and success. This feature enhances player interaction and control over crate rewards.

- Fixed a critical error that was preventing the plugin from starting.
This resolves startup interruptions and ensures the plugin loads correctly.

[language.yml] messages to add:

YAML:

# ...existing code...
CRATES:
  # ...existing code...
  MENU:
    CHOOSE:
      TITLE: '{crate-displayname}'
      LORE:
      - ''
      - '&7Click to select this reward.'
      SELECTED: '&aReward selected: &f{item}'
      NO_SELECTION: '&cYou did not select any item.'
      MAXIMUM_SELECTION: '&cYou have already selected the maximum rewards.'
      SUCCESS: '&aYou have received your rewards.'
# ...existing code...

[crates.yml] data to add:

YAML:

crates:
  (name):
    key:
      open:
        type: "" # Options: "normal" or "choose"

You can adjust the messages and formatting as needed for your server’s style.