Regear

Restocks whitelisted items from the kit the player has loaded, without a menu. /rg and /regear are separate commands, configured separately.

The two modes

Mode	What the player does
`command`	Runs the command. Whitelisted items go straight into their inventory
`shulker`	Gets a regear , places it, and clicks the shell inside to restock

Both modes enforce the damage timer, permissions, location rules, and elytra setting. The command cooldown applies only to command mode.

Settings

config.yml

regear:
  modes:
    rg: command
    regear: command
  command-cooldown-seconds: 5
  damage-cooldown-seconds: 5
  allow-while-using-elytra: true
  prevent-putting-items-in-regear-inventory: false
  invert-whitelist: false
  whitelist:
  - ENDER_PEARL
  - END_CRYSTAL
  - OBSIDIAN
  - GLOWSTONE
  - SPLASH_POTION

Key	Type	Default
`modes.rg`	string	`command`	What `/rg` does. Use `"command"` or `"shulker"`.
`modes.regear`	string	`command`	What `/regear` does. Use `"command"` or `"shulker"`.
`command-cooldown-seconds`	integer	`5`	Seconds between restocks in command mode. `0` removes the cooldown.
`damage-cooldown-seconds`	integer	`5`	Seconds after taking damage before a player can regear. `0` switches it off.
`allow-while-using-elytra`	boolean	`true`	`false` blocks regearing while a player is .
`prevent-putting-items-in-regear-inventory`	boolean	`false`	Shulker mode only. `true` stops players using the regear shulker as extra storage.
`invert-whitelist`	boolean	`false`	`false` means `whitelist` is a list of allowed items. `true` turns it into a list of blocked items.
`whitelist`	list of string		Uppercase names. The items regear restocks, unless `invert-whitelist` is `true`.

Regear uses the last personal or public inventory kit loaded since joining. It does not use enderchest kits.

Examples

A mode for each command
Allow every item

/rg restocks instantly, /regear hands out a shulker.

config.yml

regear:
  modes:
    rg: command
    regear: shulker
  command-cooldown-seconds: 3
  damage-cooldown-seconds: 5
  allow-while-using-elytra: false
  prevent-putting-items-in-regear-inventory: true
  invert-whitelist: false
  whitelist:
  - ENDER_PEARL
  - OBSIDIAN

An inverted whitelist left empty blocks nothing, so every item is restocked.

config.yml

regear:
  modes:
    rg: command
    regear: command
  command-cooldown-seconds: 10
  damage-cooldown-seconds: 5
  allow-while-using-elytra: true
  invert-whitelist: true
  whitelist: []

Turn regear off for a group

perplayerkit.use includes regear. Remove perplayerkit.regear from a group to keep regear for the others.

/lp group default permission set perplayerkit.regear false

World and region rules

Use locations.regear to choose where regear commands and items work. Item use is checked again at the current position.

config.yml

locations:
  regear:
    mode: deny
    entries: ["world:protected_area"]

This blocks regear inside protected_area in the world named world. Replace both names with your own. The global rule also applies. See Worlds and regions for allow mode and overlapping regions.

Reconnecting and switching servers

Regear remembers the last personal or public kit you loaded, even after reconnecting or a server restart. Automatic rekit uses the same saved selection. The last loaded enderchest slot is saved separately. After upgrading from a version that kept selections only in memory, load a kit once to save your choice. Existing kit contents are preserved. Servers sharing MySQL, PostgreSQL, or Redis read the same saved choices when players join. Use matching kit slot limits and public kit definitions. This does not synchronize players who are already online on another server. See Shared storage for setup.

Start here

Features

Commands

Settings

Managing data

Common issues

For developers

The two modes

Settings

Examples

Turn regear off for a group

World and region rules

Reconnecting and switching servers

​The two modes

​Settings

​Examples

​Turn regear off for a group

​World and region rules

​Reconnecting and switching servers

The two modes

Settings

Examples

Turn regear off for a group

World and region rules

Reconnecting and switching servers