Server Config XML Format

cfglimitsdefinition.xml

Defines spawn limits, categories, usages, and value tiers. Maps the category, usage, and value tags used in types.xml to actual spawn point definitions.

Overview

The cfglimitsdefinition.xml file defines the categories, usages, values, and tags that the Central Economy (CE) uses to control where and how items spawn. Every flag referenced in types.xml must be defined here.

This file acts as a dictionary — it declares valid flag names so the CE engine can match items to spawn locations on the map. Without a matching definition here, flags in types.xml are ignored.

XML Structure

The file contains four main sections within the root <lists> element:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<lists>
    <categories>
        <category name="tools" />
        <category name="weapons" />
        <!-- ... -->
    </categories>

    <tags>
        <tag name="shelves" />
        <tag name="floor" />
        <!-- ... -->
    </tags>

    <usages>
        <usage name="Military" />
        <usage name="Town" />
        <!-- ... -->
    </usages>

    <values>
        <value name="Tier1" />
        <value name="Tier2" />
        <!-- ... -->
    </values>
</lists>

Category	Description
weapons	Firearms, melee weapons
tools	Axes, shovels, saws, knives
clothes	Clothing, hats, gloves, shoes
containers	Backpacks, cases, pouches
food	Canned food, drinks, raw food
vehiclesparts	Tires, spark plugs, batteries
explosives	Grenades, mines, landmines

Usages

Usages define where on the map an item can spawn. Buildings and map locations are tagged with usage types, and items are matched to those locations via their usage flags in types.xml.

Usage	Description
Military	Military bases, tents, barracks, checkpoints
Police	Police stations
Hunting	Hunting stands, lodges, deer stands
Town	Residential houses, apartments in towns
Village	Small rural settlements
Farm	Barns, farm buildings, silos
Industrial	Factories, warehouses, workshops
Medic	Hospitals, medical buildings
Firefighter	Fire stations
School	Schools, piano houses
Office	Office buildings
Coast	Coastal buildings, boats, lighthouses

Values (Tiers)

Values define map zones (tiers) that control loot quality. The map is divided into geographic tiers — coastal areas are Tier 1 (low-value loot) while inland/military zones are Tier 3–4 (high-value loot).

Value	Zone	Loot Quality
Tier1	Coastal areas	Basic civilian loot
Tier2	Inland towns	Mid-range civilian and some military
Tier3	Deep inland / NWAF area	High-value military loot
Tier4	Contaminated / Tisy	Top-tier military, rare items

How It Maps to types.xml

Every category, usage, value, and tag referenced in types.xml must exist in cfglimitsdefinition.xml. Here's how they connect:

<!-- types.xml entry -->
<type name="M4A1">
    <nominal>10</nominal>
    <min>5</min>
    <lifetime>14400</lifetime>
    <restock>0</restock>
    <quantmin>-1</quantmin>
    <quantmax>-1</quantmax>
    <cost>100</cost>
    <flags count_in_cargo="0" count_in_hoarder="0"
           count_in_map="1" count_in_player="0" crafted="0" deloot="0" />
    <category name="weapons" />        <!-- Must exist in <categories> -->
    <usage name="Military" />           <!-- Must exist in <usages> -->
    <value name="Tier3" />              <!-- Must exist in <values> -->
    <value name="Tier4" />
</type>

If you add a custom usage like CustomBase in types.xml, you must also add <usage name="CustomBase" /> to cfglimitsdefinition.xml or the item will not spawn.

Example Configuration

A complete cfglimitsdefinition.xml with custom additions:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<lists>
    <categories>
        <category name="weapons" />
        <category name="tools" />
        <category name="clothes" />
        <category name="containers" />
        <category name="food" />
        <category name="vehiclesparts" />
        <category name="explosives" />
    </categories>

    <tags>
        <tag name="shelves" />
        <tag name="floor" />
    </tags>

    <usages>
        <usage name="Military" />
        <usage name="Police" />
        <usage name="Hunting" />
        <usage name="Town" />
        <usage name="Village" />
        <usage name="Farm" />
        <usage name="Industrial" />
        <usage name="Medic" />
        <usage name="Firefighter" />
        <usage name="School" />
        <usage name="Office" />
        <usage name="Coast" />
        <usage name="Lunapark" />
        <usage name="Prison" />
        <usage name="ContaminatedArea" />
    </usages>

    <values>
        <value name="Tier1" />
        <value name="Tier2" />
        <value name="Tier3" />
        <value name="Tier4" />
    </values>
</lists>