> For the complete documentation index, see [llms.txt](https://ezedits.gitbook.io/ezedits/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ezedits.gitbook.io/ezedits/masks-and-patterns/masks.md).
# Masks
### `#aim`
#aim Mask
**`#aim` or `#aim[True|False]`**
Takes the block the player is aiming at as the mask.
Optionally takes a True/False setting to make your aim sensitive to hitboxes.
* False will treat all blocks as full blocks. E.g. you cannot `#aim` at the block behind a button.
* True will respect the hitboxes of blocks you are looking at. E.g. you can `#aim` at the block behind a slab.
If the player is not looking at a block within range, the mask matches nothing.
### `#attached`
#attached mask
**`#attached[]`**
Masks to blocks which are attached to at least 1 adjacent non-air block.
Optionally takes a list of direction vectors to check instead of every side.\
e.g `#attached[up,down,left,north]`
\
In either case, attached means that the block is "touching" the adjacent block. So a bottom slab would not pass `#attached[up]` whereas a lantern with the state `[hanging=true]` would.
### `#blocklight`
#blocklight Mask
**`#blocklight[lightLevel]` or `#blocklight[minLevel][maxLevel]`**
Masks to blocks of a given block light (Illumination provided by light sources other than skylight). Optionally takes a minimum and maximum light level, matching any level within that range.
### `#clipblocks`
#clipblocks Mask
**`#clipblocks[][]`**\
Shorthand: **`#cb`**
Masks to blocks found in the player's clipboard.
Optional `` value of True or False to include air blocks. Defaults to **False**.\
e.g `#clipblocks[True]` includes air.
Optional `` value of True or False to determine if block data must also match. Defaults to **False**.\
e.g `#clipblocks[False][True]` matches exact block states.
### `#current`
#current mask
Shorthand: **`#c`**
A mask which represents your current global mask (gmask).
e.g running `//gmask !#current` will invert your current gmask
### `#eznoisemask`
#eznoisemask Mask
**`#eznoisemask[noisePreset][][][]`**\
**Alias: `#eznm`**
Uses a noise preset values `0.0-1.0` to match blocks above a given noise threshold.
### `#fullblock`
#fullblock mask
Masks to blocks which fill an entire cube space.
e.g 1-7 layers of snow will not pass, but 8 layers of snow, a block like stone, or a transparent block like glass will pass.
### `#fuzzypalette`
#fuzzypalette mask
**`#fuzzypalette[palette]`**
Shorthand: **`#fpalette`**
Masks to blocks which match any block in the palette, regardless of block data.\
Equivalent to **`#palette[palette][False]`**
### `#infested`
#infested mask
Masks to blocks which are infested with silverfish.
### `#lightsource`
#lightsource Mask
**`#lightsource` or `#lightsource[lightLevel]` or `#lightsource[minLevel][maxLevel]`**
Masks to blocks which emit light. Optionally takes a specific light level to match, or minimum and maximum light level, matching any level within that range.
### `#near`
#near Mask
**`#near[mask][distance]`**\
\&#xNAN;**`#near[mask][minDistance][maxDistance]`**\
\
Masks to all blocks within a given spherical (Euclidean) distance of a mask.\
Doesn't modify blocks which match the inner `mask`.\
Can also be set to exclude blocks closer than the minimum distance.\\
 **`[mask]`**
**`[distance]`**
**`[minDistance][maxDistance]`**
### `#palette`
#palette mask
**`#palette[palette][]`**
Masks to blocks which match any block in the palette.
Optional `` value of True or False to determine if block data must also match.\
e.g `oak_stairs[facing=east]` will only match with `oak_stairs[facing=west]` if strict is set to **False**.
### `#radialgradientmask`
#radialgradient mask
**`#radialgradientmask[distance][][][][]`**
Shorthand: `#rgradientm`
Masks blocks based on distance from the player. With closer blocks more likely to pass the mask check.\
Compatible with noise presets.
### `#schemblocks`
#schemblocks Mask
**`#schemblocks[][][]`**\
Shorthand: **`#sb`**
Masks to blocks found in a schematic file.
Optional `` value of True or False to include air blocks. Defaults to **False**.\
e.g `#schemblocks[mybuild][True]` includes air.
Optional `` value of True or False to determine if block data must also match. Defaults to **False**.\
e.g `#schemblocks[mybuild][False][True]` matches exact block states.
### `#truelight`
#truelight Mask
**`#truelight[lightLevel]` or `#truelight[minLevel][maxLevel]`**
Masks to blocks of a given total light level (Illimunation provided by any light sources including skylight). Optionally takes a minimum and maximum light level, matching any level within that range.
### `#vectorgradientmask`
#vectorgradientmask Mask
**`#vectorgradientmask[vector][distance][][][]`**
Shorthand: `#vgradientm`
Masks blocks along a vector with a given distance length. With closer blocks more likely to pass the mask check.\
Compatible with noise presets.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ezedits.gitbook.io/ezedits/masks-and-patterns/masks.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.