# 开始使用（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]`）。
- 读取时键名大小写不敏感。
- 多行文本支持三引号：

```dc
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 未配置或语言未匹配时会回退为文件名。

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