Commands - ks-hl/AuxProtect GitHub Wiki
/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
hurtactions 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
- Look up all IP addresses Heliosares has used
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. |
-
#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.
Manually creates a save of the player's inventory under 'action:inventory target:manual'
/ap saveinv <player>
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>
Shows a graphical representation of a player’s money history using a map. (EXPERIMENTAL)
/ap money <player>
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]
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>
This command is only for admins, this is how the old data is removed from the database.
/ap purge <table | all> <time>
Can only be executed from console. Creates a backup of the SQLite database in plugins/AuxProtect/database/backups.


