Configuration

Everything except the player-facing text lives in config.yml. Every key has a comment right above it in the file, so you can tune it without leaving your editor. This page is the same information, laid out to skim.

After changing anything, run /dq reload. Only the storage section needs a full restart.

The whole file

# Bumped by the plugin, do not touch. Lets an update pour new keys into
# your old file while keeping the values and comments you already have.
config-version: 1

storage:
  # sqlite = a single data.db file in the plugin folder, works out of the box
  # mysql  = a database server, fill the details below if you pick this
  type: sqlite

  # Only used when type is mysql
  mysql:
    host: localhost
    port: 3306
    database: zdailyquests
    username: root
    password: ""
    use-ssl: false
    # How many connections to keep open. 6 is plenty for one server.
    pool-size: 6

# How many hours a set lives before it resets. 24 is the daily cycle.
# Drop it to 1 to test resets fast. The timer is per player.
reset-interval-hours: 24

# How many quests each player holds at a time.
quests-per-player: 5

# GLOBAL = all files flat in /quests, 5 random ones picked
# RARITY = files in /quests/easy, /normal, /hard, counts below decide the mix
quest-selection-mode: GLOBAL

# Only used in RARITY mode. Should add up to quests-per-player.
# If a folder runs short, the gap is filled from the whole pool.
rarity-counts:
  easy: 2
  normal: 2
  hard: 1

# On reset, try not to hand out the same set again. Relaxed if the pool is small.
avoid-repeat: true

# AUTO   = reward pays the moment the target is reached
# MANUAL = quest waits in the menu and the player clicks to claim
claim-mode: AUTO

# Extra reward for finishing every quest in the set. Fires once per set.
bonus-reward:
  commands:
    - "eco give %player% 1000"
  items:
    - material: DIAMOND
      amount: 2

# The quest board look. Full details on the Menu page. Leave it out for
# the classic three-row board.
menu:
  rows: 3
  hide-item-attributes: true
  open-sound: ""
  open-sound-volume: 1.0
  open-sound-pitch: 1.0
  filler:
    material: GRAY_STAINED_GLASS_PANE
    name: " "

Setting by setting

Setting	What it does	Default
`config-version`	Set by the plugin to drive auto-migration. Leave it alone.	`1`
`storage.type`	`sqlite` or `mysql`. See Storage.	`sqlite`
`storage.mysql.*`	Connection details, only read for MySQL.	localhost:3306
`reset-interval-hours`	Hours a set lives before it resets.	`24`
`quests-per-player`	Quests on each board.	`5`
`quest-selection-mode`	`GLOBAL` or `RARITY`. See Selection Modes.	`GLOBAL`
`rarity-counts`	How many from easy, normal, hard in RARITY mode.	2 / 2 / 1
`avoid-repeat`	Avoid repeating the last set on reset.	`true`
`claim-mode`	`AUTO` or `MANUAL`. See Claiming & Rewards.	`AUTO`
`bonus-reward`	The all-five bonus, commands and items.	eco + 2 diamonds
`menu`	Board size, filler, layout, heads and open sound. See The Menu.	3-row classic

Updating

Since build 1.0.0-5, config.yml and lang.yml migrate themselves. When you drop in a newer jar, the plugin reads config-version (and lang-version in the lang file), sees your file is behind, and backfills any new keys it added, keeping every value and comment you already set. This also runs on /dq reload. So a key you add by hand no longer gets silently ignored, and a new release no longer forces you to rebuild your config from scratch.

The Menu Size, filler, custom layout, head icons and the open sound.

Selection Modes GLOBAL versus RARITY, and how the mix is built.

Messages & Language Edit every line players see in lang.yml.

Storage & Data SQLite and MySQL, and what is stored.