Skip to main content
The regear system lets players quickly restock consumables and key items from their currently loaded kit mid-match — no need to open inventories or visit the kit room. Both /rg and /regear are separate commands that you can configure independently, giving you the flexibility to assign different behaviors to each alias. Cooldowns and a post-damage timer prevent abuse in competitive formats.

​
Modes

Command Mode

Directly restocks whitelisted items from the player’s loaded kit into their inventory. Instant and invisible — no physical block required. The command-cooldown governs how often a player can trigger it.

Shulker Mode

Gives the player a physical shulker box. The player places it, opens it, and clicks the items they want to take. The shulker disappears after use. Ideal when you want players to make deliberate item-by-item choices.

​
Full Configuration Block

config.yml
regear:
  rg-mode: "command"
  regear-mode: "command"
  command-cooldown: 5
  damage-timer: 5
  allow-while-using-elytra: true
  invert-whitelist: false
  whitelist:
    - ENDER_PEARL
    - END_CRYSTAL
    - OBSIDIAN
    - GLOWSTONE
    - RESPAWN_ANCHOR

​
Configuration Reference

​
rg-mode
string
default:"command"
Controls the behavior of the /rg command. Accepted values: "command" or "shulker".
​
regear-mode
string
default:"command"
Controls the behavior of the /regear command. Accepted values: "command" or "shulker". Configure this independently from rg-mode to assign different behaviors to each alias.
​
command-cooldown
integer
default:"5"
The number of seconds a player must wait between successive uses of the regear command. Set to 0 to remove the cooldown entirely.
​
damage-timer
integer
default:"5"
The number of seconds a player must wait after taking damage before they can use the regear command. This prevents players from immediately restocking during active combat. Set to 0 to disable the damage restriction.
​
allow-while-using-elytra
boolean
default:"true"
Set to false to block players from triggering the regear command while they are gliding with an elytra. Useful for servers where mid-air restocking would be an unfair advantage.
​
invert-whitelist
boolean
default:"false"
When false, the whitelist is treated as an allowlist — only items on the list can be restocked. When true, the list becomes a blacklist — all items except those listed can be restocked. Set invert-whitelist: true with an empty whitelist to allow every item in the player’s kit to be restocked.
​
whitelist
list
A list of Bukkit Material names (uppercase, underscore-separated). Determines which items the regear command restocks, subject to the invert-whitelist setting. Add any valid Bukkit Material name.

​
Example Configurations

The simplest setup: both /rg and /regear behave identically.
config.yml
regear:
  rg-mode: "command"
  regear-mode: "command"
  command-cooldown: 5
  damage-timer: 5
  allow-while-using-elytra: true
  invert-whitelist: false
  whitelist:
    - ENDER_PEARL
    - END_CRYSTAL
    - OBSIDIAN
When using shulker mode, a command-cooldown of 0 or a very low value is recommended. Because the player must physically place and interact with the shulker box, the mechanic itself already introduces natural pacing — a long cooldown on top of that creates a frustrating experience.