Commands - ks-hl/AuxProtect GitHub Wiki

/ap lookup

Syntax

/ap lookup <parameters> (See below for parameters)

  • Examples:
    • Look up all IP addresses Heliosares has used
      • /ap l user:Heliosares action:ip
    • Look up all hurt actions Heliosares has performed in the last 10 minutes within 30 blocks:
      • /ap l user:Heliosares action:hurt time:10m radius:30
    • View all logged inventories for Heliosares between 10 and 20 minutes ago:
      • /ap l user:Heliosares action:inventory time:10m-20m

Parameters

Most parameters can be negated using a !.

Parameter Can be negated Description Example
Time No Used to restrict the time of a lookup. You can also specify ranges here using a - time:1d-2d
Before/After No To narrow down a time window. Does the same thing as a time range above, but you can specify just one or the other. before:1d after:2d
User Yes The entity or player who caused the event. Can be negated and multiple users can be separated by a ,.
Action No Search by action. You can group actions in a single lookup, but the actions you group must be from the same action group (See Actions)
Target Yes Typically used to specifying either a target entity/player or a target item. This is not exclusive to that use, some actions use it for other things, such as a:IP for the IP address or a:username for the username. Can be negated. You can also use * as a wildcard. Because commas are used to separate multiple parameters, they can be escaped using a \ Any target starting with 'Helios': target:Helios* Any target starting with 'Helios,': target:Helios\,*
Data Yes Search by extra data on the end of the entry. This uses the same syntax as target:
Radius Yes Limits lookup to a box, extending the entire height of the map, with a specified radius from the player. Radius of 0 is a 1x1, Radius of 1 is a 3x3, and so on. Can be negated to lookup only outside of a radius. Within 10 blocks: radius:10, NOT within 10 blocks: radius:!10
World Yes Restrict a lookup to a specific world or group of worlds.

Flags

  • #count - Counts the number of entries in the lookup. Certain actions have special functionality:
    • shop, ahbuy - Totals the net money involved.
    • drop, pickup - Totals the number of items involved. (Not just the number of entries)
  • #count-only - A more rudimentary version of #count. This only counts the number of rows and is not limited to 500,000 entries like all other lookups.
  • #hide-coords - Hides coordinates from the lookup results.
  • #playtime - Displays a graphic representation of a player's playtime. This flag is used by /ap playtime.
  • #combine_user_target - Adds everything from the 'user' to the 'target' and vice versa. Useful for searching a:hurt between two players
  • #money - Gives the executor a map with a graph of a player's money. This flag is used by /ap money, it is best to let /ap money handle it.
  • #radius_horizontal_only - By default AuxProtect searches within a cube of the specified radius in all directions. This flag makes the radius only apply to X and Z, matching any Y value in that column.

/ap saveinv

Manually creates a save of the player's inventory under 'action:inventory target:manual'

/ap saveinv <player>

/ap playtime

Shows a graphical representation of a player’s playtime over the last 14 days. Useful for determining player activity. Each row is a day, each cell is an hour. The amount of online time within that hour determines the color of the cell. Playtime for that day is totaled on the right.

/ap playtime <player>

/ap money

Shows a graphical representation of a player’s money history using a map. (EXPERIMENTAL)

/ap money <player>

/ap inventory

An alias for /ap l action:inventory user:<player> time:[time]. Shows a lookup of the player's inventory logs over the time range specified, or 2 weeks if not specified.

/ap inventory <player> [time]

/claiminv

Used by players to claim their recovered inventories when restored by staff.

/claiminv

It can also be used to revoke a restored inventory before claimed, in the event a mistake is made.

/claiminv <name>

/ap purge

This command is only for admins, this is how the old data is removed from the database.

/ap purge <table | all> <time>

/ap backup

Can only be executed from console. Creates a backup of the SQLite database in plugins/AuxProtect/database/backups.

⚠️ **GitHub.com Fallback** ⚠️