Skip to content

Chunk Filter

Querz edited this page Feb 25, 2024 · 6 revisions

MCA Selector contains a powerful tool to select, export or delete chunks and regions by conditions like the data version, the time it was last updated, how much time players have spent in this chunk and some more. Multiple of these conditions can be chained together to create a very specific query describing what chunks and regions should be selected, exported or deleted.

MCA Selector window showing the chunk 
filter


Filter types

Because the conditions use internal values used by Minecraft, the following table gives a brief explanation on what they do:

Condition Type Description
Group - Groups multiple conditions.
Not Group - A negated group.
DataVersion int The DataVersion tag of the chunk. 100-1343 for 1.12.2 and below, 1444 for 1.13 snapshots and above.
InhabitedTime long The total amount of time in game-ticks players have spent in that chunk. 1 second is ~20 ticks. Also accepts a duration string such as 1 year 2 months 3 days 4 hours 5 minutes 6 seconds.
Timestamp int The time a chunk was last saved in epoch seconds. Also accepts a timestamp in the yyyy-MM-dd HH-mm-ss-format such as 2018-01-02 15:03:04. If the time is omitted, it will default to 00:00:00.
LastUpdate long The time a chunk was last saved in ticks since world creation. 1 second is ~20 ticks. Also accepts a duration string such as 1 year 2 months 3 days 4 hours 5 minutes 6 seconds.
xPos int The location of the chunk on the x-axis in chunk coordinates.
yPos int The location of the lowest section of this chunk. Introduced with DataVersion 2844 (21w43a).
zPos int The location of the chunk on the z-axis in chunk coordinates.
Palette String A list of comma (,) separated 1.13 block names. The block names will be converted to block ids for chunks with DataVersion 1343 or below. The validation of block names can be skipped by writing them in single quotes ('). Example: sand,'new_block',gravel.
Status String The status of the chunk generation. Only recognized by Minecraft 1.13+ (DataVersion 1444+)
LightPopulated byte Whether the light levels for the chunk have been calculated. If this is set to 0, converting a world from 1.12.x to 1.13 will omit that chunk. Allowed values are 0 and 1.
Biome String/int One or multiple biome names and IDs, separated by comma (,). For a reference of biome names and IDs, have a look at the Wiki. Custom biomes can be specified by using single quotes (') around a biome ID.
Entities String One or multiple entity names, separated by comma (,). For a reference of entity names, have a look at the Wiki. Custom entities are supported, though they must be declared in single quotes (') and with their namespace id.
Structures String One or multiple structure names, separated by comma (,). A list of all valid structure names can be found here. Custom structures are supported, though they must be declared in single quotes (').
#Entities int The total amount of entities in that chunk.
#TileEntities int The total amount of tile entities in that chunk.
PlayerLocation String Loads player locations from a directory containing player data files. The syntax is the following: <directory><path-separator><dimension>. directory is the path to the player data files, path-separator is the path separator used on the current OS to separate paths (; on Windows, : on Mac / Linux) and dimension is the dimension of the player location, e.g. minecraft:overworld (or e.g. 1 in older Minecraft versions).
PlayerSpawn String Loads player spawn locations from a directory containing player data files. The syntax is identical to the PlayerLocation filter.
Circle String Creates a circular selection starting at a center point with a specific radius. Syntax: <center-x>;<center-z>;<radius>. The center coordinates are chunk coordinates and the radius is measured in chunks. Multiple circles can be chained with a comma (,).
Border int Selects all chunks where the number of empty neighboring chunks is equal or larger than the specified number. This filter can only be used to create selections.

Fields that allow multiple comma separated values act the same as multiple consecutive filters of the same type with single values connected with the AND operator.


Filter string

A string representation of the query is printed in a text field below the query editor. When entering a query into this field directly, press Enter to parse it into the query editor.

Options

Select

When this option is selected, a selection will be created for all chunks matching this filter. When this option is selected, Selection radius can also be set. Setting the selection radius will additionally select all chunks in every direction (north, south, east and west) with this distance.

Export

All chunks matching this filter will be exported into a new empty folder. This will create a new region, poi and entities folder if necessary. A selection will not be created and the original files will not be changed.

Delete

All chunks matching this filter will be deleted in the original files. This operation is instant and there is no going back. Make sure to make a backup before deleting chunks!


Notice

Running the query will check the .mca-file's name first if the query would even apply to any chunk in this file using the xPos and zPos conditions, as long as the query is built in a way that allows doing this.

Clone this wiki locally