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] [set] rpgloot.command.get Generate an item — all args optional
/rpgloot getall [type] rpgloot.command.getall Give one item per rarity tier
/rpgloot getset <set> <rarity> <tier> [pieces] rpgloot.command.getset Generate a full matching set for testing
/rpgloot sets [set] rpgloot.command.sets List all sets, or show a value table for one
/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 clear rpgloot.command.clear Remove all RPGLoot items from your inventory
/rpgloot reload rpgloot.command.reload Reload config.yml

Detailed usage

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

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.
  • set — optional. Forces the item to belong to a specific set (case-insensitive). If omitted, a random set is assigned.

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
/rpgloot get legendary sword diamond_sword voidwalker
/rpgloot get hero helmet diamond_helmet shadowveil

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 set names: shadowveil ironbound dawnbreaker tidecaller emberclaw stormwarden voidwalker gilded

/rpgloot getset <set> <rarity> <tier> [pieces]

Generates multiple items that all belong to the same set, rarity, and material tier — ideal for testing whether a set activates and its bonus stacks correctly.

  • set — required. The set name (tab-completes).
  • rarity — required. Rarity for all generated items.
  • tier — required. Material tier to use for the items.
  • pieces — optional. How many items to generate (2–5). Defaults to the full set for that tier.

Valid tiers: netherite diamond iron golden chainmail leather

Examples:

/rpgloot getset shadowveil legendary diamond
/rpgloot getset voidwalker hero netherite 3
/rpgloot getset gilded rare iron 2

Chainmail and leather tiers don't include a sword, so their maximum piece count is 4.

/rpgloot sets [set]

Without arguments — lists all available sets with their bonus stat.

With a set name — shows the full value table across all rarities and piece counts.

Examples:

/rpgloot sets
/rpgloot sets shadowveil
/rpgloot sets voidwalker

Output example (/rpgloot sets shadowveil):

─── ◈ Shadowveil — Dodge Chance ───
  Rarity       2pcs   3pcs   4pcs   5pcs
  Common       0.6%   1.1%   1.5%   2.0%
  Uncommon     1.1%   1.9%   2.6%   3.5%
  Rare         1.7%   3.0%   4.1%   5.5%
  Hero         2.4%   4.4%   6.0%   8.0%
  Legendary    3.3%   6.1%   8.3%  11.0%

/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 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
  Tier: DIAMOND
  Bonus at 5 pcs: +11.0% Dodge Chance

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
  Tier:   DIAMOND
  Pieces: 3/5
  Bonus:  +4.4% Dodge Chance
  Next (4 pcs): +6.0%

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

/rpgloot clear

Removes all RPGLoot items from your inventory — including armor slots. Useful for resetting between test runs.

/rpgloot clear
→ Removed 6 RPGLoot item(s) from inventory.

/rpgloot reload

Reloads config.yml from disk. Updates all live values: drop chance, rarity weights, 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.getset op /rpgloot getset
rpgloot.command.sets true /rpgloot sets — available to all players
rpgloot.command.stats true /rpgloot stats — available to all players
rpgloot.command.set true /rpgloot set — available to all players
rpgloot.command.clear op /rpgloot clear
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.

Clone this wiki locally