Notice (notice.dc)

This section explains notice fields, purposes, allowed values, and rendering behavior, with a complete example.

For dc format and conventions, please read:

• Getting Started

Location

• Directory: DLC/info/
• File: notice.dc

Complete Example

isNoticeEnabled = true
neverShow = false
ShowFrequency = "perlaunchmanager"

[Title]
zh_cn = "公告"
en_us = "Notice"

[Subhead]
enabled = true
zh_cn = "请仔细阅读"
en_us = "Please read carefully"

[ContentUrl]
en_us = "https://example.com/notice-en.md"
zh_cn = "https://example.com/notice-zh.md"

[Contents]
en_us = """# Update Notes

This is fallback content when ContentUrl is unavailable."""
zh_cn = """# 更新说明

这是 ContentUrl 不可用时显示的回退内容。"""

---

Field Reference

isNoticeEnabled

• Purpose: Enable/disable notice.
• Allowed: Boolean.

neverShow

• Purpose: If true, never show again.
• Allowed: Boolean.

ShowFrequency

• Purpose: Display frequency (e.g. perlaunchmanager).
• Allowed: String.
  • perlaunchgame: show on every game launch in the main menu (outside DLC Manager).
  • pergamesession: show once when opening DLC Manager during a game session.
  • perlaunchmanager: show every time DLC Manager opens.
  • once: show only once.
• Default: perlaunchmanager.

[Title]

• Purpose: Notice title (localized).
• Allowed: Object { zh_cn: "...", en_us: "..." }.

[Subhead]

• Purpose: Subtitle.
• Allowed: Object containing:
  • enabled (boolean)
  • localized text

[Contents]

• Purpose: Body content.
• Allowed: Localized strings.
• Rendering: Markdown + MC formatting codes (colors, etc.) supported.

[ContentUrl]

• Purpose: Online content URL (higher priority than Contents).
• Allowed:
  • Single string URL
  • Localized object (same shape as Contents)
• Behavior:
  • If ContentUrl is configured and fetch succeeds, remote text is rendered.
  • If fetch fails, fallback to Contents.
  • Fetch timeout: connect 3s, read 5s.

---

Markdown Support

Supported:

• Bold, Italic, Strikethrough, ++Underline++
• Lists (- / *)
• Links [text](https://example.com)
• Horizontal rule --- (renders as a gray line)

Minecraft formatting codes are also supported:

§a green text §r reset

Multi-line Text

Use triple-quoted strings:

[Contents]
zh_cn = """Line 1
Line 2

- Item 1
- Item 2"""

---

FAQ

• Why does parsing fail?
  • The content string contains unescaped line breaks or quotes.
• Why are links not clickable?
  • Only standard Markdown links are clickable in the notice screen.