QuestCreator - Basics : quest flow

Feb 12, 2018
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
    Basics : quest flow - tasks
    Basics : quest flow - objectives
    Developpers API

    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.
  • Loading...
  • Loading...