Compatibility Note

BetterKeepInventory 2.0.0 is a complete rewrite of the plugin.

This version introduces significant changes, so updating is only recommended if you're ready to re-learn and re-configure the plugin.

<aside> ⚠️

Automatic config migration is not available for this update!!

</aside>

Permissions

There are no more “bypass” permissions, if you still wish to use permissions to change behavior please check out Condition: Permissions below.


# Group node for player permissions
betterkeepinventory.player: true
  betterkeepinventory.command.help: true
  betterkeepinventory.version: true

# Group node for administrative permissions
betterkeepinventory.admin: OP
  betterkeepinventory.command.help: true
  betterkeepinventory.command.reload: true
  betterkeepinventory.command.registry: true
  betterkeepinventory.version: true
  betterkeepinventory.version.notify: true
  betterkeepinventory.reload: true

  # Able to view the plugins version in the main command
  betterkeepinventory.version: OP

	# Get notified about new plugin versions
  betterkeepinventory.version.notify: OP
	
	# Show the main help menu
  betterkeepinventory.command.help: true

	# View the plugins registries
  betterkeepinventory.command.registry: OP

	# Reload the plugin config
  betterkeepinventory.command.reload: OP

The bypass permissions are no more, You can now configure effects by using the Permission Condition by reading below.

Rules

Instead of defining a baseline and then overriding some behavior using overrides, the plugin now uses a rules system to determine it’s effects. What this means is that the plugin can be configured in ways that were impossible before, Below are some example snippets

# Take 10% durability damage on armor
armor_damage:
  name: "Damage Armor"
  enabled: true
  effects:
    damage:
      mode: "PERCENTAGE"
      min: 25.0
      max: 25.0
      dont_break: false
      slots:
        - "ARMOR"
      items:
        - "G:ARMOR"

A Rule that damages armor

# Drop valuables on death
drop_resources:
  name: "Always Drop Valuables"
  enabled: true
  effects:
    drop:
      mode: "PERCENTAGE"
      min: 25
      max: 25
      slots:
        - "ALL"
      items:
        - "G:RESOURCES"

A rule that drops anything in the “resources” group. (Any ores, dusts, gems and ingots)

Effects

Effects are the new names for the previously configurable sections: items, inventory, armor, exp, hunger and eco. You configure them mostly the same but now under the effects property of a rule.

Effect: Damage

Damage is the new effect that combines the previous config entries inventory, hotbar and armor. Adding this effect lets you damage items in any specified slot and of any specified material (as long as it has durability).