QuestCreator - Basics : quest flow - Historical

Applied By PYRRH4: Feb 12, 2018 at 1:23 AM

QuestCreator - Basics : quest flow
[​IMG]

Table of contents :

Commands and permissions
Plugin storage
Create a quest
Basics : variables
Basics : preconditions
Basics : quest settings
Basics : quest requirements
Basics : quest rewards
> Basics : quest flow
Basic : quest flow - tasks
Basics : quest flow - objectives


The basics : quest flow


It's the most important part of the configuration : what will happen in this quest ?
Every element that happen in the quest is located under the flow section.
An element is considered as a configuration section with its own settings.

Code (Text):
flow:
  1:
    # settings
  2:
    # settings
  # etc

There are two element types :
  • task, elements that will execute actions (send a message, place a block, teleport an NPC, drop an item, etc). The player has no influence on those.
  • objective, elements that the player will have to do (walk on X blocs, kill a mob, break a block, enchant an item, throw a potion, sneak, enter a vehicle, etc)


Quest flow : settings


Every element can have "universal" settings regardless of his type.

wait

Code (Text):
flow:
  1:
    wait: 1
The time in seconds that the plugin will wait until it executes the task / allows the player to complete the objective. This setting is optional.

preconditions
Code (Text):
flow:
  1:
    preconditions: 'var [variable] [operation] [value]'
If the preconditions are not completed, the element task/objective will be skipped.
For details about [variable], [operation] and [value], see Requirement precondition upper.
This is optional.

name
Code (Text):
flow:
  1:
    name: '&aDisplay name of this thing'
Required if it's an objective and optional if it's a task.

forbidden
Code (Text):
flow:
  1:
    forbidden:
      - PICKUP_ITEM
      - DROP_ITEM
While the task is executing / while the player completes the objective, he will be disallowed to do those actions.
Complete list of forbidden actions types :
Code (Text):

MOVE
ITEM_PICKUP
ITEM_DROP
ITEM_ENCHANT
ITEM_CONSUME
BLOCK_PLACE
BLOCK_BREAK
ENTITY_TAME
ENTITY_MOUNT
ENTITY_SHEAR
COMMAND
CHAT
INTERACT
BED_ENTER
FISH
VEHICLE_ENTER
VEHICLE_EXIT
 
This is optional.

drop_item
Code (Text):
flow:
  1:
    drop_item:
      item:
        type: STONE
        amount: 16
      location: world,0,0,0
It's an item that will be dropped when the task is over / when the player has completed the objective.
You can even add to the item name (text), data (number), lore (list) or enchants (list of enchants/levels, example DAMAGE_ALL,1).
This is optional.

custom_actionbar
Code (Text):
flow:
  1:
    custom_actionbar: '&a$QUEST | &a$OBJECTIVE'
This actionbar will be used instead of the general one.
This is optional.