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.

CarryCap

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

It runs entirely on the server. Players joining a server with CarryCap installed do not need to install the mod themselves.

Features

• Set limits for specific items
• Set shared limits for item tags
• Server-side only
• Works in singleplayer
• Counts the inventory, hotbar, armor and offhand
• Counts matching items inside carried bundles and shulker boxes
• Reload the config without restarting the server

Configuration

Limits are stored in:

config/carrycap.json

Example:

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