XPackage

Works with

About XPackage

Create custom items like pouches, kits, medkits, and more—each filled with valuable gear. Customize everything from item names, blueprints, skins, to drop chances, giving you full control. Set permissions to open packages, and even open entire stacks at once for command-only items. Packages can be found in crates, barrels, or via metal detectors, and they stack, split, and drop seamlessly. Chat messages notify players when they open a package, but beware—these packs can't be recycled!

Key Features

There is a lang ru/en/uk/es.
Customization of items (command(s), blueprint, item, custom item): shortname, amount, skinID, text(for note), custom name, blueprint, drop chance, water amount(for bottle, water jug, bota bag), command list)
For commands: {0} is steamID | {1} is amount
Various settings for the packages themselves.
Setting the permission to open a package.
Ability to open the entire stack at once. [ Useful for packages that only have command(s) ].
Ability to customize package stack.
Chat messages after opening a package.
Ability to find the package in crates/barrels.
Ability to find the package with a metal detector.
Stack, split, drop packages works correctly.
Packs cannot be recycled.

WORK WITH BetterLoot

For the correct spawning of packages in the crate, in the BetterLoot plugin, remove/comment out the following line of code.
630 - container.inventory.capacity = container.inventory.itemList.Count;

Permissions

xpackage.admin - allow a player(administrator) to use the command to give packages.

Commands

give_package steamID packageSkinID amount - to give a package to a player.

API

bool IsItemPackage(Item item) - whether the item is a package.
bool IsSkinPackage(ulong skinID) - whether the skin is a package.

Config

{
  "General settings": {
    "SteamID profile for custom avatar": 0,
    "Chat prefix": "<size=12><color=#FFFFFF50>[</color> <color=#00FF0050>XPackage</color> <color=#FFFFFF50>]</color></size>\n"
  },
  "Package settings": {
    "0": {
      "Shortname": "halloween.lootbag.large",
      "Custom package name": "Medication kit",
      "Action at which the package will be opened": "unwrap",
      "Maximum stack - [ True - x1 | False - stack of original item ]": true,
      "Whole stack opens at once. [ Useful for packages that only have command(s) ]": false,
      "Permission to open a package": null,
      "Effect of opening the package": "assets/prefabs/misc/xmas/presents/effects/unwrap.prefab",
      "Enable the ability to find a package with a metal detector": false,
      "Chance of finding the package with a metal detector [ 0.0 - 100.0 ]": 0.0,
      "List of items in the package": [
        {
          "Shortname": "largemedkit",
          "Amount": 1,
          "SkinID": 0,
          "Text": null,
          "CustomName": null,
          "BlueprintID": 0,
          "Drop chance [ 0.0 - 100.0 ]": 100.0,
          "WaterAmount": 0,
          "CommandsList - [ {0} is steamID | {1} is amount ]": null
        },
		...
      ],
      "Which crates/barrels will spawned a package": [
        {
          "Name crate/barrel": "crate_normal",
          "Drop chance [ 0.0 - 100.0 ]": 20.0,
          "Min amount": 1,
          "Max amount": 1
        },
		...
      ]
    },
	...
  }
}

Monster's Collection