award

award <creature> <label> [amount]

Record challenge progress for a player.

Challenges track a player's progress toward a goal by an integer count. award adds to that count for the challenge named by <label>, which is how a script credits a player for reaching a milestone — killing a target, finding an item, completing a step.

Arguments

• <creature> — the recipient. This is for players only: an NPC recipient is a no-op (nothing is recorded), so this is most useful guarded with isplayer.
• <label> — a string naming the challenge to credit. A label that matches no defined challenge logs a zone error and records nothing.
• [amount] — an int, how much progress to add. Defaults to 1 when omitted.

Returns

null. Like the other action commands, a successful award in the handle phase suppresses the event's default action.

Examples

after command (say) {
  require [isplayer $actor]
  award $actor "first-words" 1
}

The require guard limits the credit to players; the actor then gains one point of progress on the first-words challenge.

See also

• giveexp — grant raw experience rather than challenge progress.
• isplayer — guard award so it only credits players.
• Handlers, events, and phases