Configuration

When Quests is first run, configuration files will be created in the /plugins/Quests directory. Each YAML configuration may vary depending on the version of Quests. However, examples of default configs and their values are provided below.

config.yml

language: en
allow-command-questing: true
allow-command-quests-with-npcs: false
show-requirements: true
allow-quitting: true
ignore-locked-quests: false
debug-mode: false
generate-files-on-join: true
kill-delay: 600
accept-timeout: 20
snoop: true
show-npc-effects: true
npc-effect: portal
max-quests: 0
convert-data-on-startup: false
quester-blacklist:
  - UUID
  - UUID
  - UUID
  - UUID

Key	Data Type	Description
language	string	Which language file ending in ".yml" will be used. For example, a value of "fr" will result in "fr.yml" being loaded.
allow-command-questing	true/false	Whether or not players are allowed to accept and manage quests via command (e.g. /quests take SomeQuest).
allow-command-quests-with-npcs	true/false	Whether players can accept/manage NPC quests via command (e.g. /quests take SomeQuest).
show-requirements	true/false	Allow players to see requirements for quests.
allow-quitting	true/false	If players are permitted to quit quests after taking them.
ignore-locked-quests	true/false	Ignore locked quests when checking if a player has a quest.
debug-mode	true/false	Whether to print debug information if an error occurs while loading.
generate-files-on-join	true/false	Generate a player data files when that player first joins the server or only when they he/she first uses Quests.
kill-delay	number	How long (in seconds) a player should have to wait after they kill a player for a quest before they can kill that player again.
accept-timeout	number	How long (in seconds) a player should be able to accept/deny a quest before the prompt cancels automatically.
show-npc-effects	true/false	Play a particle effect near NPCs that have an available quest for a player within 32 blocks?
npc-effect	string	The particle effect to be played (ex. note, enchant, crit, spell, portal).
max-quests	number	Maximum number of quests a given player can have at any time.
convert-data-on-startup	true/false	Replace username references in player data files with UUIDs from Mojang's account database.
quester-blacklist	list	An unlimited list of unique user IDs (UUIDs) for players that are to be completely ignored by Quests.

data.yml

This configuration file is used to store which NPCs are to display GUIs to players and will be empty if no GUIs have been set. Don't edit this file unless you know what you're doing.

events.yml

events:
  ExampleEvent:
    message: <red>Event happened!
    potion-effect-types:
    - Speed
    - Jump
    potion-effect-durations:
    - 100
    - 25
    potion-effect-amplifiers:
    - 3
    - 2
  GoodJob:
    message: <green>Good job!
  DeathFail:
    fail-quest: true
  FishingStart:
    message: <yellow>Type 'rod' in chat to get a fishing rod!
  RodEvent:
    message: <green>Here you go!
    items:
    - name-fishing_rod:amount-1

quests.yml

quests:
  Miner:
    name: Stone Miner
    ask-message: <yellow>Mine <purple>10<yellow> blocks of <purple>Stone<yellow> and gather the <purple>10 pieces of <purple>Cobblestone<yellow>.
    finish-message: <yellow>Well done. Here is your reward.
    redo-delay: 1800
    requirements:
      items:
      - name-wood_pickaxe:amount-1
      remove-items:
      - false
      fail-requirement-message: <red>You must have a <purple>Wooden Pickaxe<red> first.
    stages:
      ordered:
        '1':
          break-block-names:
          - stone
          break-block-amounts:
          - 10
          break-block-durability:
          - 0
    rewards:
      money: 1000
      quest-points: 1
  Hunter:
    name: Mob Hunter
    ask-message: <yellow>Kill an assortment of Mobs.
    finish-message: <yellow>Excellent. Here is a <purple>Diamond Sword<yellow>.
    requirements:
      quests:
      - Stone Miner
      fail-requirement-message: <red>Complete <purple>Stone Miner<red> first.
    stages:
      ordered:
        '1':
          death-event: DeathFail
          mobs-to-kill:
          - Pig
          mob-amounts:
          - 3
          finish-event: GoodJob
        '2':
          death-event: DeathFail
          mobs-to-kill:
          - Zombie
          mob-amounts:
          - 2
          finish-event: GoodJob
        '3':
          death-event: DeathFail
          mobs-to-kill:
          - Skeleton
          mob-amounts:
          - 1
    rewards:
      items:
      - name-diamond_sword:amount-1
      exp: 100
      quest-points: 1
  CatchFish:
    name: Catch Fish
    ask-message: <yellow>Catch some fish!
    finish-message: <yellow>Good job. Here is some <green>experience<yellow>.
    requirements:
      quests:
      - Stone Miner
      fail-requirement-message: <red>Complete <purple>Stone Miner<red> first.
    stages:
      ordered:
        '1':
          start-event: FishingStart
          death-event: DeathFail
          chat-events:
          - RodEvent
          chat-event-triggers:
          - rod
          fish-to-catch: 5
    rewards:
      exp: 250

Key	Data Type	Description
name	string	A name for the quest. This is what the player will see.
ask-message	string	Prompt sent to the player when he/she attempts to take the quest.
finish-message	string	A message sent to the player upon completing the quest.
npc-giver-id	number	The ID of the Citizens NPC that will hand out this quest.
redo-delay	number	Time (in seconds) that a player must wait before taking the quest again.
gui-display	itemstack	Item to be displayed as the quest's GUI item. Will show the ask-message as lore if no lore is set.
block-start	location	A block that the player can right-click on to take the quest. Format is "worldName x y z".
region	string	Name of a WorldGuard region that a player must be inside in order to accept the quest (via command).
event	list	The initial event to run when the player starts the quest.
requirements	list	Items and such required to being the quest. See "Requirements" below.
stages	ordered list	Data for each stage including items to deliver, string messages, et al. See "Stages" below.
rewards	list	Money, items, quest points, and other prizes to give the player upon completing the quest. See "Rewards" below.

Requirements

Key	Data Type	Description
items	itemstack	Items required to begin the quest.
remove-items	true/false	Whether the required items should be removed from the quester's inventory.
money	number	Amount of currency required to start the quest.
quest-points	number	Amount of Quest Points required to start the quest.
quests	list	Quests that must have been already completed to take the quest.
quest-blocks	list	Quests that, once completed, disable the player's ability to take the quest.
heroes-primary-class	string	Requires Heroes. Primary Heroes class needed to accept the quest.
heroes-secondary-class	string	Requires Heroes. Secondary Heroes class needed to accept the quest.
fail-requirement-message	string	Message to send to the player if the requirements are not met. This is necessary if a quest has any requirements.

Stages

Key	Data Type	Description
break-block-names	list	Material names of blocks for the quester to break.
break-block-amounts	list	Amounts of blocks that need to be broken.
break-block-durability	list	Durability of blocks that need to be broken.
damage-block-names	list	Material named of blocks for the quester to damage.
damage-block-amounts	list	Amounts of blocks that need to be damaged.
damage-block-durability	list	Durability of blocks that need to be damaged.
place-block-names	list	Material names of blocks for the quester to place.
place-block-amounts	list	Amounts of blocks that need to be placed.
place-block-durability	list	Durability of blocks that need to be placed.
use-block-names	list	Material names of blocks for the quester to use. For example, levers and doors.
use-block-amounts	list	Amounts of blocks that need to be used.
use-block-durability	list	Durability of blocks that need to be used.
cut-block-names	list	Material names of blocks for the quester to cut by right-clicking with shears.
cut-block-amounts	list	Amounts of blocks that need to be cut.
cut-block-durability	list	Durability of blocks that need to be cut.
fish-to-catch	number	Number of fish for the quester to catch via Fishing Rod.
players-to-kill	number	Number of players that need to be killed.
enchantments	string	Names of enchantments for the quester to enchant.
enchantment-item-names	list	Material names that the enchantments need to be applied to.
enchantment-amounts	list	Number of times the enchantments need to be enchanted on the items.
items-to-deliver	itemstack	Requires Citizens 2. Items for the quester to deliver to an NPC.
npc-delivery-ids	list	Requires Citizens 2. IDs of NPCs for whom the items must be delivered to.
delivery-messages	string	Requires Citizens 2. List of random messages to send to the player when they deliver a required item(s) to the NPC.
npc-ids-to-talk-to	list	Requires Citizens 2. IDs of NPCs that the quester must interact with by right-clicking.
npc-ids-to-kill	list	Requires Citizens 2. IDs of NPCs that need to be killed.
npc-kill-amounts	number	Requires Citizens 2. Number of times the NPCs need to be killed.
mobs-to-kill	list	Names of mobs that the quester must kill.
mob-amounts	number	Amounts of mobs that need to be killed.
locations-to-kill	list	World and coordinates that the mobs need to be killed at. Format is "worldName x y z".
kill-location-radii	number	The radius from which mobs can be killed. For example, a value of '10' would be 10 blocks around the location. Required if 'locations-to-kill' is present.
kill-location-names	list	Names of the locations (e.g. Cave). Required if 'locations-to-kill' is present.
locations-to-reach	list	Locations for the quester to reach, following this format. Format is "worldName x y z".
reach-location-radii	number	The redius from which the player can walk in and be considered at the location to reach. or example, a value of '10' would be 10 blocks around the location.
reach-location-names	list	Names of locations (e.g. Cave). Required if 'locations-to-reach' is present.
mobs-to-tame	list	Names of mobs for the quester to tame.
mob-tame-amounts	number	Amounts of mobs that need to be tamed.
sheep-to-shear	list	Colors of sheep for the quester to shear. Available colors can be found here.
sheep-amounts	number	Amounts of sheep that need to be sheared.
password-displays	list	List of questions to ask the player that they must answer.
password-phrases	list	List of answers that the player must type in chat.
script-to-run	string	Requires Denizen. Name of Denizen task script to be executed after the Stage is completed.
objective-override	string	This will be shown to the player as their current objective, rather than what the objectives would normally show.
start-event	string	Name of Event to fire when the Stage has begun.
finish-event	string	Name of Event to fire when the Stage is completed.
disconnect-event	string	Name of Event to fire when the player disconnects while on the Stage.
death-event	string	Name of Event to fire when the player dies while on the Stage.
chat-events	list	List of Events to fire when the player types respective chat triggers.
chat-event-triggers	list	List of chat messages that fire respective events when the player types them in.
delay	number	Amount of time (in seconds) that the player must wait after completing this Stage, before advancing to the next quest.
delay-message	string	Message sent to the player when the delay begins. This is not required to configure a delay.
start-message	string	Message displayed at start of a Stage.
finish-message	string	Message displayed at the completion of a Stage.

Rewards

Key	Data Type	Description
items	list	Item rewards for completing the quest.
money	number	Economy currency given as a reward to the player.
exp	number	Experience given as a reward to the player.
quest-points	number	Quest Points given as a reward to the player.
commands	list	List of commands to be executed by the server (You may use "<player>" to refer to the player who completed the Quest; e.g. "money give <player> 20")
permissions	list	List of permissions to be given to the player. The server must have a permissions plugin installed - SuperPerms will NOT work.
rpg-item-ids	list	Requires RPGItems. IDs of RPG Items that the quester will receive.
rpg-item-amounts	list	Requires RPGItems. Amount of each RPG Item to give to the player.
phat-loots	list	Requires PhatLoots. Names of PhatLoots that the quester must loot.
mcmmo-skills	list	Requires mcMMO. List of mcMMO skills to level up. For example, "Acrobatics", "Mining", or "All" to level all skills.
mcmmo-levels	number	Requires mcMMO. Amount of levels to level up.