Skip to content

Commands

Jump to bottom
okereke-dev edited this page Jul 2, 2026 · 5 revisions

Commands

All RPGLoot commands are prefixed with /rpgloot. All arguments support tab-complete.

Command list

Command Permission Description
/rpgloot get [rarity] [type] [material] rpgloot.command.get Generate an item with the given rarity, type, and material
/rpgloot getall [type] rpgloot.command.getall Give one item per rarity tier
/rpgloot stats rpgloot.command.stats Inspect the rarity and bonus stats of the held item
/rpgloot set rpgloot.command.set View your currently active set bonus
/rpgloot reload rpgloot.command.reload Reload config.yml (updates drop chances and rarity weights live)

Detailed usage

/rpgloot get [rarity] [type] [material]

Generates a single item and adds it to your inventory.

  • rarity — optional. If omitted, a random rarity is picked.
  • type — optional. Filters which item type is generated.
  • material — optional. If omitted, a random material from the type pool is picked.

Examples:

/rpgloot get
/rpgloot get legendary
/rpgloot get rare sword
/rpgloot get hero sword diamond_sword
/rpgloot get hero armor diamond_chestplate
/rpgloot get rare pickaxe iron_pickaxe

Valid rarities: common uncommon rare hero legendary

Valid types: sword axe axe_tool trident mace bow crossbow helmet chestplate leggings boots pickaxe shovel hoe fishing_rod

Valid weapon materials:

wooden_sword  stone_sword  iron_sword  golden_sword  diamond_sword  netherite_sword
wooden_axe    stone_axe    iron_axe    golden_axe    diamond_axe    netherite_axe
trident       mace         bow         crossbow

Valid armor materials:

leather_helmet      chainmail_helmet      iron_helmet      golden_helmet      diamond_helmet      netherite_helmet
leather_chestplate  chainmail_chestplate  iron_chestplate  golden_chestplate  diamond_chestplate  netherite_chestplate
leather_leggings    chainmail_leggings    iron_leggings    golden_leggings    diamond_leggings    netherite_leggings
leather_boots       chainmail_boots       iron_boots       golden_boots       diamond_boots       netherite_boots

Valid tool materials:

wooden_pickaxe  stone_pickaxe  iron_pickaxe  golden_pickaxe  diamond_pickaxe  netherite_pickaxe
wooden_shovel   stone_shovel   iron_shovel   golden_shovel   diamond_shovel   netherite_shovel
wooden_hoe      stone_hoe      iron_hoe      golden_hoe      diamond_hoe      netherite_hoe
wooden_axe (axe_tool)  stone_axe  iron_axe  golden_axe  diamond_axe  netherite_axe
fishing_rod

/rpgloot getall [type]

Generates one item per rarity tier (5 items total). Useful for comparing rarities side by side.

  • type — optional. Filters the pool to a specific item type.

Examples:

/rpgloot getall
/rpgloot getall sword
/rpgloot getall helmet
/rpgloot getall pickaxe
/rpgloot getall axe_tool

/rpgloot stats

Reads and displays the rarity, bonus stats, and set membership of the item currently held in your main hand.

Output example:

─── Item Stats ───
Rarity: Legendary
  Crit Chance: +18%
  Bleeding: +62%
  Set: ◈ Shadowveil
  Bonus: +11.0% Dodge at 5 pcs

Returns an error if the held item has no rarity data.

/rpgloot set

Shows your currently active set bonus — the set with the most matching pieces you currently have equipped (armor slots + main hand weapon).

Output example:

─── Active Set ───
  Set:      ◈ Shadowveil
  Rarity:   Hero
  Material: DIAMOND_HELMET
  Pieces:   3/5
  Bonus:    +4.5% Dodge
  Next (4 pcs): +6.0%

A set requires at least 2 pieces sharing the same set name, rarity, and material to activate. See Sets for full details.

/rpgloot reload

Reloads config.yml from disk. Updates all live values: drop chance, rarity weights (normalized automatically if they don't sum to 100), boss drop settings, and structure loot chance.

Does not re-roll stats on already-generated items — those are stored permanently in the item's data.

Permissions

Permission Default Description
rpgloot.* — Grants all RPGLoot permissions
rpgloot.admin op Grants all admin commands
rpgloot.command.get op /rpgloot get
rpgloot.command.getall op /rpgloot getall
rpgloot.command.stats true /rpgloot stats — available to all players by default
rpgloot.command.set true /rpgloot set — available to all players by default
rpgloot.command.reload op /rpgloot reload
rpgloot.drops true Receive drops from regular hostile mobs
rpgloot.boss.drops true Receive drops from boss mobs
rpgloot.sets true Benefit from set bonuses
rpgloot.loot.structure true Receive items from structure chests

Removing rpgloot.drops or rpgloot.sets from a player or group disables that feature for them individually — useful for kit servers or restricted game modes.

Clone this wiki locally