QuestCreator/任务类型

任务类型

为了检测到你的任务并正常运行, 任务需要分类.

categories.yml (汉化配置) :

#----------------------------------------------------------------------------------------------------
# QuestCreator任务类型文件
#----------------------------------------------------------------------------------------------------

# 这里登记了你的所有任务

categories:
  
  # 示例类型
  example:
    # 激活器 (详情查看插件百科)
    activator:
      type: ENABLED
    # 可同时接受任务上限 (对于单个玩家)
    max_concurrent: 100
    # 是否按顺序执行任务列表呢的任务?
    execution_order: false
    # ... 如果启用, 是否需要完成上一个任务才能开始下一个任务 ?
    previous_quest_required: false
    # 任务列表
    quest_list:
      - example
    # 这个任务类型的菜单名
    gui_name: 'Example Quest'
    # 是否在菜单内右击物品开始任务?
    gui_right_click_start: true
  
  # 默认挖掘任务类型
  example_farm:
    activator:
      type: ENABLED
    max_concurrent: 1
    execution_order: true
    previous_quest_required: true
    quest_list:
      - example_farm_1
      - example_farm_2
    gui_name: '示例挖掘任务类型'
    gui_right_click_start: true

# NPC任务类型
# 在这里你可以减少对任务NPC的配置, 名为 'npc_[id]' 的类型将会被自动创建
compact_npc_categories:
  0:
    quest_list:
      - my_quest
    selection_gui_when_one_quest: false
    start_click_type: RIGHT_CLICK
    sneak_click_cancel: false
    particle_available: VILLAGER_HAPPY
    particle_progress: FIREWORKS_SPARK
    particle_cooldown: CLOUD
    particle_completed: CLOUD

简介

• 任务类型是 '一组任务' (也可以是一个任务).
• 任务类型可按顺序执行.
• 所有类型的任务都以同样的方式启用 (与NPC、方块交互或自动开始、每日任务、延迟任务、worldguard区域等).
• 一个类型的任务可以设置前置任务才能开始下一个任务(如果设置了执行顺序).
• 一个类型的任务可以拥有独立的菜单 (在菜单配置内设置 'link: category_[name]').
• 一个类型的任务可以拥有同时进行的任务上限.
• 每个类型的任务都有独立的配置.

my_category:
  activator:
    # 激活器设置，详情看下面
  max_concurrent: 100
  execution_order: true
  previous_quest_required: true
  quest_list:
    - my_quest_1
    - my_quest_2
  gui_name: 'Example Quest'
  gui_right_click_start: true

• activator 是包含激活设置的配置部分. 详情如下.
• max_concurrent 为每名玩家的这种任务的最大同时进行上限.
• execution_order (可选) 按任务列表顺序执行.
• previous_quest_required (可选) 如果 execution_order 为 true 请启用这些，是否需要前置任务才能开始下一个任务.
• quest_list 任务列表（使用任务id）.
• gui_name 任务类型菜单名.
• gui_right_click_start (可选) should be true if you want the quest to start when right-clicking the GUI item.

激活器

• 激活器是任务的 '触发器' 并且设置了任务开始所需的条件.
• 每个激活器拥有独立的配置选项.

activator:
  type: ENABLED

• type 激活器类型 (详情如下).

激活器类型

AUTO · 自动开始

任务会尽可能地自动开始.

activator:
  type: AUTO

BLOCK · 交互方块

任务会在玩家交互一个方块后开始.

activator:
  type: BLOCK
  block: world,0,0,0
  selection_gui_when_one_quest: false
  start_click_type: RIGHT_CLICK
  sneak_click_cancel: false
  particle_available: VILLAGER_HAPPY
  particle_progress: FIREWORKS_SPARK
  particle_cooldown: CLOUD
  particle_completed: CLOUD

• block 为方块位置.
• selection_gui_when_one_quest (可选) 是否在点击方块时出现选择任务菜单.
• start_click_type is the click type required to start the quest (can be : `RIGHT_CLICK, LEFT_CLICK')
• sneak_click_cancel (可选) should be true if you wish the active quest to be cancelled when clicking the block while sneaking.
• particle_[...] is the particle effect that will be displayed on this block if there's a quest available (remove those lines for no effect).

DAILY · 每日任务

任务会每日开始. 注意这不会重置进行中的任务.

activator:
  type: DAILY
  hour_of_day: 0

• hour_of_day (可选) 一天的时间 (24小时格式).

DELAY · 延迟任务

任务会在上一次完成后一段时间重新开始.

activator:
  type: DELAY
  delay: 10080

• hour_of_day 延迟, 单位为分钟.

DISABLED · 关闭

无法接受任务.

activator:
  type: DISABLED

ENABLED · 启用

任务由玩家选择开始 (如点击菜单或输入指令).

activator:
  type: ENABLED

ENTITY ·实体

任务会在玩家与命名的实体交互时开始. 同样可用于Citizens的NPC名称 , 但推荐使用 NPC 激活器.

activator:
  type: ENTITY
  name: '&c超级苦力怕'
  selection_gui_when_one_quest: false
  sneak_click_cancel: false
  particle_yoff: 2.0
  particle_available: VILLAGER_HAPPY
  particle_progress: FIREWORKS_SPARK
  particle_cooldown: CLOUD
  particle_completed: CLOUD

• name为自定义的实体名(可隐藏).
• selection_gui_when_one_quest (可选) 是否在点击实体时出现选择任务菜单.
• sneak_click_cancel (可选) 是否可用潜行点击实体来取消任务.
• particle_yoff 为粒子效果的垂直偏移量.
• particle_[...] 为在有可接受任务时在NPC头上显示的粒子效果名 (删除这一行则无效果).

FIRSTCONNECT · 第一次登录

任务会在玩家第一次登录服务器时开始.

activator:
  type: FIRSTCONNECT

NPC

任务会在玩家与NPC交互时开始.

activator:
  type: NPC
  id: 0
  selection_gui_when_one_quest: false
  start_click_type: RIGHT_CLICK
  sneak_click_cancel: false
  particle_available: VILLAGER_HAPPY
  particle_progress: FIREWORKS_SPARK
  particle_cooldown: CLOUD
  particle_completed: CLOUD

• id is the Citizens NPC id.
• selection_gui_when_one_quest (可选) should be true if you wish the selection GUI to appear when clicking the NPC even if there's only one quest available.
• start_click_type is the click type required to start the quest (can be : `RIGHT_CLICK, LEFT_CLICK')
• sneak_click_cancel (可选) should be true if you wish the active quest to be cancelled when clicking the NPC while sneaking.
• particle_[...] is the particle effect that will be displayed above this NPC if there's a quest available (remove those lines for no effect).

PRECISE_ENTITY

The quest will attempt to start when the player interacts with a precise entity.

activator:
  type: PRECISE_ENTITY
  uuid: 662812ef-ddba-3699-8a5e-3a924376769c
  selection_gui_when_one_quest: false
  sneak_click_cancel: false
  particle_yoff: 2.0
  particle_available: VILLAGER_HAPPY
  particle_progress: FIREWORKS_SPARK
  particle_cooldown: CLOUD
  particle_completed: CLOUD

• uuid is the entity unique id.
• selection_gui_when_one_quest (可选) should be true if you wish the selection GUI to appear when clicking the entity even if there's only one quest available.
• sneak_click_cancel (可选) should be true if you wish the active quest to be cancelled when clicking the entity while sneaking.
• particle_yoff is the particle vertical offset.
• particle_[...] is the particle effect that will be displayed above this NPC if there's a quest available (remove those lines for no effect).

WORLDGUARD_REGION

The quest will attempt to start when the player will be in a WorldGuard region. Note that this is not instant, the check is made every minute.

activator:
  type: WORLDGUARD_REGION
  world: world
  region: region

• world is the world in which the region is.
• region is the WorldGuard region id.