Custom Spoilage Manager

Configure item spoilage directly in-game, including different rules for every quality.

Custom Spoilage Manager (CSM) is a visual spoilage editor for modded games and large modpacks. It discovers items and qualities from the currently loaded mods, so spoilage can be changed without writing a separate compatibility mod.

Spoilage rules

• Add, change or disable spoilage for vanilla or modded items
• Set the lifetime in seconds
• Choose what happens when an item expires:
• transform into another item
• disappear
• trigger an explosion with configurable damage and radius
• Keep the source quality or choose a different result quality
• Remove a CSM rule to restore the item's original mod behavior after restart

Per-quality control

Every managed item has an All qualities default rule and can optionally override individual qualities.

This allows different qualities to have their own:

• spoilage lifetime
• enabled / disabled state
• spoilage outcome
• result item and result quality
• explosion settings

The editor also provides a Held item timer and quality-aware tooltips for checking the actual active lifetime and outcome.

Groups and editing

• Organize rules into multiple groups
• Choose one group as the active gameplay configuration
• Keep other groups stored in the same CSM2 export for later editing
• Favorites and favorites-only filtering
• Copy, cut and paste complete item/quality rule sets between groups
• Search items from enabled mods with Factorio's native item selector
• Minimize and restore the editor without losing the current draft

Validation and export

CSM validates the configuration before it is applied, including item references, qualities, duplicate rules, timer ranges and outcome settings.

The workflow is:

Edit → Validate → Export CSM2 → Startup settings → Restart Factorio

Only the selected active group affects gameplay. Exported inactive groups remain stored for editing.

Compatibility and interface

• Factorio 2.0/2.1
• Quality and Space Age are optional dependencies
• Dynamically discovers vanilla and mod-added items and qualities
• Scripted rules use an adjustable scan budget for large factories
• Multiplayer rule editing is restricted to administrators
• Localized in English, Simplified Chinese and Russian
• Open with Ctrl + Shift + S or /csm

Custom Spoilage Manager — 自定义变质管理器

直接在游戏内配置物品变质，并可为每种品质设置不同规则。

CSM 是面向 Mod 游戏与大型 Modpack 的可视化变质管理器。它会自动读取当前游戏实际加载的物品和品质，因此不需要为了修改不同 Mod 的变质行为另外编写兼容 Mod。

变质规则

• 为原版或 Mod 物品添加、修改或关闭变质
• 设置变质时间
• 变质后可以：
• 转化为其他物品
• 直接消失
• 触发可设置伤害与范围的爆炸
• 保持原品质，或指定产物品质
• 删除 CSM 规则并重启后，可恢复物品原本的 Mod 行为

按品质分别设置

每个物品拥有一个 全部品质 默认规则，也可以为单独品质建立规则。

不同品质可以分别设置：

• 是否变质
• 变质时间
• 变质结果
• 产物与产物品质
• 爆炸参数

编辑器还提供 手持物品计时，用于查看实际生效的变质时间与结果。

分组与编辑

• 使用多个规则组管理不同配置
• 选择其中一个作为实际生效组
• 其他组可一起保存在 CSM2 中备用
• 收藏与仅显示收藏
• 在不同组之间复制、剪切和粘贴完整物品/品质规则
• 使用 Factorio 原生物品选择器搜索当前 Modpack 的物品
• 最小化并恢复编辑器，不丢失当前草稿

验证与应用

CSM 会检查物品、品质、重复规则、时间范围和变质结果等配置。

基本流程：

编辑 → 验证 → 导出 CSM2 → 填入启动设置→ 重启 Factorio

只有选定的生效组会影响游戏；其他导出的组仅作为可继续编辑的配置保存。

兼容性

• Factorio 2.0/2.1
• Quality / Space Age 均为可选依赖
• 动态发现原版与 Mod 添加的物品和品质
• 脚本品质规则提供可调整的扫描预算，适应大型工厂
• 联机规则修改限制为管理员
• 支持 English / 简体中文 / Русский
• Ctrl + Shift + S 或 /csm 打开编辑器