Inventory Weight [1.16 - 1.21]

• Player speed decreases as their inventory weight grows.
• Customize the range of movement speed
• Set the percentage of weight capacity where you want the player's speed to begin decreasing.
• Customize the weight of each item by material, item name, or through the item lore with lore tags.
• Customize messages in the plugin to fit your needs and cater to different languages.
• Freeze player movement at a given max weight.
• Per player weight capacity with permissions (See the inventoryweight.maxweight permission node).
• Placeholder API support
• Configure which worlds use this plugin
• Custom model id configuration to support custom item plugins!

/iw help - returns a help message than can be configured in the messages.yml file
/iw weight - shows your current weight and speed. Note: this command will not work if the user has the inventoryweight.off permission, the user is in creative or weight is disabled in the given world.
/iw get - returns the weight of the item in your main hand
/iw get [Material Name] - returns the default weight for a material
/iw reload - reloads the config.yml, this allows you to make changes to the config while the server is running.


inventoryweight.reload - gives permission for a player to reload the config.yml.

inventoryweight.off - the given player is not affected by the inventory weight plugin.

inventoryweight.maxweight.[maxweight value] - if a player has this permission set their max weight will be the given value. For example, if a player has the permission inventoryweight.maxweight.100, then their max weight will be 100, this overrides the default max weight.

• %inventoryweight_weight%
• %inventoryweight_maxweight%
• %inventoryweight_speed%
• %inventoryweight_inventorybar%
• %inventoryweight_weightPercentage%

The config.yml can be used to change the way this plugin works. You can use min walk speed and max walk speed to control how fast or slow players can move at the maximum weight and 0. The max weight limit is used for all players (multiple max weights can be set via permission nodes). At the weight limit, the player will reach the minimum speed or lose the ability to move completely (this can be changed in the configuration file). A disable movement flag can be set true and the player will not be able to move once at maximum capacity. The weight of each item can be set in the config either by material, by display name, or using lore tags. If the weight of an item isn't set then it will take on the default weight.

The beginSlowdown value in the config allows you to set a percentage of the weight limit capacity that you want speed changes to begin to be applied to the player.

Lore Tags



An important part of the configuration is the 'loreTag' value, which lets you control the weight of an item from the item lore. This is great for custom items, see the image above. It works by setting a lore tag in the config for example "Weight:". To set a custom weight you would need to have a line in the item lore equal to something like "Weight: 17.8" The item would have a weight of 17.8. The plugin is looking for a number in the same line as the given tag. There must be a space key in front of the number. This is the highest priority way to set the weight of an item.

Additionally, there is a capacityTag value in the config. Use this to set a lore tag similar to the above. This tag will increase the max weight of the player holding the item.

Read the full description on SpigotMC →