Multi-Asteroid Path [MAP] miner AIO

*still in BETA testing but could use feedback about menus and bugs*

NOT READY FOR GENERAL USE - just testing still

===================================================== Multi-Asteroid Path [MAP] miner v2.0.21 AIO edition: everything in one programmable block by repairmant87 =====================================================

Point it at your asteroid field and let it work. MAP is a fully automatic mining script, all of it in ONE Programmable Block: it undocks, flies to an asteroid, drills a grid of holes sized to the rock, flies home, docks, unloads, recharges, then moves on to the next asteroid until every job is done. No piloting, no babysitting, no scripting knowledge needed.

----------------------------------------------------- QUICK START ----------------------------------------------------- 1. Build: Remote Control, drills, thrusters on all 6 sides, gyros, a connector and one programmable block. (Cameras + a sensor are optional but STRONGLY recommended!!) 2. Paste this script into the programmable block. 3. Dock at your base once: the dock position AND orientation are learned automatically. 4. Paste asteroid GPS bookmarks into the [PASTE ASTEROID GPS BELOW] box at the end of the PB's Custom Data (one per line). 5. Run the PB with argument: START

Until the ship is ready, the PB's screens and any [MAP] screens show a guided setup wizard that tells you exactly what to do next.

----------------------------------------------------- AIO OR CORE? ----------------------------------------------------- AIO does it all in one block, with nothing else to paste. The Core edition (a separate item) splits the miner over two blocks, with the Miner Companion doing the dock work and the screens, which gives Core room for more: the ORE command, a second survey lap, holes along the asteroid's longest side, a learned back-out speed, a dock check and a stop for the ship if the miner's block dies in flight. The Companion on an AIO ship still unloads it and keeps two miners off the same asteroid. Paste AIO OR Core, never both. Each script shows its edition and version on its screen (this one: v2.0.21-AIO).

----------------------------------------------------- WHY MAP ----------------------------------------------------- * MANY ASTEROIDS, ONE SCRIPT. One dock, one staging point, unlimited jobs. START runs the whole queue, site-to-site hops included.

* PASTE GPS INSTEAD OF FLYING PATHS. A GPS bookmark in Custom Data becomes a job. The miner watches for the asteroid from 2 km out, searches outward from the GPS if it isn't there, and corrects the job's GPS for next time.

* DOCK ONCE, DOCK ANYWHERE. Locking the connector teaches it the dock position, heading and roll. It turns at a standoff sized to your ship, then creeps straight in, so it docks in a 2.5 m tunnel.

* IT MEASURES THE ROCK AND YOUR SHIP. A camera survey sizes the hole grid and depth to the asteroid. Braking comes from live thrust and mass, so a loaded miner brakes earlier. Asteroids in a gravity well are mined too, with thrust kept in reserve for the ship's weight.

* SELF-TUNING SPEED. MaxCruise=MAX learns the server's speed limit, and cruise is capped by what the cameras and sensor can see and the ship can stop within: more cameras, faster flight. Something too close to stop for at top speed is dodged sideways.

* SELF-CALIBRATING DRILLS. The cut rate follows how fast rock really clears and slows when a busy server makes the drills cut late. The drill head's real outline sets the hole spacing, so no ribs of rock are left, and each hole starts just above the ones beside it.

* IT REMEMBERS WHERE THE ORE WAS. Each paying hole is saved as a GPS with its ore types. With EatWholeRock off, later trips drill a small patch around each spot instead of the whole rock.

* IT FIXES YOUR MISTAKES. A reversed gyro is corrected in flight; a jammed hole is retried, then skipped; with a thruster shot off it limps home. A pilot in the seat takes over at once. Every fault shows its reason and how to clear it.

* IT KNOWS WHEN IT'S BEEN HIT. With an Energy Shield (Cython) it tells a collision from weapons fire and flees home when attacked. Two or more damaged blocks send it home for repair.

* BUILT FOR MULTIPLAYER. Scans spread across ticks, no redundant writes, a slow idle rate, the sensor cut to under a metre when not needed. It stops digging before a scheduled restart, parks or docks, and a fleet resumes on staggered timers. A PB limiter warning pauses it where it is. Raycasting FULL / LITE / OFF.

* MOD-AWARE. Tiered drills (SenX, Tiered Tech, Prototech) set the hole spacing; modded fuels, sensor ranges and camera rates are handled.

Also: hauls home when full and resumes at the same hole; mid-job state survives recompiles and reboots; waits docked while the station drains the hold, with hydrogen and batteries on charge (the fullest battery stays on Auto).

----------------------------------------------------- COMMANDS (PB arguments) ----------------------------------------------------- START / START-n run all jobs / one job STOP stop + clear fault HOME return and stay docked PAUSE / RESUME (CONT) NEXT / PREV skip between holes FULL unload now RELOAD reparse Custom Data SCAN rescan blocks CALIBRATE re-arm gyro direction check SAVEDEFAULTS rewrite Custom Data with every setting FASTER / SLOWER nudge DrillSpeed by 0.1 REVFASTER / REVSLOWER Menu: UP DOWN UPLOOP DOWNLOOP APPLY MENU MRES (SenX-compatible; JOBPOS = START)

----------------------------------------------------- SHIP REQUIREMENTS ----------------------------------------------------- Required: Remote Control (forward-facing), drills, thrusters on all