Daily & Weekly Pools

The pool system controls which quests are offered to players each day and each week. A configurable number of quests are randomly drawn from weighted pools and assigned to every player at the reset time. Players can reroll individual quests they do not want.

How It Works

1. At the daily reset time, the server selects quests from daily_pool.json for each online player.
2. At the weekly reset time (a specific day of the week), quests are drawn from weekly_pool.json.
3. Players who were offline during a reset receive their new quests on next login (lazy reset).
4. Old daily/weekly quests that were not completed are automatically abandoned when the reset occurs.

Reset Schedule

The reset schedule is configured in config.json:

{
  "dailyResetTime": "04:00",
  "weeklyResetDay": "MONDAY",
  "timezone": "Europe/Berlin",
  "dailyQuestCount": 3,
  "weeklyQuestCount": 5
}

Setting	Default	Description
dailyResetTime	"04:00"	Time of day when daily quests reset (24h format)
weeklyResetDay	"MONDAY"	Day of the week when weekly quests reset
timezone	"Europe/Berlin"	Timezone for all reset calculations
dailyQuestCount	3	Number of daily quests assigned per player
weeklyQuestCount	5	Number of weekly quests assigned per player

tip

All players on the server share the same reset schedule. The lazy reset system ensures players who log in after reset time still receive their new quests.

Pool JSON Structure

Both daily_pool.json and weekly_pool.json use the same format. Each entry specifies a quest ID and a weight that controls how likely it is to be selected.

{
  "_config_version": "2",
  "pool": [
    { "quest_id": "daily_mine_stone", "weight": 50 },
    { "quest_id": "daily_mine_stone_rare", "weight": 30 },
    { "quest_id": "daily_mine_stone_epic", "weight": 15 },
    { "quest_id": "daily_mine_stone_legendary", "weight": 5 }
  ]
}

Weight System

The weight value determines the relative probability of a quest being selected when the Tier System is enabled. Higher weight means more frequent appearance.

Weight	Typical Tier	Selection Chance (approx.)
50	Common	~50%
30	Rare	~30%
15	Epic	~15%
5	Legendary	~5%

When the tier system is disabled, quests are selected randomly with equal probability regardless of weight.

info

The pool files are located in configs/kyuubisoft_questbook/configs/. They are base files that may be updated when the mod is upgraded. Add your custom pool entries in the custom/ folder instead.

Custom Pool Entries

To add your own quests to the pool without modifying base files, create custom_daily_pool.json or custom_weekly_pool.json in the custom/ folder:

{
  "_info": "Admin-modified daily quest pool. NOT overwritten on mod updates.",
  "disabled_base_ids": [
    "daily_walk",
    "daily_walk_rare"
  ],
  "pool": [
    { "quest_id": "my_custom_daily_quest", "weight": 50 },
    { "quest_id": "my_custom_daily_quest_hard", "weight": 15 }
  ]
}

Field	Description
disabled_base_ids	Base pool quest IDs to remove from rotation
pool	Custom quest entries to add to the pool

Custom entries are merged with the base pool at load time. Disabled base IDs are removed first, then custom entries are appended.

Reroll System

Players can reroll individual daily quests they do not want. The reroll system is configured in config.json:

{
  "reroll": {
    "enabled": true,
    "freeRerollsPerDay": 1,
    "paidRerollCost": 10,
    "maxPaidRerollsPerDay": 5,
    "allowRerollStarted": false
  }
}

Setting	Default	Description
enabled	true	Enable or disable the reroll system
freeRerollsPerDay	1	Number of free rerolls per day
paidRerollCost	10	Quest Token cost for paid rerolls
maxPaidRerollsPerDay	5	Maximum number of paid rerolls per day
allowRerollStarted	false	Whether already-started quests can be rerolled

Escalating Costs

Paid rerolls use an escalating cost formula. Each subsequent paid reroll doubles in price:

Reroll #	Cost (base = 10)
1st paid	10 tokens
2nd paid	20 tokens
3rd paid	40 tokens
4th paid	80 tokens
5th paid	160 tokens

warning

If allowRerollStarted is false (the default), players cannot reroll a quest they have already begun working on. The reroll button will only appear for quests that have not been started yet.

Reroll Results

When a reroll is performed, the system draws a new quest from the same pool, excluding quests the player already has assigned. If no alternative quest is available in the pool, the reroll fails and no tokens are spent.

Default Pool Contents

Daily Pool

The default daily pool contains quests across 11 categories (Mining, Woodcutting, Digging, Harvesting, Combat, Damage, Crafting, Building, Exploration, Collection, Playtime), each with Common/Rare/Epic/Legendary tier variants.

Weekly Pool

The default weekly pool features longer quests in 3 categories: Mastery (Miner, Lumberjack, Hunter, Crafter), Challenges (Slayer, Gold Rush, Berserker, Marathon), and Journeys (Adventurer, Survivor, Warrior, Allrounder).