Remote（远程 DLC）

本节说明 Remote 配置的字段、用途、可填写值、默认行为与回退规则。

dc 格式请先阅读：

• 开始使用

位置

• 目录：DLC/remote/
• 子目录用于分类：
  • 当配置位于 DLC/remote/<子目录>/ 时，下载文件会放到 DLC/<子目录>/。
  • 示例：DLC/remote/mods/example.dc -> DLC/mods/<file_name>。

完整示例

[download]
curseforge_projectid = "123456"
curseforge_fileid = "7890123"
modrinth_projectid = "project-slug-or-id"
modrinth_versionid = "version-id-or-number"
directUrl = [
  "https://example.com/mirror/modA.jar",
  "https://mirror.example.net/modA.jar"
]
priority = "curseforge,modrinth,directurl"

[basic]
identifier = "ExampleMod"
type = "mod"
file_name = "example-mod-1.0.0.jar"
appliedTarget = "mods"
RedirectUrl = "https://example.com/project-page"
isInList = true
isHidden = false
AllowEnableByAll = true
dependencies = ["HelperLib"]
conflicts = ["ConflictMod"]
alarm = false

[dependencies]
  HelperLib:
    [download]
    modrinth_projectid = "helperlib"
    modrinth_versionid = "helperlib-version"
    directUrl = ""
    priority = "modrinth"

    [basic]
    identifier = "HelperLib"
    type = "mod"
    file_name = "helperlib-1.0.0.jar"
    isInList = true
    isHidden = true
    AllowEnableByAll = true
    dependencies = ""
    conflicts = ""
    alarm = false

    [DisplayName]
    en_us = "Helper Library"
    zh_cn = "辅助库"

    [tip]

[DisplayName]
en_us = "Example Mod"
zh_cn = "示例模组"

[tip]
en_us = "Example tip"
zh_cn = "示例提示"

字段说明

[download]

• curseforge_projectid：CurseForge 项目 ID 或 slug。
• curseforge_fileid：CurseForge 文件 ID / 版本字符串 / 文件名。
• modrinth_projectid：Modrinth 项目 ID 或 slug。
• modrinth_versionid：Modrinth 版本 ID 或版本字符串。
• directUrl：字符串或字符串数组（多镜像）。
• priority：逗号分隔优先级。
  • 支持：curseforge、modrinth、directurl。
  • 为空时，默认从 curseforge 开始并按内置顺序补全。

[basic].identifier

• 用途：用于前置/冲突/预设匹配的逻辑标识。
• 回退顺序：identifier -> file_name -> 配置文件名 -> URL 文件名 -> 平台项目 ID。

[basic].file_name

• 用途：DLC 文件名（包含扩展名）。
• 回退：先从 URL 推断，再使用回退名。

[basic].type

• 可填：mod、resourcepack、datapack、gunpack、others。
• 默认：mod。

[basic].appliedTarget

• 用途：覆盖应用目标路径。
• 可填：相对路径或绝对路径。
• 相对路径按整合包根目录解析。

[basic].RedirectUrl

• 用途：在 DLC 列表中双击 DLC 名称时打开的链接。
• 可填：字符串。

[basic].isInList

• 用途：是否在 DLC 列表中显示该条目。
• 默认：true。

[basic].isHidden

• 用途：隐藏该条目，但仍参与依赖关系管理。
• 默认：false。

[basic].AllowEnableByAll

• 用途：是否遵循“全部开启”而开启。
• 默认：true。

[basic].conflicts

• 可填：字符串或 identifier 数组。

[basic].alarm

• 用途：启用前显示警告确认页。
• 可填：布尔。

[basic].dependencies

• 可填：
  • 字符串（如 "LibA,LibB"）
  • 数组（如 ["LibA","LibB"]）

[dependencies]

• 用途：以嵌套的形式定义前置。
• 语法：
  • identifier: 或 [identifier]

[DisplayName]

• 多语言显示名文本表，通常为 en_us 与 zh_cn。

[tip]

• 多语言提示文本表，通常为 en_us 与 zh_cn。

补充说明

• 当 type = "others" 且 appliedTarget 为空时，该项会被强制不在列表展示。
• 显示语言回退：客户端语言 -> en_us -> 首个可用项。
• 非法文件名字符会被替换为 _。