Tasks

Tasks, as explained before, are the requirements to complete quests. PBQ comes with several useful tasks that you can use, and will be explained below.

Cost (pbq:cost)

Cost task. Available only if an economy plugin is loaded.

{
    cost=0
    id=1
}

Item (pbq:item)

Simple item task. For advanced item requirements, see ByteItem.

{
    amount=1
    id=0
    item="minecraft:stone"
}

Kill (pbq:kill)

Kill a certain quantity of entities. If mode = 1, it will require you to kill specific entities (with the specified ID). If mode = 2, it will ignore the type and count any entity killed.

{
    # checking mode. 1 = killed at least <count> specific entities, 2 = killed at least <count> entities
    checkMode=1
    count=5
    id=0
    mob="minecraft:zombie"
}

Permission (pbq:permission)

Permission requirement for players. %line% and %id% are replaced when checking.

{
    id=0
    permission="pbq.quest.%line%.%id%"
}

Progress (pbq:progress_required)

Progress requirement on the quest's quest line. The mode defines if it should require a minimum progress, exact or maximum progress on the quest line.

{
    id=0
    # 1 = min, 2 = exact, 3 = max
    progressCheckMode=3
    progressRequired=0
    sendMessage=true
}

Visit (pbq:visit)

Visit location task. This task gets completed when the player visits the specified location in the world (around the radius). Setting radius to a high value might cause a lot of checks, resulting in lag.

{
    id=0
    visitLocation="0,0,0,world"
    visitRadius=5
}

ByteItem (pbq:byteitem)

Advanced Item task, supporting ByteItems items.

{
    id=6
    byteItemId="byte-items:default"
    amount=10
}