# Configuration

Quests is configured in `config.json` in its data folder (`mods/kyuubisoft_questbook/`). Every option on this page can also be changed in the **Settings** tabs of the [admin window](./admin-panel), which shows below each value what it does in the game and applies changes at once.

:::info
After editing `config.json` by hand, run `/ksquestadmin reload`. Reset time, reset day and time zone changes then apply without a restart.
:::

New installs get a production `config.json` (English, 300-second save interval). If the admin window or a save finds `config.json` unreadable, it stops and names the file instead of replacing it.

---

## Full structure

```json
{
  "useCustomContent": true,
  "loadDefaultQuests": true,
  "loadDefaultStoryQuests": true,
  "loadDefaultChapters": true,
  "loadDefaultDailyPool": true,
  "loadDefaultWeeklyPool": true,

  "language": "en-US",
  "timezone": "Europe/Berlin",
  "dailyResetTime": "04:00",
  "weeklyResetDay": "MONDAY",
  "dailyQuestCount": 3,
  "weeklyQuestCount": 5,

  "streak": { ... },
  "questItem": { ... },
  "economy": { ... },
  "tierSystem": { ... },
  "reroll": { ... },
  "questTracker": { ... },
  "placedBlockTracker": { ... },
  "proximityToast": { ... },
  "notifications": { ... },

  "saveIntervalSeconds": 300,
  "debug": false
}
```

---

## General

| Field | Default | Description |
|-------|---------|-------------|
| `language` | `"en-US"` | Server language of Quests (console, chat lines without a player language, fallback). Players choose their own language with `/kslang` or in `/kssettings`, which applies to all KS mods |
| `timezone` | `"Europe/Berlin"` | Time zone for the resets (Java zone ID) |
| `dailyResetTime` | `"04:00"` | Time of the daily reset (24 h) |
| `weeklyResetDay` | `"MONDAY"` | Day of the weekly reset (at `dailyResetTime`) |
| `dailyQuestCount` | `3` | Daily quests per player |
| `weeklyQuestCount` | `5` | Weekly quests per player |
| `saveIntervalSeconds` | `300` | Autosave interval for player data |
| `useCustomContent` | `true` | Load your content from `custom/` |
| `loadDefaultQuests` | `true` | Load the shipped `quests.json` (daily, weekly, side) |
| `loadDefaultStoryQuests` | `true` | Load the shipped `story_quests.json` |
| `loadDefaultChapters` | `true` | Load the shipped `chapters.json` |
| `loadDefaultDailyPool` | `true` | Load the shipped `daily_pool.json` |
| `loadDefaultWeeklyPool` | `true` | Load the shipped `weekly_pool.json` |

Resets run at the configured time in the configured time zone. Daylight saving time does not move them, and a login before the reset time no longer causes a second reset that morning.

---

## Streak

```json
"streak": {
  "enabled": true,
  "cumulative": true,
  "gracePeriodDays": 7,
  "gracePeriodWindow": 14,
  "questStreak": false,
  "rewardsEnabled": false,
  "milestones": [
    { "days": 7,  "lootbagId": "streak_reward_7",  "tier": "bronze" },
    { "days": 14, "lootbagId": "streak_reward_14", "tier": "silver" },
    { "days": 21, "lootbagId": "streak_reward_21", "tier": "gold" },
    { "days": 28, "lootbagId": "streak_reward_28", "tier": "platinum" }
  ]
}
```

| Field | Default | Description |
|-------|---------|-------------|
| `enabled` | `true` | Count the quest streak |
| `cumulative` | `true` | Lenient counting: up to `gracePeriodDays` missed days in a row do not break the streak |
| `gracePeriodDays` | `7` | Missed days in a row that are forgiven when `cumulative` is on |
| `questStreak` | `false` | Show the quest streak in the Questbook |
| `rewardsEnabled` | `false` | Pay the milestones (needs `questStreak`) |
| `milestones` | 4 milestones | Days, lootbag and tier (`bronze`, `silver`, `gold`, `platinum`) of each milestone |

See [Streak System](./streak-system).

---

## Quest item

```json
"questItem": {
  "enabled": true,
  "itemId": "QuestBook",
  "hotbarSlot": 8,
  "giveOnJoin": false,
  "giveDelay": 500
}
```

| Field | Default | Description |
|-------|---------|-------------|
| `enabled` | `true` | Use the Quest Book item |
| `itemId` | `"QuestBook"` | Item ID |
| `hotbarSlot` | `8` | Hotbar slot (0-8) |
| `giveOnJoin` | `false` | Hand the item out on join |
| `giveDelay` | `500` | Delay in ms after joining |

---

## Economy

```json
"economy": {
  "rewardCurrency": "quest_tokens",
  "tokenExchangeRate": 100.0,
  "tokenShopUsesEconomy": false,
  "tokenEarnings": {
    "dailyQuestComplete": 1,
    "allDailiesBonus": 2,
    "allDailiesBonusEnabled": false,
    "weeklyQuestComplete": 5,
    "streakBronze": 5,
    "streakSilver": 10,
    "streakGold": 15,
    "streakPlatinum": 20
  }
}
```

| Field | Default | Description |
|-------|---------|-------------|
| `rewardCurrency` | `"quest_tokens"` | `quest_tokens`, or `economy` to pay every token reward as coins of an economy plugin (for example Ecotale). Existing token balances stay |
| `tokenExchangeRate` | `100.0` | Coins per token in economy mode. Also converts the reroll price |
| `tokenShopUsesEconomy` | `false` | In economy mode, the token shop charges coins (price × rate) instead of tokens |
| `tokenEarnings.dailyQuestComplete` | `1` | Bonus tokens per completed daily quest |
| `tokenEarnings.weeklyQuestComplete` | `5` | Bonus tokens per completed weekly quest |
| `tokenEarnings.allDailiesBonusEnabled` | `false` | Pay `allDailiesBonus` once per day when every current daily is done |
| `tokenEarnings.allDailiesBonus` | `2` | Tokens for the all-dailies bonus |
| `tokenEarnings.streakBronze` … `streakPlatinum` | `5` / `10` / `15` / `20` | Tokens per streak milestone level |

---

## Tier system

```json
"tierSystem": {
  "enabled": true,
  "tiers": [
    { "id": "common",    "difficulty": "easy",      "color": "#A0A0A0", "multiplier": 1.0, "weight": 50, "name": { "en": "Common",    "de": "Gewöhnlich" } },
    { "id": "rare",      "difficulty": "medium",    "color": "#4169E1", "multiplier": 2.0, "weight": 30, "name": { "en": "Rare",      "de": "Selten" } },
    { "id": "epic",      "difficulty": "hard",      "color": "#9932CC", "multiplier": 3.0, "weight": 15, "name": { "en": "Epic",      "de": "Episch" } },
    { "id": "legendary", "difficulty": "legendary", "color": "#FFD700", "multiplier": 5.0, "weight": 5,  "name": { "en": "Legendary", "de": "Legendär" } }
  ]
}
```

| Field | Description |
|-------|-------------|
| `enabled` | Apply the tier factor to rewards |
| `id` | Tier ID |
| `difficulty` | The quest difficulty this tier stands for |
| `color` | Colour in the UI |
| `multiplier` | Reward factor |
| `name` | Display name per language |

The tier `weight` is not used; how often a quest is drawn comes from its pool weight. See [Tier System](./tier-system).

---

## Reroll

```json
"reroll": {
  "enabled": true,
  "freeRerollsPerDay": 1,
  "freeRerollsPerWeek": 1,
  "paidRerollCost": 10,
  "maxPaidRerollsPerDay": 5,
  "maxPaidRerollsPerWeek": -1,
  "allowRerollStarted": false
}
```

| Field | Default | Description |
|-------|---------|-------------|
| `enabled` | `true` | Allow rerolls |
| `freeRerollsPerDay` | `1` | Free daily rerolls per day |
| `freeRerollsPerWeek` | `1` | Free weekly rerolls per week |
| `paidRerollCost` | `10` | Price of the first paid reroll in tokens. It doubles with each paid reroll |
| `maxPaidRerollsPerDay` | `5` | Paid daily rerolls per day |
| `maxPaidRerollsPerWeek` | `-1` | Paid weekly rerolls per week. `-1` = same as `maxPaidRerollsPerDay` (the behaviour before 2.0) |
| `allowRerollStarted` | `false` | Allow rerolling quests that already have progress |

A single quest can switch rerolling off with `options.rerollable: false`.

---

## Quest tracker

```json
"questTracker": {
  "enabled": true,
  "showOnJoin": true,
  "maxTrackedQuests": 5,
  "autoUntrackCompleted": true,
  "defaultShowEmptyState": true
}
```

| Field | Default | Description |
|-------|---------|-------------|
| `enabled` | `true` | Tracker HUD available |
| `showOnJoin` | `true` | Show the tracker right after joining |
| `maxTrackedQuests` | `5` | Quests a player can track at once |
| `autoUntrackCompleted` | `true` | Allow removing finished quests from the tracker (players can still switch it off for themselves) |
| `defaultShowEmptyState` | `true` | Show an empty tracker card for new players |

The tracker has a fixed place on the screen. See [HUD Tracker](./hud-tracker).

---

## Proximity hint

```json
"proximityToast": {
  "enabled": true,
  "toastRange": 20.0
}
```

| Field | Default | Description |
|-------|---------|-------------|
| `enabled` | `true` | Show the NPC's picture when a player comes near a quest NPC |
| `toastRange` | `20.0` | Range in blocks |

---

## Notifications

```json
"notifications": {
  "enabled": true,
  "showProgress": true,
  "progressThreshold": 25,
  "broadcastCompletion": false,
  "announceResets": false
}
```

| Field | Default | Description |
|-------|---------|-------------|
| `enabled` | `true` | Quest notifications |
| `showProgress` | `true` | Report progress |
| `progressThreshold` | `25` | Notify every n percent (1-100) |
| `broadcastCompletion` | `false` | Announce quest completions to everyone |
| `announceResets` | `false` | Tell online players in chat when the daily or weekly quests were reset |

---

## Options without effect

These values stay in `config.json` and are not changed, but Quests 2.1 does not use them. The admin window lists them under "No longer in the window".

| Field | Why |
|-------|-----|
| `economy.provider`, `economy.primaryCurrency`, `economy.alternativeCurrency` | Never read. Economy mode uses Core's economy bridge |
| `economy.rerollCostTokens` | Duplicate; `reroll.paidRerollCost` counts |
| `economy.rerollCostGold` | Not used by the Questbook. In economy mode the token price × rate applies |
| `questTracker.maxDisplayedQuests`, `questTracker.maxDisplayedObjectives` | Players set these themselves |
| `questTracker.position`, `questTracker.defaultPositionPreset` | Ignored. The tracker has a fixed place on the screen |
| `placedBlockTracker.*` | KyuubiSoft Core handles self-placed blocks with a fixed 30 minutes |
| `proximityToast.durationMs` | No effect |
| `streak.gracePeriodWindow` | Only used by the old login counter |
| `tierSystem.tiers[].weight` | Not used |
| `debug` | No effect. Extra log output follows Core's `logLevel` (`all` = debug) |

---

## Other files

| File | Contents |
|------|----------|
| `configs/quests.json`, `configs/story_quests.json`, `configs/chapters.json`, `configs/daily_pool.json`, `configs/weekly_pool.json` | Shipped content (replaced by newer shipped versions, with a backup) |
| `configs/quest_token_shop.json` | The Quest Token Shop (a Core shop). A newer shipped version replaces it and keeps the old one as `quest_token_shop.json.backup-v<N>`; while the shipped file carries no version, your edits are never touched |
| `custom/` | Your own content. See [Custom Content](./custom-quest-content) |
| `quest_npc_profiles/` | NPC quest profiles. See [NPC Quest Profiles](./npc-quest-profiles) |
| `localization/` | Language files. See [Localization](./localization) |
| `backups/` | Backup sets of the admin window (last 20) |
| `exports/` | Exports and import files |
| `players/` | Player data (when Core uses file storage) |
| `server_stats.json` | Server statistics (written on autosave) |