AdvancedLootBags | Custom Loot Bags for Modern Servers -----
Custom loot bags with Oraxen, ItemsAdder, Nexo & SupremeTags support.Usage & Documentation
Commands:
Aliases:
Permissions:
Supported reward/item types:
Integration diagnostics:
Use /lootbag integrations to check whether AdvancedLootBags can detect and use your installed integrations.
This is useful for checking:
Loot Bag YAML Reference:
Fallback items:
Fallback items are useful when a custom item plugin is not installed, not loaded, or the configured custom item ID cannot be found.
SupremeTags modes:
Effect options:
Full effects example:
Legacy message format:
The older format still works for simple messages:
Placeholders:
How to use bags in other loot plugins:
Works with:
Tips:
Commands:
- /lootbag give <player> <bag> [amount] — Gives a loot bag to a player
- /lootbag list — Lists all loaded loot bags
- /lootbag validate — Validates loaded loot bag configs
- /lootbag integrations — Shows detected/available integrations
- /lootbag reload — Reloads all configs
Aliases:
- /alb
- /advancedlootbags
Permissions:
- advancedlootbags.give — use /lootbag give
- advancedlootbags.list — use /lootbag list
- advancedlootbags.validate — use /lootbag validate
- advancedlootbags.integrations — use /lootbag integrations
- advancedlootbags.reload — use /lootbag reload
Supported reward/item types:
- Vanilla: material, amount, display-name, lore, custom-model-data
- Nexo: nexo-id: "item_id"
- Oraxen: oraxen-id: "item_id"
- ItemsAdder: itemsadder-id: "namespace:item_id" or itemadder-id: "namespace:item_id"
- SupremeTags: supremetags-id: "tag_id" or supremetags-tag: "tag_id"
- Commands: command: "command here"
Integration diagnostics:
Use /lootbag integrations to check whether AdvancedLootBags can detect and use your installed integrations.
This is useful for checking:
- Nexo installed / usable
- Oraxen installed / usable
- ItemsAdder installed / usable
- SupremeTags installed / usable
Loot Bag YAML Reference:
name: '<gradient:#FFDD00:#FF006E>Advanced Loot Bag</gradient>'
item:
material: BUNDLE
custom-model-data: 9001
display-name: '<gradient:#44c767:#1e90ff>Advanced Loot Bag'
lore:
- '<gray>Contains vanilla and custom rewards!'
- '<yellow>Right-click to open.'
rolls: 3
contents:
vanilla_diamond:
item:
material: DIAMOND
amount: 3
display-name: '<aqua>Vanilla Diamond'
weight: 10
effects:
action-bar: '<aqua>You received diamonds!'
sound: ENTITY_PLAYER_LEVELUP
custom_model_item:
item:
material: STICK
custom-model-data: 1337
display-name: '<green>Magic Stick'
lore:
- '<gray>A vanilla custom-model-data reward.'
weight: 6
effects:
title:
title: '<green>Magic Stick!'
subtitle: '<gray>Custom model data reward'
fade-in: 10
stay: 40
fade-out: 10
nexo_reward:
item:
nexo-id: 'magic_sword'
fallback:
material: DIAMOND_SWORD
display-name: '<yellow>Fallback Magic Sword'
weight: 3
effects:
chat: '<green>You received a Nexo reward!'
sound: ENTITY_VILLAGER_YES
oraxen_reward:
item:
oraxen-id: 'wizard_staff'
fallback:
material: BLAZE_ROD
display-name: '<yellow>Fallback Wizard Staff'
weight: 3
effects:
title:
title: '<gold>Oraxen Reward!'
subtitle: '<yellow>Wizard Staff'
particles:
type: ENCHANT
count: 30
itemsadder_reward:
item:
itemsadder-id: 'my_items:epic_axe'
fallback:
material: IRON_AXE
display-name: '<yellow>Fallback Epic Axe'
weight: 3
effects:
action-bar: '<blue>You received an ItemsAdder item!'
sound:
name: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.2
supremetags_voucher:
item:
material: NAME_TAG
display-name: '<light_purple>Donator Tag Voucher'
supremetags-tag: 'donator'
supremetags-mode: voucher
weight: 2
effects:
broadcast: '<gold>%player%</gold> found a rare tag voucher!'
status-bar:
message: '<light_purple>Rare Tag Reward!'
color: PURPLE
overlay: PROGRESS
progress: 1.0
duration-ticks: 80
command_reward:
item:
material: PAPER
display-name: '<green>Money Reward'
command: 'eco give %player% 1000'
weight: 5
effects:
chat: '<green>You received $1000!'
sound: ENTITY_EXPERIENCE_ORB_PICKUP
item:
material: BUNDLE
custom-model-data: 9001
display-name: '<gradient:#44c767:#1e90ff>Advanced Loot Bag'
lore:
- '<gray>Contains vanilla and custom rewards!'
- '<yellow>Right-click to open.'
rolls: 3
contents:
vanilla_diamond:
item:
material: DIAMOND
amount: 3
display-name: '<aqua>Vanilla Diamond'
weight: 10
effects:
action-bar: '<aqua>You received diamonds!'
sound: ENTITY_PLAYER_LEVELUP
custom_model_item:
item:
material: STICK
custom-model-data: 1337
display-name: '<green>Magic Stick'
lore:
- '<gray>A vanilla custom-model-data reward.'
weight: 6
effects:
title:
title: '<green>Magic Stick!'
subtitle: '<gray>Custom model data reward'
fade-in: 10
stay: 40
fade-out: 10
nexo_reward:
item:
nexo-id: 'magic_sword'
fallback:
material: DIAMOND_SWORD
display-name: '<yellow>Fallback Magic Sword'
weight: 3
effects:
chat: '<green>You received a Nexo reward!'
sound: ENTITY_VILLAGER_YES
oraxen_reward:
item:
oraxen-id: 'wizard_staff'
fallback:
material: BLAZE_ROD
display-name: '<yellow>Fallback Wizard Staff'
weight: 3
effects:
title:
title: '<gold>Oraxen Reward!'
subtitle: '<yellow>Wizard Staff'
particles:
type: ENCHANT
count: 30
itemsadder_reward:
item:
itemsadder-id: 'my_items:epic_axe'
fallback:
material: IRON_AXE
display-name: '<yellow>Fallback Epic Axe'
weight: 3
effects:
action-bar: '<blue>You received an ItemsAdder item!'
sound:
name: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.2
supremetags_voucher:
item:
material: NAME_TAG
display-name: '<light_purple>Donator Tag Voucher'
supremetags-tag: 'donator'
supremetags-mode: voucher
weight: 2
effects:
broadcast: '<gold>%player%</gold> found a rare tag voucher!'
status-bar:
message: '<light_purple>Rare Tag Reward!'
color: PURPLE
overlay: PROGRESS
progress: 1.0
duration-ticks: 80
command_reward:
item:
material: PAPER
display-name: '<green>Money Reward'
command: 'eco give %player% 1000'
weight: 5
effects:
chat: '<green>You received $1000!'
sound: ENTITY_EXPERIENCE_ORB_PICKUP
Fallback items:
Fallback items are useful when a custom item plugin is not installed, not loaded, or the configured custom item ID cannot be found.
item:
oraxen-id: 'wizard_staff'
fallback:
material: BLAZE_ROD
display-name: '<yellow>Fallback Wizard Staff'
lore:
- '<gray>The custom item was not available.'
oraxen-id: 'wizard_staff'
fallback:
material: BLAZE_ROD
display-name: '<yellow>Fallback Wizard Staff'
lore:
- '<gray>The custom item was not available.'
SupremeTags modes:
- voucher — tries to give the configured tag as a voucher
- permission — gives/uses permission based unlock logic
- command — use a configured command for full control
# Voucher-style reward
vip_tag_voucher:
item:
material: NAME_TAG
display-name: '<light_purple>VIP Tag Voucher'
supremetags-tag: vip
supremetags-mode: voucher
weight: 2
# Command-style reward
donator_tag_command:
item:
material: NAME_TAG
display-name: '<gold>Donator Tag'
supremetags-tag: donator
supremetags-mode: command
command: 'tags givevoucher %player% donator'
weight: 1
vip_tag_voucher:
item:
material: NAME_TAG
display-name: '<light_purple>VIP Tag Voucher'
supremetags-tag: vip
supremetags-mode: voucher
weight: 2
# Command-style reward
donator_tag_command:
item:
material: NAME_TAG
display-name: '<gold>Donator Tag'
supremetags-tag: donator
supremetags-mode: command
command: 'tags givevoucher %player% donator'
weight: 1
Effect options:
- chat — sends a chat message to the player
- action-bar / actionbar — shows an action bar message
- title — shows title and subtitle
- status-bar / boss-bar — shows a boss bar style status message
- sound — plays a sound
- particles — spawns particles around the player
- broadcast — broadcasts a message to the server
Full effects example:
effects:
chat: '<green>You got %reward_id%!'
action-bar: '<aqua>Reward claimed!'
title:
title: '<gold>Loot Bag Opened!'
subtitle: '<yellow>%reward_id%'
fade-in: 10
stay: 40
fade-out: 10
status-bar:
message: '<gold>%bag_name%</gold>'
color: YELLOW
overlay: PROGRESS
progress: 1.0
duration-ticks: 60
sound:
name: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.0
particles:
type: HAPPY_VILLAGER
count: 25
broadcast: '<gold>%player%</gold> found <yellow>%reward_id%</yellow>!'
chat: '<green>You got %reward_id%!'
action-bar: '<aqua>Reward claimed!'
title:
title: '<gold>Loot Bag Opened!'
subtitle: '<yellow>%reward_id%'
fade-in: 10
stay: 40
fade-out: 10
status-bar:
message: '<gold>%bag_name%</gold>'
color: YELLOW
overlay: PROGRESS
progress: 1.0
duration-ticks: 60
sound:
name: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.0
particles:
type: HAPPY_VILLAGER
count: 25
broadcast: '<gold>%player%</gold> found <yellow>%reward_id%</yellow>!'
Legacy message format:
The older format still works for simple messages:
title: '<green>You won!'
message-type: actionbar
sound: ENTITY_PLAYER_LEVELUP
message-type: actionbar
sound: ENTITY_PLAYER_LEVELUP
Placeholders:
- %player% — player name
- %bag_id% — internal bag ID
- %bag_name% — configured bag name
- %reward_id% — internal reward ID
How to use bags in other loot plugins:
- Use /lootbag give <player> <bag> to get the bag
- Hold it in your hand
- Run /data get entity @p SelectedItem
- Copy the item/NBT output into your mob drop, crate, chest or loot plugin
Works with:
- Mob drop plugins
- Crate plugins
- Vote reward plugins
- Chest loot plugins
- RoseLoot, LevelledMobs, EliteMobs and similar loot plugins
- Servers using Nexo, Oraxen, ItemsAdder or SupremeTags
Tips:
- Run /lootbag integrations after installing or updating custom item plugins
- Run /lootbag validate after editing YAML files
- Use fallback items for custom rewards so bags still work if an integration is missing
- Use command rewards if a custom plugin changes its API or you want full control
- Use broadcasts only for rare rewards to avoid chat spam
Resource Information
Author:
----------
Total Downloads: 400
First Release: Jun 26, 2025
Last Update: May 20, 2026
Category: ---------------
All-Time Rating:
Find more info at minecraft.saltyy.at...3 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings