╔══════════════════════════════════════════════════════════════════╗
║           Cozy Cobble Bug Report Mod — Config README             ║
║     Edit: config/cozycobblebugmod/config.json  (game folder)     ║
╚══════════════════════════════════════════════════════════════════╝

┌─ DISCORD ──────────────────────────────────────────────────────┐
│                                                                │
│  webhookUrl                                                    │
│    Your Discord webhook URL.                                   │
│    NORMAL CHANNEL: Channel Settings → Integrations →          │
│      Webhooks → New Webhook → Copy Webhook URL.               │
│    FORUM CHANNEL:  same steps, but do it inside the forum     │
│      channel.  Set isForumChannel to true as well.            │
│    The URL starts with https://discord.com/api/webhooks/...   │
│    WITHOUT this field nothing is sent.                        │
│                                                                │
│  roleId                                                        │
│    The Discord Role ID to ping when a report arrives.         │
│    Enable Developer Mode in Discord (Settings → Advanced),    │
│    right-click the role → Copy ID.  Numbers only.             │
│    Leave "" to disable role pings.                            │
│                                                                │
│  defaultMention                                                │
│    Extra text prepended to every report, e.g. "@here".        │
│    Leave "" to disable.                                       │
│                                                                │
└────────────────────────────────────────────────────────────────┘

┌─ FORUM CHANNEL ────────────────────────────────────────────────┐
│                                                                │
│  isForumChannel  (true / false, default false)                 │
│    Set to true when your webhookUrl points at a forum         │
│    channel.  Each bug report will create a new forum post     │
│    (thread) using the bug title.  The embed goes inside it.   │
│                                                                │
│  forumTagIds  (object — category name → tag ID string)         │
│    Maps each report category to the Discord Forum Tag that    │
│    will be applied to the new post.  Tags are optional but    │
│    required by some forums.                                   │
│                                                                │
│    How to get tag IDs:                                        │
│      1. Enable Developer Mode (Discord Settings → Advanced).  │
│      2. Edit your forum channel → Tags tab.                   │
│      3. Right-click a tag name → Copy Tag ID.                 │
│                                                                │
│    The category names you can map are:                        │
│      "Gameplay"           "Crash / Freeze"                    │
│      "Visual / Rendering" "Performance"                       │
│      "Inventory / Items"  "World / Chunks"                    │
│      "Multiplayer / Sync" "Other"                             │
│                                                                │
│    Leave any entry blank ("") to skip tagging that category.  │
│                                                                │
│    Example JSON entry:                                        │
│      "forumTagIds": {                                         │
│        "Gameplay":        "1234567890123456789",              │
│        "Crash / Freeze":  "9876543210987654321",              │
│        "Other":           "1111111111111111111"               │
│      }                                                        │
│                                                                │
└────────────────────────────────────────────────────────────────┘

┌─ BRANDING ─────────────────────────────────────────────────────┐
│                                                                │
│  serverName                                                    │
│    Your server or community name shown in Discord embeds.     │
│    Example: "Cozy Cobble SMP"                                 │
│                                                                │
│  embedColor                                                    │
│    Hex color for the Discord embed accent bar (no #).         │
│    Common values:                                              │
│      E74C3C  →  Red     (default)                             │
│      3498DB  →  Blue                                          │
│      2ECC71  →  Green                                         │
│      F39C12  →  Orange                                        │
│      9B59B6  →  Purple                                        │
│                                                                │
│  footerText                                                    │
│    Short text shown at the bottom of each Discord embed.      │
│    Example: "Bug Report System | cozymc.net"                  │
│                                                                │
└────────────────────────────────────────────────────────────────┘

┌─ ATTACHMENTS ──────────────────────────────────────────────────┐
│                                                                │
│  allowScreenshot  (true / false)                               │
│    When true, players can attach their latest screenshot.     │
│                                                                │
│  allowLog  (true / false)                                      │
│    When true, players can attach their latest.log file.       │
│                                                                │
│  logMaxKb  (number, default 512)                               │
│    Maximum kilobytes of latest.log to upload.  If the log     │
│    is larger, only the most recent content is kept.           │
│    Set lower (e.g. 128) for smaller uploads.                  │
│                                                                │
└────────────────────────────────────────────────────────────────┘

┌─ RATE LIMITING ────────────────────────────────────────────────┐
│                                                                │
│  maxReportsPerHour  (number, default 5)                        │
│    Soft client-side limit.  After this many reports in one    │
│    hour, the player is told to wait.  Set 0 to disable.       │
│                                                                │
└────────────────────────────────────────────────────────────────┘

┌─ FEATURE FLAGS ────────────────────────────────────────────────┐
│                                                                │
│  reportingEnabled  (true / false)                              │
│    Master switch.  Set false to disable /bugreport entirely.  │
│                                                                │
│  registerServerCommand  (true / false)                         │
│    When true, /bugreport also registers on the server side    │
│    so it shows in tab-completion for all players.             │
│    When false it is a silent client-only command.             │
│                                                                │
└────────────────────────────────────────────────────────────────┘
