LogBlock parameters: Difference between revisions

From RetroMC
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 29: Line 29:


* <code>block <block1> <block2></code>
* <code>block <block1> <block2></code>
The <code>block</code> parameter filters your selection by specific blocks; for example: <code>/lb area 5 player Aruamu block torch</code>
The <code>block</code> parameter filters your selection by specific blocks; for example: <code>/lb area 5 player Garsooon block torch</code>


* <code>player <username> <username2></code>
* <code>player <username> <username2></code>
The player parameter filters by players; multiple players can be input into the command by simply putting another one in before another parameter.<br />
The player parameter filters by players; multiple players can be input into the command by simply putting another one in before another parameter.<br />
For example: <code>/lb area 5 player Aruamu Noggisoggi</code><br />
For example: <code>/lb area 5 player Garsooon Noggisoggi</code><br />


* <code>created</code> or <code>destroyed</code>
* <code>created</code> or <code>destroyed</code>
Line 46: Line 46:
* <code>time</code>
* <code>time</code>
This is used to limit the query to a time frame '''before''' your current time.<br />
This is used to limit the query to a time frame '''before''' your current time.<br />
For example: <code>/lb area 5 Aruamu time 1d</code> would search your current area for {{user|Aruamu}}'s actions in a 5 block square, back to 1 day ago.<br />
For example: <code>/lb area 5 Garsooon time 1d</code> would search your current area for {{user|Garsooon}}'s actions in a 5 block square, back to 1 day ago.<br />
These abbreviations are used to specify a timeframe (Number goes before abbreviation):
These abbreviations are used to specify a timeframe (Number goes before abbreviation):
<code>d</code> (Days), <code>h</code> (Hours), <code>m</code> (Minutes), and <code>s</code> (Seconds)
<code>d</code> (Days), <code>h</code> (Hours), <code>m</code> (Minutes), and <code>s</code> (Seconds)

Revision as of 21:32, 1 April 2024

ℹ️ Notice: Only Staff have access to parameters.

Check LogBlock tutorial for a more introductory look.

Parameters ("Params" by LogBlock) are keywords used to edit how LB queries the database(s).
These can be as simple as limiting your query to a player's blocks or more advanced things, like limiting your query down to the date, and time down to the second.
.
/lb params allows you to see all parameters and their proper usage in game.

Examples:
Parameters are inserted where <param> is in the command, for instance: /lb area 5
Area is the parameter, with 5 being the radius in a square from the player's current position.

Location-based parameters

Location based parameters are use to specify a specific location either around the player, or WorldEdit region selection.

  • area (radius)

Area is used to search the immediate area around the player in a square radius.

  • sel or selection

It's used to search inside the current WorldEdit region selection.

  • world <world>

Changes the world for LB to check.
Not used often as LB always uses your current world. (id est, retromc (overworld), retromc_nether, farlands, skylands)

Filter-based parameters

Filter-based parameters are used to specify what filters to use for blocks/players when querying.

  • block <block1> <block2>

The block parameter filters your selection by specific blocks; for example: /lb area 5 player Garsooon block torch

  • player <username> <username2>

The player parameter filters by players; multiple players can be input into the command by simply putting another one in before another parameter.
For example: /lb area 5 player Garsooon Noggisoggi

  • created or destroyed
    A very useful parameter to check for either just destroyed or created blocks; by default, LB uses both and is not required to be specified.

  • chestaccess
    Shows chest access.

Time-based parameters

This one is pretty self explanatory – time parameters specify a specific time to search for LB entries.

  • time

This is used to limit the query to a time frame before your current time.
For example: /lb area 5 Garsooon time 1d would search your current area for 16.png Garsooon's actions in a 5 block square, back to 1 day ago.
These abbreviations are used to specify a timeframe (Number goes before abbreviation): d (Days), h (Hours), m (Minutes), and s (Seconds)

  • since

Much like the above parameter, since shows all results from a specified date in the format.
<dd.MM.yyyy> or <HH.mm.ss>

  • before

The opposite of the since parameter with the same formatting, this shows all results before the specified date.

Result parameters

  • sum <blocks|players>

The sum parameter allows you to summarize all blocks destroyed and created in a nice tabular column; the blocks sub-parameter summarizes by block type created and destroyed, unless otherwise specified.

The players sub-parameter allows you to sort by the amount of blocks created and destroyed by players in your selection, and can be specified down to the block via the above.

/!\: Please (for the love of Scout), never, EVER, use the sum parameter before the player parameter.
  • coords

This parameter displays all results from your selection with coordinates along with numbers in parentheses, and allows you to use /lb tp xwith x being the number next to the corresponding result.

Miscellaneous Parameters

Miscellaneous Parameters are parameters that don't exactly fall into the above categories, but may be useful nonetheless.

  • asc or desc

The asc or desc parameter displays the log generated from your command in either ascending or descending order; not very useful unless you have a large amount of results.

  • limit

The limit parameter limits how many rows show up when querying the database from your specified area; the default value is 15.

  • silent

Unknown.