Limits-Definition Guide

Overview

The limits definition XML file is where all loot tags are created. It controls how, where, and what items spawn across your server. The four main blocks — categories, tags, usage flags, and value flags — define the rules that types.xml and mapgroupproto.xml reference.

---

Categories (Item Types)

Used to classify items. Applied in:

• types.xml
• mapgroupproto.xml

Helps organize loot logically.

<categories>
    <category name="tools"/>
    <category name="containers"/>
    <category name="clothes"/>
    <category name="vehiclesparts"/>
    <category name="food"/>
    <category name="weapons"/>
    <category name="books"/>
    <category name="explosives"/>
</categories>

---

Tags (Placement Rules)

Controls where items can spawn physically. Prevents unrealistic placement.

Example: No sheet metal spawning on shelves.

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

---

Usage Flags (Building Types)

Restricts loot to certain building types. Items only spawn in matching building categories.

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

---

Value Flags (Loot Tiers / Zones)

Controls where on the map items can spawn. Linked to areaflags.map.

<valueflags>
    <value name="Tier1"/>
    <value name="Tier2"/>
    <value name="Tier3"/>
    <value name="Tier4"/>
    <value name="Unique"/>
</valueflags>

---

How They Work Together

| Block | Controls | Example | |---|---|---| | Categories | WHAT the item is | weapons, food | | Tags | WHERE it spawns physically | floor, shelves | | Usage flags | WHICH buildings spawn it | Military, Police | | Value flags | WHICH zones allow it | Tier1–Tier4, Unique |

---

Final Notes

• Categories = WHAT the item is
• Tags = WHERE it spawns physically
• Usage = WHICH buildings spawn it
• Value = WHICH zones allow it

---

Need help setting up your loot limits? Open a ticket — we've got you.