Objectives

A task names a type. /uxmquests types prints every type this server feeds. A task filters on the facts its type reports: an option whose name matches a fact narrows the task, and a fact the task says nothing about counts every value. Options are written as described in quests.

Contents: Types · Trigger · Checked types · Sampled types · Anti-glitch

Types

player-walk and player-swim count blocks, player-playtime counts seconds.

A hunt for a hostile zombie that spawned naturally:

{ id = hunt, type = mob-kill, mob = ZOMBIE, spawn-reason = [NATURAL], hostile = "true", amount = 10 }

Trigger

trigger advances by command and by nothing else:

/uxmquests trigger <player> <trigger> <amount>

Any plugin that can run a command, such as a vote listener, a crate plugin or a command block, can feed a quest with no integration on either side.

{ id = vote, type = trigger, name = daily-vote, amount = 1 }

Checked types

get, location, player-permission and placeholder describe what is the case, not what happens. They are asked when a board is looked at and again on the sampling schedule.

{ id = stock, type = get,               item = DIAMOND, amount = 64 }
{ id = stand, type = location,          world = world, x = 100, y = 64, z = 100, radius = 10, amount = 1 }
{ id = away,  type = location,          world = world, x = 0, y = 64, z = 0, radius = 200, away = true, amount = 1 }
{ id = fly,   type = player-permission, permission = "essentials.fly", amount = 1 }
{ id = rich,  type = placeholder,       placeholder = "%vault_eco_balance%", operator = above, value = "1000", amount = 1 }

operator is equals, contains, starts-with, above or below; the default is equals. A checked task never goes backwards: a player who held sixty-four diamonds and then spent them has still held them.

Sampled types

Walking, swimming, jumping, looking at a block, standing somewhere and playing for a time have no cheap event. They are looked at on a schedule, so a jump that starts and lands between two samples is not counted.

objectives {
  sampling                   = true   # false: no task runs per player
  sample-interval-ticks      = 10
  placeholder-interval-ticks = 40
  look-distance              = 5
}

A server that writes none of these types sets sampling = false.

Anti-glitch

Three separate levels stop a player finishing a mining quest by placing a block and breaking it again.

Level three is off because it names a plugin the server may not run. Turned on without CoreProtect, the console says so once and the other levels keep working.

anti-glitch.bypass-permission (default uxmquests.bypass) turns every level off for the player who holds it, and the spawn-reason filter with it, so staff can test a quest. Leave it empty to give nobody a bypass.