Wiki Navigation

cfgIgnoreList.xml Configuration

The cfgIgnoreList.xml file defines which items should be ignored by the server's cleanup processes.

Overview

The cfgIgnoreList.xml file is used to specify which items should be excluded from the server's automatic cleanup processes. This is particularly useful for:

  • Preserving player-built structures
  • Maintaining persistent storage containers
  • Keeping important items in the world longer than their normal lifetime

File Structure

The cfgIgnoreList.xml file has a simple structure with <item> elements listing the classnames to ignore:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ignore>
    <item name="WoodenLog"/>
    <item name="WoodenPlank"/>
    <item name="MetalPlate"/>
    <item name="Nail"/>
    <item name="WoodenCrate"/>
    <item name="SeaChest"/>
    <item name="Fence"/>
    <item name="WatchtowerKit"/>
    <item name="TentStorage"/>
</ignore>

Item Parameters

name string

The classname of the item to be ignored by cleanup processes. This must match exactly the classname defined in types.xml.

How It Works

When the server performs its regular cleanup operations, it checks the cfgIgnoreList.xml file to determine which items should be excluded from cleanup. Items listed in this file will:

  • Not be removed when their lifetime expires
  • Persist through server restarts
  • Remain in the world until manually removed by players or admins

Note that this does not make items completely immune to all cleanup processes. Server administrators can still manually remove items, and certain game mechanics (like damage) can still destroy them.

Best Practices

When configuring your ignore list, consider the following best practices:

  • Only add items that truly need to persist (base building materials, storage containers)
  • Be cautious about adding too many items, as this can impact server performance
  • Consider implementing additional server-side cleanup scripts for ignored items if needed
  • Regularly review and update your ignore list as your server evolves

Need Help?

For more information about item persistence and server cleanup, check the economy.xml documentation or join our Discord community for assistance.