User:Ikuu/Mac-Mining

This page has my info on assistant programs for mining on MacOS. These are not macros in the usual sense in ATitD because you still need to move the mouse and enter the command to work the mine. They do however decide for you which crystal you want to select for pulling.

To use these, you need Quartz Composer (QC), which comes with XCode Developer package from Apple and also Automator, which is part of the standard application suite in MacOS.

The helpers all work the same way, except for the logic particular to the mine type. They read a screenshot from a location you need to set, process 7 locations in the screenshot that you specify while running the composition, and display the index numbers appropriate for the memory game. Once you're familiar with the operation of the compositions, you need simply read off the crystal number for your level of memory game, work that crystal and then continue the automator workflow.

To set up the compositions and automator, you need to do the following:

1. Open the appropriate mining helper in QC and open the viewer window.
2. Position your ATitD and QC viewer windows so you can see the right-most column of numbers in the QC viewer while ATitD window is frontmost. This lets you see the number of the appropriate crystal to choose after switching into the game.
3. Start up Automator and give it 4 automation steps:
   1. Take screenshot, type Fullscreen, un-timed, Save To <file of your choice> - this step takes the snapshot of your ATitD window, saving it someplace that the composition will look
   2. Launch Application, Quartz Composer - this simply switches to QC since it's already running
   3. Watch Me Do - here you need to record yourself pressing the spacebar, then clicking someplace safe in your ATitD window (like a chat window - key is that it doesn't move you when the click happens) - then set the playback speed to 10x. The spacebar tells the composition in QC viewer to re-read the screenshot.
   4. Loop, ask to continue - this inserts a wait until you're ready to continue step, giving you time to actually work the mine before the next screenshot)
4. Save your workflow (not as an application, but as a workflow) for future use.
5. Go to the QC editor window:
   1. Find the patch with a blue header titled, "Image Downloader". It will be on the left side of the composition flowchart, about halfway down.
   2. Click on it, then click on the gear in the title bar labelled "Patch Parameters".
   3. You should now see a place to enter the image location - enter the location where your screenshot is saved per the automator workflow you just created.
   4. Save the helper and minimize the editor window.
6. Position yourself in Egypt so that your mining crystals are all on the left side of the screen and as large as possible (not strictly necessary, but it makes the crystal specification step much easier)
7. IMPORTANT: from here on out, use CMD-Tab to swap applications from ATitD to something else. This is because the key command to lock the camera position is currently broken.
8. Swap to Automator and run your workflow - it will take the first snapshot of your mine, swap to QC briefly to load the image file, then swap to ATitD.
9. Swap back to QC viewer and click on the title-bar button for full screen mode - not strictly necessary, but it helps with crystal specification)
10. For each crystal in the screenshot, hold down the number 1-7 that you decide will correspond to that crystal and move your mouse until it's properly positioned for that crystal. You'll see the corresponding sub-image next to the screenshot showing you what's under the mouse, plus the color data for the precise pixel under the mouse.
11. Once you've done all 7 crystals, the bottom number in the right-most column should show the correct crystal to choose, assuming no memory game. If this is not correct, double-check your crystal selection and that you're running the right helper for the mine in question.

Mining Helpers

Media:Copper_Mining_Helper.qtz - choose location on each crystal with maximal saturation

Media:Tin_Mining_Helper.qtz - choose location on each crystal with minimal blue