Queries are parts of /pmdelete and /pmhistory commands allowing for more precise messages selection.
When using them with /pmdelete command, we enter whole query as first argument after command name. When using them with /pmhistory command, we need to add -query (or -q) as first argument of command and then insert our query as second argument.

There are 6 keywords we use when looking for messages.
BEFORE, AFTER, SINCE, TO, RANGE – keywords used with dates
ALL – keyword matching all existing messages – depending on our choice, these may be all messages stored on server, all messages of given player or all messages between two players

BEFORE keyword matches messages sent before given datetime.
AFTER keyword matches messages sent after given datetime.
SINCE keyword matches messages sent since given datetime (including it).
TO keyword matches messages sent to given datetime (including it).
RANGE keyword matches messages sent in range of two datetimes (including them).

Query construction:

Queries without target player included

• „ALL” – all messages on server
• „BEFORE [datetime]” / „AFTER [datetime]” / „SINCE [datetime]” / „TO [datetime]” / „RANGE [datetime1] [datetime2]” – messages matching datetime criteria
• „[ID]” – matches message with given ID
• „[ID,ID₂,ID₃…]” – matches messages with given ID’s

Examples in commands
/pmhistory -q ALL – show history of all messages
/pmhistory -q RANGE 10.10.2020 10.12.2020 – show history of all messages sent from 10.10.2020 to 10.12.2020 inclusive
/pmdelete BEFORE 10.10.2020 – delete all messages sent before 10.10.2020
/pmdelete 214 – delete message with ID 214
/pmdelete 3,9,12 – delete messages with ID of 3,9 and 12

Queries with target player included

• „[playername] ALL” – all messages of player on server
• „[playername],[second_player_name] ALL” – all messages between two players on server
• „[playername] BEFORE [datetime]” / „[playername] AFTER [datetime]” / „[playername] SINCE [datetime]” / „[playername] TO [datetime]” / „[playername] RANGE [datetime1] [datetime2]” – messages of player matching datetime criteria
• „[playername],[second_player_name] BEFORE [datetime]” / „[playername],[second_player_name] AFTER [datetime]” / „[playername],[second_player_name] SINCE [datetime]” / „[playername],[second_player_name] TO [datetime]” / „[playername],[second_player_name] RANGE [datetime1] [datetime2]” – messages between two players matching datetime criteria

Examples in commands
/pmhistory -q Jack ALL – show history of all messages with player Jack
/pmhistory -q John,Rose RANGE 10.10.2020 10.12.2020 – show history of all messages between player John and Rose sent from 10.10.2020 to 10.12.2020 inclusive
/pmdelete Notch BEFORE 10.10.2020 – delete all messages of player Notch sent before 10.10.2020
/pmdelete Steve,Alex AFTER 04.30.2022-11:34 – delete all messages between player Steve and Alex sent after 04.30.2022 11:34

Datetime format
By default, it’s possible to pass date and time in following format:

• MM.dd.yyyy
• MM.dd.yyyy-HH:mm
• MM.dd.yyyy-HH:mm:ss

Accepted formats are controlled by InCommandDateTimeFormat setting in config.yml.