Configuration

plugins/QuestKeeper/config.yml

# NPC ID of the quest giver (run /npc list to find it)
quest-npc-id: -1

# Server timezone for daily reset
# Examples: "UTC", "America/New_York", "Europe/London", "Asia/Tokyo"
timezone: "UTC"

# Streak bonus settings
streak:
  bonus-per-day: 2   # Points added per streak day beyond the first
  max-bonus: 10      # Maximum streak bonus

# Radius around the NPC to search for mobs (mob delivery quests)
mob-search:
  horizontal-radius: 6.0
  vertical-radius: 4.0

# Broadcast the new daily quest to all players when it changes
broadcast-new-quest: true

# Quest generator selection weights (relative; a weight of 0 disables a type)
quest-generator:
  weights:
    item_delivery: 25
    mob_delivery: 20
    exploration: 15
    structure_discovery: 10
    combat: 15
    crafting: 10
    villager_trading: 3
    biome_collection: 2

# Timed quest modifier (BossBar countdown)
timed-quests:
  chance: 0.15          # 0.0-1.0 probability an eligible quest becomes timed
  min-seconds: 600
  max-seconds: 1200
  bonus-reward: 6       # extra points for finishing in time (currently overridden by the flat 1-point reward)

# Exploration / structure discovery
exploration:
  structure-discovery-radius: 24    # blocks from a located structure to "discover" it
  structure-search-radius: 6400     # locateNearestStructure search radius

# Escort quests (experimental roadmap feature — leave disabled)
escort:
  enabled: false

note

streak.bonus-per-day and streak.max-bonus are retained for a future re-enable — every quest currently awards a flat 1 Quest Point regardless of streak length. The same applies to timed-quests.bonus-reward.

Persisted statistics live in stats.yml; per-player event-quest progress (and timed-quest state) is stored alongside player data so it survives restarts. See Data Files for the full layout of both.