Wiki Navigation

cfgLimitsDefinition.xml Configuration

The cfgLimitsDefinition.xml file defines spawn limits for various item categories in your DayZ server.

Overview

The cfgLimitsDefinition.xml file is used to define global spawn limits for different categories of items in your DayZ server. This file helps control:

  • Maximum number of items per category that can exist in the world
  • Balance between different types of loot
  • Server performance by limiting the total number of items

File Structure

The cfgLimitsDefinition.xml file consists of <definition> elements, each defining limits for a specific category:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<lists>
    <categories>
        <category name="weapons" />
        <category name="magazines" />
        <category name="attachments" />
        <category name="food" />
        <category name="tools" />
        <category name="containers" />
        <category name="clothes" />
    </categories>
    <limits>
        <limit name="weapons" value="120" />
        <limit name="magazines" value="250" />
        <limit name="food" value="400" />
        <limit name="containers" value="100" />
        <limit name="clothes" value="500" />
    </limits>
</lists>

Category Parameters

name string

The name of the category. This must match the category names used in types.xml.

Limit Parameters

name string

The name of the category to apply the limit to.

value integer

The maximum number of items in this category that can exist in the world at once.

How It Works

The cfgLimitsDefinition.xml file works in conjunction with the types.xml file:

  • Items in types.xml are assigned to categories using the <category> tag
  • The cfgLimitsDefinition.xml file sets a global limit for each category
  • When the server spawns items, it checks these limits to ensure they are not exceeded
  • If a category limit is reached, no more items of that category will spawn until some are removed

Note that individual item limits in types.xml (the <nominal> value) still apply, but the category limits provide an additional constraint.

Best Practices

When configuring your limits definition, consider the following best practices:

  • Balance limits based on your server's player count and performance capabilities
  • Ensure that the sum of all individual item nominal values in a category doesn't greatly exceed the category limit
  • Consider the gameplay impact of your limits - higher limits for essential items like food and lower limits for high-tier weapons can create a more balanced experience
  • Monitor server performance and adjust limits if needed

Need Help?

For more information about item categories and spawning, check the types.xml documentation or join our Discord community for assistance.