Skip to content

@points

Administrative commands for modifying player point totals and merging player accounts.

@points add <nick> <amount> [reason]

Permission: MANAGE

Add points to a player. The amount is applied to all period scores (daily, weekly, monthly, alltime) simultaneously. An optional reason can be provided for the audit log.

Constraints:

  • Amount must be a positive integer, maximum 1,000,000
  • Target player must not have MANAGE or higher permission (protected users cannot have their points modified)
  • Scores cannot go below zero

Example:

@points add alice 100
@points add bob 500 Compensation for server outage

@points remove <nick> <amount> [reason]

Permission: MANAGE

Remove points from a player. The amount is deducted from all period scores (daily, weekly, monthly, alltime) simultaneously, with a floor of zero. An optional reason can be provided for the audit log.

Constraints:

  • Amount must be a positive integer, maximum 1,000,000
  • Target player must not have MANAGE or higher permission (protected users cannot have their points modified)
  • Scores are floored at zero (never go negative)

Example:

@points remove alice 50
@points remove bob 200 Cheating penalty

@points combine <target_nick> <source_nick>

Permission: ADMIN

Merge one player account into another. The source player's alltime score is added to the target's alltime score, all related records (game answers, question records, game sessions, permissions) are migrated to the target, and then the source user is permanently deleted.

Destructive operation

This permanently deletes the source player's account. Daily, weekly, and monthly scores from the source are discarded — only alltime scores are merged. This cannot be undone.

Constraints:

  • Requires ADMIN permission (higher than add/remove)
  • Target and source must be different players
  • Neither the target nor the source may have MANAGE or higher permission (protected users)
  • Question record conflicts are resolved by keeping the fastest answer time

Use case: When a player's hostmask changes and they end up with two separate user records, combine merges them into one.

Example:

@points combine alice alice_old

Audit Trail

All point modifications are logged in two places:

  1. Master log channel — an ADMIN event with the caller's hostmask, action details, and reason (if provided)
  2. IRC reply — confirmation message in the channel where the command was issued

Target Protection

Players with MANAGE or higher permission are protected from point modifications. This applies to all three sub-actions (add, remove, combine) and has no exemptions — even ADMINs cannot modify a protected player's points.