Computercraft-Turtle-Quarry-Script/Clarths-Instructions.md

# Instructions 

## Notes
- Steps 1-4 only needs done the 1st time you place down a turtle. 
- Step 5 is optional
- Step 6 is what you run each time you place down a previsouly configured turtle.

## Usage
1. Place turtle, and a chest to the left of it.

2. R-click turtle

3. Set name
```set name <name>```

4a. The black list feature from step 5a stopped working sometime around 1.19.2 so I started hardcoding the black list into the script. You can download my version from github using:
```wget https://git.claytonia.net/Clarth/ComputerCraft-Turtle-Quarry-Script/raw/branch/main/quarry.lua quarry```


<del>4a. Download quarry program from pastebin
```pastebin get rpXRAZs4 quarry```</del>

5a. Create black-list
```edit no-mine-me```

5b. paste in blacklisted mats. This step is only needed it you want the turtle to disreguard stone/cobble. Use step 6a if you wish to have a blacklist. 

Example:
```
minecraft:stone
minecraft:chest
minecraft:sand
minecraft:torch
ThermalExpansion:Sponge
ThermalFoundation:Storage
minecraft:diorite
minecraft:andesite
minecraft:granite

```

5c. Not nessisary for everyone, only need to do this if the blacklist feature fails for you. Skip this step unless you know what you're doing. 
The black list feature from step 5a stopped working sometime around 1.19.2 so I started hardcoding the black list into the script. You can add blocks to the blacklist in the script around line 768. 
Example:

```
--oreQuarry blacklist
local blacklist = { "minecraft:air",  "minecraft:bedrock", "minecraft:cobblestone", "minecraft:dirt", "minecraft:ice", "minecraft:ladder", "minecraft:netherrack", "minecraft:tuff", "minecraft:sand", "minecraft:sandstone",
  "minecraft:snow", "minecraft:snow_layer", "minecraft:stone", "minecraft:gravel", "minecraft:grass", "minecraft:torch", "minecraft:diorite", "minecraft:andesite", "minecraft:granite", "byg:soapstone", "minecraft:cobbled_deepslate" 
  ```


6. Run quarry

6a. This will skip everything on the blacklist and only brings ores back to the chest.
```quarry -chest left -oreQuarry true -blacklist no-mine-me.lua -doRefuel true```
6b. This will mine everything, makes a big hole!
```quarry -chest left -doRefuel true```

Note: add -startDown X to the end of 6a if the turtle messes up and needs to start a few levels down. I have found this work better than the -restore argument. Example to -startDown 50 blocks from the start. 
```quarry -chest left -oreQuarry true -blacklist no-mine-me.lua -doRefuel true -startDown 50```