Whitelists

Whitelists are JSON files located in the config/AreaScanner/scan_whitelists/ directory. They contain a single large Condition used by the scanner to mark specific blocks.

How the Logic Works

Important

• Elements in an array [...] are combined using OR.
• Properties within a single JSON object {...} are combined using AND.

Example 1: Fluids and Waterlogged

Let's look at a simple template:

{
  "whitelist": [
    { "block": "=minecraft:water" },
    { "block": "=minecraft:lava" },
    { "waterlogged": "true" }
  ]
}

This whitelist contains 3 simple conditions:

1. "block": "=minecraft:water"
2. "block": "=minecraft:lava"
3. "waterlogged": "true"

All of them are combined via OR: 1 OR 2 OR 3. If the scanner encounters water, lava, or a waterlogged block, it will mark it.

Example 2: Quarry

Now, let's look at a more complex example:

{
  "whitelist": [
    { "pistonBehavior": "=IMMOVABLE" },
    { 
      "blastResistance": ">9",
      "pistonBehavior": "≠DESTROY" 
    },
    { "block": "=minecraft:white_glazed_terracotta" },
    { "block": "=minecraft:orange_glazed_terracotta" }
  ]
}

As we know, conditions in the array are combined via OR, but properties inside a single { } block (like the second element) are combined via AND. Let's break it down:

1. "pistonBehavior": "=IMMOVABLE"
2. "blastResistance": ">9"
3. "pistonBehavior": "≠DESTROY"
4. "block": "=minecraft:white_glazed_terracotta"
5. "block": "=minecraft:orange_glazed_terracotta"

The final Condition formula: 1 OR (2 AND 3) OR 4 OR 5.

---

In-Game Creation & Setup

Now that we understand the internal structure, let's move to Minecraft.

To create a whitelist, open the menu (Alt + ]) and click the Whitelists button in the bottom left corner. This will open a window showing your existing whitelists and an input field to create a new one:

Clicking on a created list will take you to the editing window. Let's break down its elements:

1. Block — Equals or not equals the block you type into the text field on the right.

Warning

Be careful with the "not equals" (≠) operator; it can select almost everything in the world and cause severe lag!

2. Waterlogged (true/false) — Waterlogged blocks, such as stairs, leaves, etc.
3. Piston Behavior (NORMAL/IMMOVABLE/DESTROY) — How the block behaves when pushed by a piston.
   • NORMAL — Standard behavior (stone).
   • IMMOVABLE — Cannot be pushed (obsidian).
   • DESTROY — Breaks when pushed (leaves).
4. Blast resistance — The block's explosion resistance.
5. Raw Condition String — A text field that converts your raw input into a single {} condition block.
6. Add Condition Button — Adds a new empty {} condition block.
7. Conditions List — A list of all conditions combined via OR. You can hover over them to preview their contents or click the X to delete them.

Presets

On the right side of the editing window, you will find the Presets panel. You can select any template from the dropdown menu, click Use preset, and all of its conditions will be automatically added to your current whitelist.

---

Commands

You can also manage whitelists via chat using the following command: /scan whitelists

This command allows you to:

• Create an empty whitelist.
• Delete an existing one.
• Output the raw text contents of a whitelist into the chat.