Introduction(介绍)

This document serves as a reference for Custom Difficulty 2, a mod for Deep Rock Galactic which allows the creation of new hazards, or difficulties. Developed by @TheBrain as a successor to the Custom Difficulty mod, CD2 features many improvements over the flexibility and possibilities offered to difficulty designers:

本文档是《深岩银河》模组 Custom Difficulty 2（CD2） 的参考指南，它允许你创建新的难度。CD2由@TheBrain开发，作为Cusotm Difficulty（CD1）的迭代版本，相比CD1拥有更高的灵活性和更多的可能

  • Allows players to a have a much finer control over many aspects of the gameplay by introducing mutators, control flow structures similar to those found in common programming languages.
  • 通过引入类似编程语言结构的 Mutators，让代码作者可以更精细地控制游戏逻辑。
  • Exposes many enemy controls to change their behaviour, spawning mechanics and even aspect by featuring custom materials replication to clients.
  • 开放大量敌人控制项，可自由修改它们的行为、生成机制及材质。
  • Allows manipulating the enemy pools live during a mission based on gameplay conditions.
  • 支持在任务中，根据游戏条件实时调整敌人池。
  • Offers many features not available in CD1 such as controls for illumination, player scale, the amount of nitra in the map, etc.
  • 新增多项 CD1 不具备的功能，比如光照控制、玩家体型缩放、地图硝石数量调节等等
  • ... and many others.以及更多内容

Main Sections(主要章节)

  • Basics. The basics of CD2. 基础部分
  • Modules. A list of the top level modules for a valid CD2 file. 模块部分
  • Enemies. Reference for the Enemies or EnemiesNoSync modules. 敌人配置
  • Direct. A compilation of Direct enemy controls with default values. 底层属性
  • Wave Spawners. Reference for the WaveSpawners module. 波次生成器
  • Projectiles. Reference for the Projectile field of enemy descriptors.发射物部分
  • Mutators. A list of currently supported mutators. 动态参数与逻辑控制
  • Tutorials. An assortment of small guides related to different CD2 topics. 教程
  • MEV, DEA and EEE. A reference for the MEV and DEA mods and links to the EEE reference, used to add new enemy variants into the game.
  • Common edits. Reference section for common difficulty edits.
  • Resources. Useful links related to Custom Difficulty.相关资源
CD2modhub
Main CD2 screen in Modhub.Modhub 中的 CD2 主界面

Update Log(更新日志)】

  • 4-Dec-2024: Updated for CD2-v9: added ByEscortPhase and ByRefineryPhase mutators.
  • 2024-12-04,CD2-v9:新增 ByEscortPhase和 ByRefineryPhase Mutator。
  • 25-Dec-2024: Updated for CD2-v10: added the Projectiles page, added the MEV and DEA page, added an explanation for elite and veteran enemies in Enemies, added the explanation for the new Spawner enemy control, and some minor corrections.
  • 2024-12-25,CD2-v10:新增 "Projectiles"页面、"MEV、DEA"页面，补充"精英敌人与变种设置"的说明，新增"Spawner"模块的介绍，并进行了一些小修正。
  • 29-Jan-2025: Updated for CD2-v11: added the Direct and UsesBiomeVariants enemy controls and the BySaboPhase mutator.
  • 2025-1-29，CD2-v11:新增 "Direct"和 "UsesBiomeVariants" 的敌人控制项，以及 "BySaboPhase"的Mutator
  • 20-Feb-2025: Partial update for CD2-v12: added the DefenseProgress and ByResuppliesCalled mutators, added the Salvage module and the BySalvagePhase mutator.
  • 2025-2-20,CD2-v12:新增 "DefenseProgress"和 "ByResuppliesCalled"的 Mutator;新增 "Salvage"模块和 "BySalvagePhase" 的 Mutator
  • 28-Feb-2025: Added @Carrot's projectile resource to the Resources and Projectiles tabs, added @Spy's guide to pubbing with CD2 to Resources and to the FAQ, added EEE's reference to Projectiles and to MEV, DEA and EEE.
  • 2025-2-28:在 Resources 与 Projectiles 页面中加入 @Carrot 提供的发射物汇总；在 Resources 与 FAQ 中加入 @Spy 编写的 CD2 公开房间可使用的功能指南；在 Projectiles 与 MEV、DEA 和 EEE 页面加入 EEE 的参考资料
  • 11-Mar-2025: Update for CD2-v13: added the legacy pawn stats to enemy controls, added BySecondary and DwarfCount mutators, added Darkness module descriptions, added Salvage.Minimules.NitraToGive to the Salvage module
  • 2025-3-11,CD2-v13:在敌人控制中加入 legacy pawn 属性；新增 BySecondary 与 DwarfCount 的 Mutator;补充 Darkness 模块的介绍；在 Salvage 模块新增 Salvage/Minimules/NitraToGive 字段。
  • 22-Mar-2025: Update for CD2-v14: added the Dense Biozone option to the ByBiome mutator, added descriptions to Movement enemy module provided by @emctwo.
  • 2025-3-22,CD2-v14:为 ByBiome 的 Mutateor 加入 Dense Biozone 选项；补充由 @emctwo 提供的 Movement 敌人模块描述。
  • 25-May-2025: Update for CD2-v15: added the Diversity option to the wavespawner section, added the new Trigger mutators to the mutators section, added the Heal advanced controls and the new Outline control to enemies.
  • 2025-5-25,CD2-v15:为 Wavespawner 中加入 Diversity 选项；在 Mutators 章节新增 Trigger 系列 Mutators;在敌人控制项中新增 Heal （HealRaw等）控制与 Outline 控制。
  • 2-Jun-2025: Clarified the section about the differences between Enemies and EnemiesNoSync in Enemies; removed the DEA enemy list from MEV, DEA and EEE and added a link to the mod in mod.io and to the official list.
  • 2025-6-2:在 Enemies 页面中澄清 Enemies 与 EnemiesNoSync 的差别；在 MEV、DEA 和 EEE 页面移除 DEA 敌人列表，改为添加 mod.io 页面与官方列表的链接。
  • 23-Jul-2025: Added the Direct page.
  • 2025-7-23:新增 "Direct" 页面
  • 15-Aug-2025: Added the Usable table in the Salvage module in Modules and some examples.
  • 2025-8-15:在 Modules的 "Salvage"部分新增 "Usable"表格及使用示例
  • 11-Nov-2025: Update for CD2-v16: added the Countdown, EnemiesRecentlySpawned, Int2String, Float2String and the Join mutators; added the Messages and SoundCues module; added the FallDamageStartVelocity and FallDamageModifier in the Dwarves module.
  • 2025-11-11,CD2-v16:新增 Countdown、EnemiesRecentlySpawned、Int2String、Float2String 与 Join 的 Mutator;新增 Messages 与 SoundCues 模块；在 Dwarves 模块新增 FallDamageStartVelocity 与 FallDamageModifier 的参数。
  • 2-Dec-2025: Update for CD2-v17: added the Vars module, the Alert field on wavespawners, the DroppodDistance, MuleDroppodDistance, Nonzero, Select, EnemyHealth, EnemyDistance, SecondaryFinished, LockFLoat, LockBoolean and LockString mutators.
  • 2025-12-2,CD2-v17:新增 Vars 模块，在 Wavespawners 中加入 Alert 字段；并新增以下Mutators: DroppodDistance 、 MuleDroppodDistance 、Nonzero 、 Select 、 EnemyHealth 、 EnemyDistance 、 SecondaryFinished 、 LockFLoat 、LockBoolean 、 LockString 。
  • 11-Dec-2025: Added the Common Edits section, changed theme to material.
  • 2025-12-11:新增 Common Edits 章节,并将参考文档主题样式更改为 Material 风格【翻译版没有更改】