# Quest Packs

# Quest Packs

Quest Packs bundle quests, chapters, NPC profiles, and localization into self-contained packages. They are ideal for seasonal events, community-created content, or distributing quest sets between servers.

## Pack List

The left sidebar shows all loaded packs with:

- **Color dot** -- the pack's assigned color for visual identification
- **Pack name** -- display name or ID
- **Source badge** -- `C` for custom packs, `BASE` for imported
- **Summary** -- quest count, chapter count, NPC count

Three buttons let you create or import packs:

| Button | Action |
|--------|--------|
| **+ Wizard** | Opens the guided creation wizard at `/packs/create` |
| **+ New** | Quick-creates an empty pack with just an ID |
| **Import** | Loads a `.questpack` or `.json` file from disk |

## Creating a Pack

### Quick Create

1. Click **+ New**
2. Enter a **Pack ID** (e.g. `summer_event_2026`) -- must be unique
3. Optionally enter a **Display Name**
4. Click **Create Pack**

### Creation Wizard

Click **+ Wizard** to open a guided step-by-step flow that walks you through setting up pack info, adding quests, chapters, NPCs, and localization.

## Pack Tabs

After selecting a pack, six tabs are available:

### Overview

Displays pack metadata and a summary dashboard:

- **Pack ID**, **Name**, **Description**, **Author**, **Version**
- **Tags** -- comma-separated for categorization
- **Color** -- visual identifier
- **Summary cards** -- total quests, chapters, NPCs, and i18n keys

The **Export** section provides two options:

| Button | Output |
|--------|--------|
| **Export ZIP (Server)** | Generates server-ready files in the standard folder structure |
| **Export .questpack (Sharing)** | Exports the full editor format including NPCs and locale for sharing |

:::tip
Use ZIP export for deploying to your server. Use `.questpack` export for sharing packs with other server owners who use the Mod Editor.
:::

### Quests

Lists all quests in the pack. Click **+ Add Quest** to create a new one with:

- **Quest ID** -- unique identifier
- **Type** -- side, story, or daily
- **Category** -- combat, gathering, mining, crafting, exploration, social, or mixed

Below the quest list, a **Copy from Main Config** section lets you clone existing quests into the pack. The cloned quest ID is automatically prefixed with the pack ID to avoid conflicts.

### Chapters

Lists chapters within the pack. Click **+ Add Chapter** to create one, then add quests to it by clicking the quest buttons shown below each chapter. Remove quests from a chapter with the X button.

:::info
Chapter quests that are not found in the pack's quest list are flagged as **Missing** in red.
:::

### NPCs

Lists NPC profiles included in the pack. Click **+ Add NPC** to create one with a Citizen ID and Speaker Name. Each NPC shows its quest bindings.

### Locale

A simplified localization editor for pack-specific translations. Add keys with EN and DE values. Existing keys are shown in an editable three-column table.

Pack locale keys are exported as separate files (e.g. `custom_pack_summer_event_2026_en-US.json`) so they do not conflict with the main localization.

### Custom Refs

Register server-specific custom items, entities, or blocks. These are **global** references that appear in autocomplete across all editors, not just the pack.

## Importing a Pack

1. Click **Import** in the sidebar
2. Select a `.questpack` or `.json` file
3. The pack is loaded with all its quests, chapters, NPCs, and translations
4. A success message confirms the import with the pack ID

:::warning
Importing a pack with a Quest ID that already exists in your main config will trigger a conflict warning during validation. Check the [Validation](./validation-export) page for details.
:::

## Deleting a Pack

Select the pack, then click **Delete** in the Overview tab header. This removes the pack and all its contents from the editor.