Skip to content

SpawnKit ​

Description ​

SpawnKit lets players claim named kits in a container placed at their position. Regular players spend one use from their balance for each successful claim. Superadmins can claim kits without spending a balance.

Configuration ​

Default configuration ​

SpawnKit.json
json
{
    "m_Enable": 0,
    "m_Logging": 1,
    "m_Kits": [
        {
            "m_Name": "starter",
            "m_Container": "AC_SpawnKit_SeaChest",
            "m_Items": [
                {
                    "m_Class": "BakedBeansCan",
                    "m_Stack": 1,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Canteen",
                    "m_Stack": 1000,
                    "m_Attachments": []
                },
                {
                    "m_Class": "MakarovIJ70",
                    "m_Stack": 1,
                    "m_Attachments": [
                        {
                            "m_Class": "Mag_IJ70_8Rnd",
                            "m_Stack": 8,
                            "m_Attachments": []
                        }
                    ]
                }
            ]
        },
        {
            "m_Name": "medical",
            "m_Container": "AC_SpawnKit_SeaChest",
            "m_Items": [
                {
                    "m_Class": "BandageDressing",
                    "m_Stack": 4,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Morphine",
                    "m_Stack": 1,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Epinephrine",
                    "m_Stack": 1,
                    "m_Attachments": []
                },
                {
                    "m_Class": "DisinfectantSpray",
                    "m_Stack": 100,
                    "m_Attachments": []
                }
            ]
        },
        {
            "m_Name": "survival",
            "m_Container": "AC_SpawnKit_SeaChest",
            "m_Items": [
                {
                    "m_Class": "KitchenKnife",
                    "m_Stack": 1,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Matchbox",
                    "m_Stack": 100,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Compass",
                    "m_Stack": 1,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Rope",
                    "m_Stack": 1,
                    "m_Attachments": []
                }
            ]
        },
        {
            "m_Name": "hunter",
            "m_Container": "AC_SpawnKit_SeaChest",
            "m_Items": [
                {
                    "m_Class": "SKS",
                    "m_Stack": 1,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Ammo_762x39",
                    "m_Stack": 20,
                    "m_Attachments": []
                },
                {
                    "m_Class": "HuntingKnife",
                    "m_Stack": 1,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Binoculars",
                    "m_Stack": 1,
                    "m_Attachments": []
                }
            ]
        },
        {
            "m_Name": "food",
            "m_Container": "AC_SpawnKit_SeaChest",
            "m_Items": [
                {
                    "m_Class": "BakedBeansCan",
                    "m_Stack": 1,
                    "m_Attachments": []
                },
                {
                    "m_Class": "TunaCan",
                    "m_Stack": 1,
                    "m_Attachments": []
                },
                {
                    "m_Class": "SodaCan_Cola",
                    "m_Stack": 330,
                    "m_Attachments": []
                },
                {
                    "m_Class": "Rice",
                    "m_Stack": 1000,
                    "m_Attachments": []
                }
            ]
        }
    ],
    "m_Messages": {
        "m_PackDelivered": "The kit has been delivered.",
        "m_AlreadyReceived": "You have no remaining uses for this kit.",
        "m_Failed": "Unable to deliver the kit. Contact an administrator.",
        "m_InvalidData": "Unable to read or initialize your kit balance. Contact an administrator.",
        "m_UnknownKit": "Kit not found.",
        "m_Usage": "Usage: /spawnkit <name>"
    }
}

Options ​

OptionTypeDescription
m_EnableboolWith 1, enables the module. With 0, disables it.
m_LoggingboolWith 1, logs successful claims. With 0, skips those records. Operational errors are still logged.
m_Kitsarray<object>Available kits.
m_MessagesobjectClaim notifications.

m_Kits[] ​

OptionTypeDescription
m_NamestringCase-sensitive name without spaces for the command. The last definition wins for duplicate names.
m_ContainerstringExact container class with cargo.
m_Itemsarray<object>Items created in container cargo.

m_Kits[].m_Items[] / m_Kits[].m_Items[].m_Attachments[] ​

OptionTypeDescription
m_ClassstringExact item class.
m_StackintFixed quantity in native item units. Use 1 for items without quantity and repeat an entry to create separate objects.
m_Attachmentsarray<object>Optional child items with the same fields. Each child is attached when possible and otherwise placed in parent cargo.

m_Messages ​

OptionTypeDescription
m_AlreadyReceivedstringMessage when there are no remaining uses.
m_FailedstringMessage when the module cannot complete delivery.
m_InvalidDatastringMessage when the player’s balance data is invalid.
m_PackDeliveredstringMessage after successful delivery.
m_UnknownKitstringMessage for an unrecognized kit name.
m_UsagestringUsage message for invalid arguments.

Types ​

Use AC_SpawnKit_SeaChest as the kit delivery chest in m_Container.

types.xml
xml
<type name="AC_SpawnKit_SeaChest">
    <lifetime>3888000</lifetime>
    <flags count_in_cargo="0" count_in_hoarder="0" count_in_map="1" count_in_player="0" crafted="0" deloot="0" />
</type>

Commands ​

/spawnkit and /kit ​

Use /spawnkit <name> or /kit <name> with Chat enabled. The required argument is the name defined in m_Kits. Example: /spawnkit medical. Chat checks command.spawnkit or command.kit according to the alias used. The server also checks spawnkit.allow and spawnkit.deny for ordinary players.

A regular player’s first request for a valid kit creates $profile:AC/Modules/SpawnKit/<SteamID>.json with zero uses. To grant uses, set the desired kit’s count under m_Kits in that file and keep m_Steam equal to the filename’s SteamID. The next request reads the new balance. The server removes incomplete deliveries without debiting the balance. Superadmins bypass the server’s module permission and balance checks.

Permissions ​

Use Permissions to grant command.spawnkit or command.kit. The module allows ordinary players by default. spawnkit.deny blocks delivery, and spawnkit.allow takes precedence over that block.

Released under the MIT License.