[NMRiH] Backpack 2

This is a complete rewrite of Backpack by Ryan with added features and bug fixes.

It adds portable inventory boxes to the game. They function just like normal inventory boxes except they also pick up items that are dropped on top of them. Punching one will place it on your back and allow you to carry it around the level.

Backpacks are able to store more ammo than a regular inventory box. By default backpacks store up to 4 boxes worth of ammo per slot. This means one slot holds 4 barricade boards or 40 rounds of 9mm or 80 rounds of .22.

Backpacks are randomly colored to help distinguish them.

Video

https://user-images.githubusercontent.com/11559683/142296315-f216a804-92b9-4bff-bbfd-e247b86dc9d1.mp4

Requirements

• A web server to serve custom content (FastDL)
• SourceMod (1.12.6998 or higher is recommended for improved performance)

Installation:

• Grab the latest ZIP files from releases
• Extract nmrih-backpack-X.Y.Z.zip into the server's nmrih/addons/sourcemod directory
• Extract nmrih-backpack-assets.zip into your game server and your FastDL server (they're automatically added to the downloads table)

Using backpacks

• Punch backpack to wear it
• Press drop weapon key when fists are equipped to drop it
• Press use on a dropped backpack to access its inventory
• Drop items on top of the backpack to store them inside

What's new in 2.0

• NMRiH 1.12.1 support
• No gamedata dependency, the plugin should be less prone to breaking on new updates
• DHooks is no longer required
• Zombies can spawn with backpacks. The backpacks can contain loot.
• Configurable placement overrides, dictactes which columns items can end up in
• Backpacks can be made to blink instead of glow
• Less edicts. Backpacks consume 1 entity when created instead of 2 or 3
• No conflicts with NMS. Backpacks no longer prevent supply choppers from spawning
• Toggleable screen hints for carrying/using backpacks
• Fixed items colliding with the player when dropped

Some old features are currently unavailable, though I plan on adding them

• Speed penalties for backpack carrier
• Backpack settings: weight, admin_can_use, admin_can_wear, zombie_can_wear, colorize
• Admin menu

Backpack template options

You can configure backpack types, behavior and appareance in addons/sourcemod/configs/backpack2.cfg.

• itembox_model - Model to use on dropped backpacks.
• ornament_model - Model to render on the player's back
• sounds - Sound effects used by this backpack, see config for examples

• max_left [0-8], max_middle [0-4], max_right [0-8] - Size limit for each column of the backpack

  Example:

  "Giraffe Plushie"
  {
      "ornament_model" "models/survival/item_dufflebag_backpack.mdl"
  
      // Custom physics model
      "itembox_model" "models/anxiety/giraffe.mdl"
  
      // Play Pugman's bleeding sounds
      "sounds"
      {
          "backpack_open"
          {
              "player/bleed/pugman/bleeding02.wav" "1"
              "player/bleed/pugman/bleeding03.wav" "1"
              "player/bleed/pugman/bleeding04.wav" "1"
          }
      }
  
      // Half the capacity of a normal backpack
      "max_left" "4"
      "max_middle" "2"
      "max_right" "4"
  }

Item configs

Keys not mentioned here should be left as-is unless you know what you're doing, as they're required for the plugin to function properly.

• loot yes/no - Whether this item can be spawned as random loot for backpacks dropped by zombies

• capacity - Allows you to override the maximum capacity for a given ammo box. This affects random loot and ammo stacking.

  For example:

  // Make backpacks able to hold (20 * sm_backpack_ammo_stack_limit) boards per slot
  "ammobox_board"
  {
      "capacity"      "20"
      ...
  }

• columns - This allows you to override the placement for a given item. Valid values are left, middle and right, and they can be combined to allow for multiple columns.

  For example:

  // Move pills to the ammo column
  "item_pills"
  {
      "id" "44"
      "columns" "right"
  }
  
  // Allow hammer to overflow into the "gear" column if the "weapon" column is full
  "me_sledge"
  {
      "id" "40"
      "columns" "left middle"
  }
  
  // Prevent maglite from being added to backpacks
  "item_maglite"
  {
      "id" "42"
      "columns" ""
  }

  Cvars

Configuration variables are saved to cfg/sourcemod/plugin.backpack2.cfg

Admin Commands

• sm_backpack <userid|#name> - Gives target a backpack, requires ADMFLAG_CHEATS