开始使用（Getting Started）

本节介绍 DLC Manager 的核心能力与目录结构，并介绍配置文件格式（DC）。

本文档仅支持 DLC Manager 3.6.0 及以上版本。

介绍

DLC Manager 允许整合包开发者通过配置文件管理模组、资源包、数据包等内容的启用、下载与更新，并提供预设、公告、跳转等功能。本文档面向整合包开发者，使用正式说明与可直接上手的示例。

服务支持

欢迎加入QQ群 1072374755，有问题可进群咨询 已为新格式制作支持读写、高亮、语法检查、自动纠正的VSCode/JetBrains 插件，也为MacOS编写了QuickLook插件，请加群自取。

目录结构

建议在整合包根目录放置一个 DLC/ 目录（可在配置中修改）：

DLC/
  remote/               # 远程 DLC 配置（可自动下载）
  required/             # 必要资源配置（强制/必需）
  preset/               # 预设配置
  info/                 # 信息文件（自动或手动维护）
  update/               # 更新包目录
  remote/redirect/      # 跳转配置（可选，不自动创建）

配置文件格式（DC）

• 默认使用 .dc 作为配置扩展名。
• 配置以表结构为主（例如 [basic]、[DisplayName]、[tip]）。
• 读取时键名大小写不敏感。
• 多行文本支持三引号：

zh_cn = """第1行
第2行
"""

• DLC Manager 运行时配置文件也使用 dc：
  • config/dlc_manager/config.dc（客户端）
  • config/dlc_manager/config-server.dc（服务端）

快速上手（基础功能）

1. 在整合包根目录创建 DLC/（或在配置中指定 dlcRoot）。
2. 将模组文件直接拖入 DLC/ 目录。
3. 进入游戏，打开 DLC 管理器进行应用与管理。

关键概念

• identifier：用于逻辑关联、前置和冲突判断的核心标识符，建议保持稳定。
• file_name：DLC 文件名（包含扩展名，用于查找/应用），可与展示名称不同。
• DisplayName / tip：多语言展示文本。
• appliedTarget：目标目录（如 mods、resourcepacks、datapacks、tacz），决定文件应用位置。

常见问题

• 为什么配置不生效？
  • 确认扩展名为 .dc。
  • 确认配置位于正确目录（DLC/remote、DLC/required 等）。
  • 确认 identifier 不为空。
• 为什么显示名称不是我写的？
  • DisplayName 未配置或语言未匹配时会回退为文件名。

若需更深入的配置说明，请继续阅读 基础用法 与 高级用法 各章节。