feat: the telescope sweeps a region and names the bodies in it

- a survey walks its region cell by cell and resumes after unload
- a cell resolves into bodies, which is what the console can read
- stopping and re-aiming are free; passive watches the home cell
- survey time arrives with research; 22 tests in three tiers

Author: StannisMod

src/main/java/zmaster587/advancedRocketry/api/ARConfiguration.java

@@ -297,6 +297,10 @@ public class ARConfiguration {
     @ConfigProperty
     public int telescopeScanTicksPerSector;
     @ConfigProperty
+    public int telescopeScanCellsPerStep;
+    @ConfigProperty
+    public int telescopePassiveRadiusSectors;
+    @ConfigProperty
     public boolean allowNonArBiomesInTerraforming;
     @ConfigProperty
     public double oxygenVentPowerMultiplier;
@@ -525,10 +529,12 @@ public static void loadPreInit() {
         arConfig.planetsMustBeDiscovered = config.get(PLANET, "planetsMustBeDiscovered", false, "Planets must be discovered in the warp controller before being visible").getBoolean();
         arConfig.planetDiscoveryChance = config.get(PLANET, "planetDiscoveryChance", 5, "Chance of planet discovery in the warp controller, chance is 1/n", 1, Integer.MAX_VALUE).getInt();
         arConfig.telescopeScanRangeSectors = config.get(PLANET, "telescopeScanRangeSectors", 24, "How far, in galactic sectors, an observatory's region scan can be aimed. This is the instrument's horizon: beyond it the sky is not resolvable, which is what keeps an endless universe from being read off a telescope. A scan aimed farther is clamped to this.", 1, Integer.MAX_VALUE).getInt();
-        arConfig.telescopeScanHalfWidthSectors = config.get(PLANET, "telescopeScanHalfWidthSectors", 1, "Half-width, in sectors, of the box one region scan covers. 0 means a single sector, 1 a 3x3x3 neighbourhood, and so on. Narrowed automatically when the resulting box would exceed telescopeScanMaxSectors.", 0, Integer.MAX_VALUE).getInt();
-        arConfig.telescopeScanMaxSectors = config.get(PLANET, "telescopeScanMaxSectors", 64, "Hard ceiling on how many sectors one region scan may enumerate. The width above is narrowed until the box fits under this.", 1, Integer.MAX_VALUE).getInt();
-        arConfig.telescopeScanBaseTicks = config.get(PLANET, "telescopeScanBaseTicks", 200, "Ticks a region scan takes before distance is counted - the cost of pointing the instrument at all.", 0, Integer.MAX_VALUE).getInt();
-        arConfig.telescopeScanTicksPerSector = config.get(PLANET, "telescopeScanTicksPerSector", 100, "Extra ticks per sector of distance. This is what makes a far region a longer look than a near one.", 0, Integer.MAX_VALUE).getInt();
+        arConfig.telescopeScanHalfWidthSectors = config.get(PLANET, "telescopeScanHalfWidthSectors", 2, "Half-width, in sectors, of the region one survey sweeps. 0 means a single sector, 1 a 3x3x3 neighbourhood, 2 a 5x5x5, and so on. Narrowed automatically when the resulting region would exceed telescopeScanMaxSectors.", 0, Integer.MAX_VALUE).getInt();
+        arConfig.telescopeScanMaxSectors = config.get(PLANET, "telescopeScanMaxSectors", 1000, "Hard ceiling on how many sectors one survey may cover. The width above is narrowed until the region fits under this. A sweep may be long, but never unbounded.", 1, Integer.MAX_VALUE).getInt();
+        arConfig.telescopeScanBaseTicks = config.get(PLANET, "telescopeScanBaseTicks", 200, "Ticks one STEP of a survey takes before distance is counted - the cost of holding the instrument on a patch of sky at all. Only applies with planetsMustBeDiscovered on; without research, an observation is instant.", 0, Integer.MAX_VALUE).getInt();
+        arConfig.telescopeScanTicksPerSector = config.get(PLANET, "telescopeScanTicksPerSector", 100, "Extra ticks per sector of distance, per step. This is what makes a far region a longer survey than a near one.", 0, Integer.MAX_VALUE).getInt();
+        arConfig.telescopeScanCellsPerStep = config.get(PLANET, "telescopeScanCellsPerStep", 5, "How many cells of the region one step of a survey resolves. This is the bound that stops a sweep from enumerating everything at once.", 1, Integer.MAX_VALUE).getInt();
+        arConfig.telescopePassiveRadiusSectors = config.get(PLANET, "telescopePassiveRadiusSectors", 2, "How far, in sectors, the passive local radar reaches around the observatory's own cell. Passive is the mode that costs nothing and watches the neighbourhood; the directed survey is what looks far away.", 0, Integer.MAX_VALUE).getInt();
         DimensionManager.dimOffset = config.getInt("minDimension", PLANET, 2, -127, 8000, "Lowest dimension ID that can be used for planets.");
         arConfig.canPlayerRespawnInSpace = config.get(PLANET, "allowPlanetRespawn", false, "Allow bed respawn on planets with breathable air.").getBoolean();
         arConfig.forcePlayerRespawnInSpace = config.get(PLANET, "forcePlanetRespawn", false, "Allow bed respawn on planets even without breathable air. Requires 'allowPlanetRespawn=true'.").getBoolean();

src/main/java/zmaster587/advancedRocketry/command/test/TestProbeCommand.java

@@ -2097,11 +2097,19 @@ private void handleTelescope(MinecraftServer server, ICommandSender sender, Stri
             return;
         }
 
+        if ("abort".equalsIgnoreCase(verb)) {
+            boolean stopped = scope.abortRegionScan();
+            send(sender, "{\"ok\":" + stopped + telescopeScanFields(scope, scope.getActiveScan(), world) + "}");
+            return;
+        }
+
+        if ("passive".equalsIgnoreCase(verb)) {
+            boolean started = scope.beginPassiveSweep();
+            send(sender, "{\"ok\":" + started + telescopeScanFields(scope, scope.getActiveScan(), world) + "}");
+            return;
+        }
+
         if ("scan".equalsIgnoreCase(verb) && args.length >= 9) {
-            if (scope.getActiveScan() != null) {
-                send(sender, "{\"ok\":false,\"reason\":\"busy\"}");
-                return;
-            }
             if (scope.scanOrigin() == null) {
                 send(sender, "{\"ok\":false,\"reason\":\"noOrigin\",\"dim\":"
                         + world.provider.getDimension() + "}");
@@ -2142,17 +2150,24 @@ private String telescopeScanFields(zmaster587.advancedRocketry.tile.multiblock.T
                 // a GUI click changes and what the next scan will use. Distinct from the region a
                 // running scan is already looking at, below.
                 .append(",\"aim\":").append(scope.scanDirectionIndex())
-                .append(",\"aimDistance\":").append(scope.getScanDistance());
+                .append(",\"aimDistance\":").append(scope.getScanDistance())
+                .append(",\"passive\":").append(scope.isPassive());
         if (scan != null) {
+            // The cell counts ship beside the region they are counted over, and the next deadline
+            // beside the clock it is measured against: a sweep that will not advance must be able to
+            // say which of the three is stuck.
             out.append(",\"min\":\"").append(scan.min().cellKey())
                     .append("\",\"max\":\"").append(scan.max().cellKey())
-                    .append("\",\"sectors\":").append(scan.sectorCount())
+                    .append("\",\"cells\":").append(scan.totalCells())
+                    .append(",\"cellsDone\":").append(scan.cellsDone())
+                    .append(",\"cellsPerStep\":").append(scan.cellsPerStep())
                     .append(",\"distance\":").append(scan.distanceSectors())
                     .append(",\"start\":").append(scan.startTick())
-                    .append(",\"deadline\":").append(scan.deadlineTick())
-                    .append(",\"duration\":").append(scan.durationTicks())
-                    .append(",\"progress\":").append(scan.progress(now))
-                    .append(",\"complete\":").append(scan.isComplete(now));
+                    .append(",\"stepDeadline\":").append(scan.stepDeadline())
+                    .append(",\"ticksPerStep\":").append(scan.ticksPerStep())
+                    .append(",\"estimatedTicks\":").append(scan.estimatedTicks())
+                    .append(",\"progress\":").append(scan.progress())
+                    .append(",\"stepDue\":").append(scan.stepDue(now));
         }
         return out.toString();
     }
@@ -9063,7 +9078,12 @@ private void handleMachineTickUntil(MinecraftServer server, ICommandSender sende
                     "telescopeScanHalfWidthSectors",
                     "telescopeScanMaxSectors",
                     "telescopeScanBaseTicks",
-                    "telescopeScanTicksPerSector"));
+                    "telescopeScanTicksPerSector",
+                    "telescopeScanCellsPerStep",
+                    "telescopePassiveRadiusSectors",
+                    // The research master switch. A survey is instant without it and paced by the
+                    // time curve with it, so both halves of boundary B need it flippable at runtime.
+                    "planetsMustBeDiscovered"));
 
     private void handleConfig(ICommandSender sender, String[] args) {
         if (args.length == 0) {