About Weight-RPG
From SpigotMCInventory weight mechanic just like in RPGs!
Description
Have you ever played RPG games like The Elder Scrolls, Fallout, or The Witcher? Did you notice that you can’t carry too many items? Do you ever wonder how realistic this feature would be in Minecraft? Well, now, with the Weight-RPG plugin, you can live it! Weight-RPG allows you to configure the weight of all Minecraft items. Upon reaching a specific inventory weight, the player will move slowly or even be unable to move and jump altogether.
Features
- Assign weight value to every item.
- Custom weight for custom items by their names.
- Boost Items that grant additional weight capacity.
- There are three weight levels, so you can 'punish' players differently in each one. You can disable any level you want.
- You can use permissions for weight level.
- You can set the item's weight using the command /weight set <item> <weight value>
- Players with permission weight.notify get a message for items that aren't in weight files. You can add them manually or use the command /weight add <item> <weight value>.
- Custom weight values and penalties for every weight level before it takes effect.
- You can disable jumps and movement for the player at any level you want.
- You can disable players from picking up items at any level.
- 100% customizable messages in messages.yml file.
- HEX color support.
- Messages for pick-up, drop, or place items.
- 16 custom placeholders to use in messages.
- Messages can be sent via action-bar or chat.
- You can disable the plugin in certain worlds.
- Players can have a cooldown for dropping items. This is to prevent players from throwing items to have maximum speed. You can disable this feature and modify the cooldown in seconds in the config file.
- You can view an item's weight using the /weight get <item> command.
- WorldGuard support. You can use the 'weight-rpg' flag to prevent the plugin from being used in certain regions (WorldGuard version 7.0 or later).
- PlaceholderAPI support. You can use all these placeholders in any plugin that supports PlaceholderAPI (2.10.0 version or above).
The plugin checks the player's inventory every 3 seconds (configurable in config.yml) and when he drops, picks up, or places an item. The Items' weight values are in the Weight files.
(Blocks Weight.json, Tools and Weapons Weight.json, Misc Items Weight.json)
There, you will find all Minecraft items and their weight value.
You need to re-assign all the item values to your needs. But don't worry, it's one-time work. After that, remember to use '/weight reload' to apply the changes to the server. The plugin now calculates the player's inventory. If the value is more significant than your weight on the config file, it will penalize the player.
It works only when the player is in Survival or Adventure mode.
(Blocks Weight.json, Tools and Weapons Weight.json, Misc Items Weight.json)
There, you will find all Minecraft items and their weight value.
You need to re-assign all the item values to your needs. But don't worry, it's one-time work. After that, remember to use '/weight reload' to apply the changes to the server. The plugin now calculates the player's inventory. If the value is more significant than your weight on the config file, it will penalize the player.
It works only when the player is in Survival or Adventure mode.
Default item assignment
First, when the plugin loads for the first time, it will create 2 files (config.yml, messages.yml) and 1 folder. In the config file, you can configure the plugin. In the messages file, you can customize messages to your needs. In the Weights folder, you will find 3 additional files. There, you will assign the weight values for the items (ex DIRT=5). You must follow the format “ item=value” and for float values, use dot ‘.’ not comma ‘,’. There are 3 files for a more straightforward assignment. You must assign the weight values. DON’T USE THE DEFAULT ONES.
Custom item assignment
After you configure the config file and assign all the weight values to items, use the command ‘/weight reload’ to apply the changes to the server. That’s it. To assign a weight value to a custom item, go to the config file in the “ custom-items-weight” section and write the name with color codes like the examples. You can use hex color with &#(color code).
&c&lThunder Sword=20 (Use the same format as mentioned above.)
&c&lThunder Sword=20 (Use the same format as mentioned above.)
Boost Items Functionality
These special items can grant players additional weight-carrying capacity. When players have Boost Items in their inventory, their maximum weight capacity will increase, allowing them to carry more items without reaching the weight threshold. To define Boost Items and their respective weight enhancements, navigate to the config.yml file. Under the "boost-items" section, add the names of the Boost Items and their associated weight values. The format used is "itemname=boost_weight," which is similar to the custom item assignment.
Command and Permissions
- /weight
Permission: weight.use
Description: show the player weight and other info from messages.yml.
- /weight help
Permission: weight.help
Description: show the player plugin's command from messages.yml - /weight reload
Permission: weight.reload
Description: reload all files and apply changes to the server.
- /weight get <item>
Permission: weight.get
Description: show the item's weight.
- /weight set <item> <weight value>
Permission: weight.set
Description: set the item's weight.
Highlights
From source dataGame versions
Supports 8 Minecraft versions, the newest being 1.20.
Loaders
Runs on Spigot and Paper.
Footprint
Rated a light load on a server.
Weight-RPG on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Spigot, Paper
- Server load
- light
- Smallest plan we suggest
- Minecraft — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 2.15, released 2023-12-21
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Paper | 1.13 to 1.20 (8 versions) | 1.20 |
| Spigot | 1.13 to 1.20 (8 versions) | 1.20 |
From 10 recorded builds of Weight-RPG.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 2.15 | 2023-12-21 | 1.13 to 1.20 (8 versions) | Spigot, Paper |
| 2.14.3 | 2023-12-18 | n/a | Spigot, Paper |
| 2.14.2 | 2023-12-08 | n/a | Spigot, Paper |
| 2.14.1 | 2023-11-20 | n/a | Spigot, Paper |
| 2.14 | 2023-07-26 | n/a | Spigot, Paper |
| 2.13 | 2023-07-18 | n/a | Spigot, Paper |
Run Weight-RPG on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogListed on SpigotMC as “Plugins”
Quality of life & UI
Small conveniences, tweaks and interface improvements players notice straight away.
Runs on your server
From source side supportSpigotMC lists Weight-RPG as required on the server. Check its SpigotMC page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- SpigotPaper
- Runs on
- Serverrequired on the server
- Game versions
- 1.20 and 7 earlier
- Requires
- One-click install needs a Paper server.
Verified at the source
- ✓SpigotMCOfficial listing, checked 2026-10-02Open ↗
- ✓AuthorTed_2001, as published on SpigotMC
- ✓LicenseNot published by the sourceFree
