My First Scan

My First Scan

In this guide, we’ll walk through how to scan an area to find obsidian blocks.

To perform a scan, you’ll need:

• Two opposite corners of a cubic region (coordinates)
• A whitelist file that defines which blocks to look for

---

Step 1: Create a Whitelist

1. Open the mod settings by pressing Left Alt + ] (default keybind).
2. In the settings screen, click the "Whitelists" button in the bottom-left corner.
3. You’ll see an empty whitelist selection screen. At the top, enter a name for your new whitelist — for this example, type obsidian — and click Create.
4. A new button labeled obsidian will appear with an X next to it. Click the obsidian button to open the whitelist editor.

If the UI appears too large or clipped, try reducing the GUI scale in Minecraft’s video settings.

5. In the whitelist editor, locate the top-left input field labeled Block.
6. Type obsidian into this field.
7. Once entered, the "Add to whitelist" button below will become active - click it.
8. Congratulations! You’ve created your first working whitelist. Press Esc to return to the game.

---

Step 2: Scan the Area

There are two ways to start a scan:

Option A: Using a Command

Use the following syntax: /scan <x1> <y1> <z1> <x2> <y2> <z2> whitelist <filename>.json

• <x1 y1 z1> and <x2 y2 z2> are opposite corners of the cubic region you want to scan.
• <filename>.json is the name of your whitelist file (e.g., obsidian.json).

Example:
To scan a 1000×1000 area from world origin: /scan 0 -63 0 1000 64 1000 whitelist obsidian.json

What Happens Next?

• You’ll see colored faces outlining the scanned volume.
• Yellow squares may appear beneath you - these represent chunks that need to be loaded for scanning. Since you’re already in them, they’ll be processed immediately.
• In the bottom-right HUD, you’ll see two lines:
  • Selected blocks: number of matching blocks found (and coordinates of one of them)
  • Unchecked chunks: number of chunks still pending scan

When both lines disappear, the scan is complete. You’ll also receive a chat message and an audible notification.

• If Selected blocks > 0, look around: you’ll see red-highlighted blocks (or red vertical lines at horizon level if they’re far away). These indicate found obsidian.
  • Try placing an obsidian block nearby - it should also be highlighted.
  • Distant highlights appear as vertical lines at eye level; as you approach, they “drop down” to the actual block position for better visibility.

All highlight colors are customizable. See the Config page for details.

• To finish the scan, move around the entire region so all chunks get loaded. The Unchecked chunks counter will decrease until it reaches zero.
• While moving, you might see Processed chunks: N in the HUD. Avoid letting this number grow too large - wait for it to drop before continuing.
  • You can reduce Chunk scan cooldown in the settings (Alt + ]) to process chunks faster if Processed chunks accumulates.

---

Option B: Using the GUI

1. Open mod settings (Alt + ]) and click the Task button at the bottom.
2. You’ll enter the Task Manager interface:
   • Top: two panels for entering scan coordinates
   • Bottom: scan control buttons
3. If a scan is already running, you’ll see its progress. Click Stop scan if needed.

4. Enter the same coordinates as before:
   • First corner: 0 -63 0
   • Second corner: 1000 64 1000

Tip: Hover over the +/- buttons next to each coordinate field. You can adjust values using:

• Left-click, Right-click, or Mouse wheel
• Hold Shift, Ctrl, or Alt for finer/coarser adjustments

5. From the dropdown below, select your obsidian.json whitelist.
6. Click Start scan.

The scan will begin exactly as described in the command method.

---

Now you’re ready to explore your world with AreaScanner! May the Force be with you!