LootBox: ⭐Random Unique Items ⭐Custom items and Particles  (FULLY CUSTOMIZEABLE) [1.19 - LATEST] icon

LootBox: ⭐Random Unique Items ⭐Custom items and Particles (FULLY CUSTOMIZEABLE) [1.19 - LATEST] -----

Luckybox with cool features, chance system and particles and custom items , commands



(Discord for suggestions and bugs) = (protectedbyme (Discord Username) (the author is accepting all of the suggested ideas)

⭐COMMANDS⭐

NEW! /lootbox give <type of lootbox> <player> 1 (it will give the player 1 lootbox)
NEW! /lootbox give <type of lootbox> all <amount> l (you will give all the players lootbox
- /lootbox reload
NEW! /lootbox give <type of lootbox> player or all <amount>
NEW! /lootbox reload
NEW! /lootbox debug


PERMISSIONS
-lootbox.give ( to give a lootbox to specific player)
-lootbox.reload (reload config)
NEW! - lootbox.give.all (to give everyone a lootbox)

⭐ FEATURES ⭐
- NEW! Config.yml added! (You can simply add any items in minecraft) (You can find many materials in the config.yml link)
- NEW! Permission added (lootbox.give) to block any troller abusing the command!

- NEW! Chance System added! ** DONT ADD PERCENT SYMBOL**
- NEW! You can add your lores to the lootbox!
- NEW! Folia Support
- NEW! Commands now can be executed also by console
- NEW! Now you can make the reward execute commands!!

⭐FEATURES ADDED IN 1.6 PATCH⭐
- NEW! Debugging mode added!
- NEW! New types of lootboxes added (even, legendary, vote, common, and more types)
- NEW! Check if the inventory for the receiver is full (multiple methods are available if yes, drop ,store, deny)
- NEW! Enhanced the particles when the player open a lootbox
- NEW! Everything is not customizable directly from the config.yml

⭐ TO- DO List ⭐
- Manual creating lootboxes (next patch)
- Creating API for developers ( maybe tomorrow :>)
Plugin Overview (Updated Video)

Config.yml Example: (Colors Supported)

Code (Text):

# ========================================
#      LootBox Plugin Config
# ========================================

# Global Settings
broadcast-sound-enabled: true

# Inventory Handling Settings
inventory-full-handling:
  # What to do when player's inventory is full
  # Options: "drop", "deny", "store"
  method: "store"

  # If method is "drop", should we drop items at player location?
  drop-at-player: true

  # If method is "deny", should we prevent opening lootbox when inventory full?
  prevent-opening-when-full: false

  # Messages for full inventory
  messages:
    lootbox-dropped: "&eYour inventory is full! Lootbox dropped on the ground."
    reward-dropped: "&eYour inventory is full! Reward dropped on the ground."
    inventory-full-deny: "&cYour inventory is full! Clear some space before opening lootboxes."

    # Store method messages
    store-receiver-full: "&cYour inventory is full! Someone tried to give you a {item} but it couldn't be delivered."
    store-executor-failed: "&c{player}'s inventory is full! Could not deliver {item}."

    # Deny method with executor notification
    deny-executor-notified: "&c{player}'s inventory is full! Could not give {item}."

# Global broadcast messages (used if no type-specific messages exist)
# Placeholders: {player} = player name, {item} = reward name, {lootbox} = lootbox display name, {type} = lootbox type
broadcast-messages:
  - "&6 &e{player} &6opened a {lootbox} &6and received &e{item}&6!"
  - "&a✨ &2{player} &agot lucky with &2{item} &afrom a {lootbox}&a!"
  - "&c &4{player} &cunboxed &4{item} &cfrom a {lootbox}&c!"
  - "&b &3{player} &bdiscovered &3{item} &bin their {lootbox}&b!"
  - "&d &5{player} &dwas rewarded with &5{item} &dfrom a {lootbox}&d!"

# ========================================
#            LOOTBOX TYPES
# ========================================

lootboxes:

  # ==========================================
  #               COMMON LOOTBOX
  # ==========================================
  Common:
    # Custom material (optional - uses CHEST if not specified)
    material: CHEST

    # Custom display name (optional - uses default if not specified)
    display-name: "&f&lCommon LootBox"

    # Should this lootbox have enchantment glow? (optional - uses default if not specified)
    enchanted: false

    # Custom lore (optional - will use default if not specified)
    lore: |
      &7A basic lootbox with
      &7everyday rewards
      &eRight-click to open!

    # Type-specific broadcast messages (optional)
    broadcast-messages:
      - "&7{player} &fopened a Common LootBox and got &7{item}&f!"
      - "&f✧ &7{player} &freceived &7{item} &ffrom a common box!"

    rewards:
      bread:
        chance: 30
        material: BREAD
        amount: 8
        display-name: "&fFresh Bread"

      iron_ingot:
        chance: 25
        material: IRON_INGOT
        amount: 3
        display-name: "&7Iron Ingots"

      coal:
        chance: 25
        material: COAL
        amount: 12
        display-name: "&8Coal Chunks"

      small_money:
        chance: 15
        command: "eco give {player} 50"

      experience:
        chance: 5
        command: "xp add {player} 100"

  # ==========================================
  #                RARE LOOTBOX
  # ==========================================
  Rare:
    # Custom material - you can use any valid Minecraft material
    material: BARREL

    # Custom display name
    display-name: "&9&l⬥ Rare LootBox ⬥"

    # Enchanted glow
    enchanted: true

    lore: |
      &9⬥ &bRARE LOOTBOX &9⬥
      &9Contains valuable treasures
      &9for the fortunate!
      &eRight-click to open!

    broadcast-messages:
      - "&9 &b{player} &9struck rare luck with &b{item} &9from a Rare LootBox!"
      - "&b⚡ &3{player} &bunboxed a rare &3{item}&b!"

    rewards:
      gold_ingot:
        chance: 25
        material: GOLD_INGOT
        amount: 5
        display-name: "&6Golden Ingots"

      diamond:
        chance: 20
        material: DIAMOND
        amount: 2
        display-name: "&bShiny Diamonds"

      enchanted_book:
        chance: 15
        material: ENCHANTED_BOOK
        amount: 1
        display-name: "&5Mysterious Knowledge"

      emerald:
        chance: 15
        material: EMERALD
        amount: 3
        display-name: "&aEmerald Gems"

      rare_money:
        chance: 15
        command: "eco give {player} 200"

      rare_experience:
        chance: 10
        command: "xp add {player} 500"

  # ==========================================
  #              LEGENDARY LOOTBOX
  # ==========================================
  Legendary:
    # Custom material - can be anything you want!
    material: GILDED_BLACKSTONE

    # Custom display name with fancy formatting
    display-name: "&6&l✦ &e&lLEGENDARY LOOTBOX &6&l✦"

    # Definitely enchanted for that legendary glow
    enchanted: true

    lore: |
      &6✦ &eLEGENDARY LOOTBOX &6✦
      &6Contains the most precious
      &6treasures in the realm!
      &6Blessed by ancient powers!
      &eRight-click to open!

    broadcast-messages:
      - "&6 &e{player} &6has opened a LEGENDARY box and received &e{item}&6! &6"
      - "&6⚡ &eLEGENDARY LUCK! &6{player} &eunboxed &6{item}&e!"
      - "&6✧ &eThe gods smile upon &6{player}&e - they received &6{item}&e!"

    rewards:
      netherite_ingot:
        chance: 15
        material: NETHERITE_INGOT
        amount: 1
        display-name: "&4Ancient Netherite"

      elytra:
        chance: 10
        material: ELYTRA
        amount: 1
        display-name: "&dWings of Freedom"

      totem_of_undying:
        chance: 8
        material: TOTEM_OF_UNDYING
        amount: 1
        display-name: "&6Totem of Immortality"

      beacon:
        chance: 5
        material: BEACON
        amount: 1
        display-name: "&eBeacon of Power"

      legendary_money:
        chance: 25
        command: "eco give {player} 1000"

      massive_experience:
        chance: 20
        command: "xp add {player} 2000"

      legendary_jackpot:
        chance: 2
        command: "eco give {player} 10000"

      # Ultra rare rewards
      creative_flight:
        chance: 1
        command: "lp user {player} permission set essentials.fly true"

  # ==========================================
  #                VOTE LOOTBOX
  # ==========================================
  Vote:
    # Use a different material for vote boxes
    material: LIME_SHULKER_BOX

    display-name: "&a&l⚡ Vote LootBox ⚡"

    # No enchantment for vote boxes to keep them simple
    enchanted: false

    lore: |
      &a⚡ Thanks for voting! ⚡
      &aYour support helps the server grow
      &aHere's your voting reward!
      &eRight-click to open!

    broadcast-messages:
      - "&a️ &2{player} &avoted for the server and received &2{item}&a!"
      - "&a⭐ &2Thanks {player} &afor voting! They got &2{item}&a!"

    rewards:
      vote_money:
        chance: 30
        command: "eco give {player} 100"

      vote_experience:
        chance: 25
        command: "xp add {player} 300"

      iron_tools:
        chance: 15
        material: IRON_PICKAXE
        amount: 1
        display-name: "&7Voter's Pickaxe"

      golden_apple:
        chance: 10
        material: GOLDEN_APPLE
        amount: 2
        display-name: "&6Golden Apples"

      enchanted_golden_apple:
        chance: 5
        material: ENCHANTED_GOLDEN_APPLE
        amount: 1
        display-name: "&6Enchanted Golden Apple"

      vote_bonus:
        chance: 10
        command: "eco give {player} 250"

      vote_keys:
        chance: 5
        command: "crates give {player} vote 1"

  # ==========================================
  #                MYTHIC LOOTBOX
  # ==========================================
  Mythic:
    # Use a fancy material for mythic boxes
    material: CRYING_OBSIDIAN

    display-name: "&5&l✧ &d&lMYTHIC LOOTBOX &5&l✧"

    # Definitely enchanted for maximum glow
    enchanted: true

    lore: |
      &5✧ &dMYTHIC LOOTBOX &5✧
      &5Forged in the realm of legends
      &5Contains otherworldly power
      &5Mortals rarely witness such glory
      &eRight-click to open!

    broadcast-messages:
      - "&5 &d{player} &5has unleashed MYTHIC power and received &d{item}&5! "
      - "&5⚡ &dMYTHIC ENERGY! &5{player} &dchanneled &5{item} &dfrom beyond!"
      - "&5✦ &dThe universe bends to &5{player}&d's will - they obtained &5{item}&d!"

    rewards:
      mythic_sword:
        chance: 15
        material: NETHERITE_SWORD
        amount: 1
        display-name: "&5Blade of Eternity"

      dragon_egg:
        chance: 8
        material: DRAGON_EGG
        amount: 1
        display-name: "&5Essence of Dragons"

      nether_star:
        chance: 12
        material: NETHER_STAR
        amount: 2
        display-name: "&5Stellar Fragment"

      mythic_fortune:
        chance: 20
        command: "eco give {player} 5000"

      mythic_levels:
        chance: 18
        command: "xp add {player} 5000"

      mythic_jackpot:
        chance: 5
        command: "eco give {player} 25000"

      # Mythic permissions
      mythic_powers:
        chance: 3
        command: "lp user {player} permission set mythic.powers true"

      # Ultra mythic
      mythic_ascension:
        chance: 1
        command: "lp user {player} parent add mythic"

  # ==========================================
  #                EVENT LOOTBOX
  # ==========================================
  Event:
    # Special event material
    material: AMETHYST_BLOCK

    display-name: "&c&l♦ &4&lLIMITED EVENT BOX &c&l♦"

    # Enchanted for special events
    enchanted: true

    lore: |
      &c♦ &4LIMITED EVENT BOX &c♦
      &cSpecial rewards available
      &conly during server events!
      &cDon't miss out!
      &eRight-click to open!

    broadcast-messages:
      - "&c &4{player} &chas claimed an event prize: &4{item}&c!"
      - "&c &4EVENT LUCK! &c{player} &4received &c{item} &4from the event!"

    rewards:
      event_exclusive:
        chance: 20
        material: ENCHANTED_GOLDEN_APPLE
        amount: 3
        display-name: "&cEvent Golden Apples"

      event_money:
        chance: 25
        command: "eco give {player} 500"

      event_experience:
        chance: 20
        command: "xp add {player} 1000"

      event_special:
        chance: 15
        material: BEACON
        amount: 1
        display-name: "&cEvent Beacon"

      event_rare:
        chance: 10
        material: ELYTRA
        amount: 1
        display-name: "&cEvent Wings"

      event_jackpot:
        chance: 8
        command: "eco give {player} 2000"

      event_ultimate:
        chance: 2
        command: "crates give {player} legendary 1"

# ========================================
#              CUSTOM EXAMPLES
# ========================================
#
# You can customize each lootbox with:
#
# material: Any valid Minecraft material name
# Examples: NETHERITE_BLOCK, DIAMOND_BLOCK, GOLD_BLOCK,
#          EMERALD_BLOCK, REDSTONE_BLOCK, LAPIS_BLOCK,
#          QUARTZ_BLOCK, OBSIDIAN, CRYING_OBSIDIAN,
#          ANCIENT_DEBRIS, AMETHYST_BLOCK, etc.
#
# display-name: Custom name with color codes
# Examples: "&4&lFIRE BOX", "&b&lICE CHEST", "&a&lNATURE BOX"
#
# enchanted: true/false - adds magical glow effect
#
# ========================================
#
# Commands:
# /lootbox give Common 5 PlayerName    - Give 5 common lootboxes
# /lootbox give Legendary 1 all        - Give 1 legendary to everyone
# /lootbox give Vote 3 PlayerName      - Give 3 vote boxes
# /lootbox types                       - List all available types
# /lootbox reload                      - Reload config
# /lootbox debug                       - Entering debugging mode
#
# ========================================
 
Resource Information
Author:
----------
Total Downloads: 1,783
First Release: Apr 6, 2023
Last Update: Jul 13, 2025
Category: ---------------
All-Time Rating:
7 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings