CarryCap

CarryCap lets server admins set limits on how many configured items each player can carry.

It runs entirely on the Fabric server, so players joining a dedicated server do not need to install the mod themselves.

Limits are configured in:

config/carrycap.json

Rules can target either a specific item ID or an item tag. After editing the config, operators can reload it with:

/carrycap reload

What counts as carried?

CarryCap checks:

• Main inventory
• Hotbar
• Armor slots
• Offhand
• Menu cursor
• Matching items inside carried vanilla bundles
• Matching items inside carried vanilla shulker boxes

Ground pickups that would exceed a limit stay on the ground.

If another vanilla inventory action causes a player to exceed a limit, CarryCap drops the excess items at the player's position during the same server tick.

If the violation comes from items stored inside a portable container, such as a shulker box, the container itself is dropped intact instead of modifying its contents.

Example configuration

{
  "limits": [
    {
      "type": "item",
      "id": "minecraft:totem_of_undying",
      "max": 2
    },
    {
      "type": "tag",
      "id": "minecraft:logs",
      "max": 128
    }
  ]
}

Setting "max": 0 prevents players from carrying matching items entirely.

Requirements

• Minecraft 1.21.11
• Fabric Loader
• Fabric API
• Java 21

Current limitations

CarryCap 0.1.0 is an early functional release.

Custom storage systems added by other mods are currently not counted. World storage such as chests and ender chests is also not considered part of a player's carried inventory.