Deposit a crystal into what this world knows

- one-way crossing: a crystal fills a body's set, never the reverse
- skip an address with no world and report landed of total
- no new packet: the deposit syncs the way a beacon always has

Author: StannisMod

src/main/java/zmaster587/advancedRocketry/tile/multiblock/TileObservatory.java

@@ -30,6 +30,7 @@
 import zmaster587.advancedRocketry.item.IDataItem;
 import zmaster587.advancedRocketry.item.ItemAsteroidChip;
 import zmaster587.advancedRocketry.item.ItemMemoryCrystal;
+import zmaster587.advancedRocketry.navigation.CrystalEntry;
 import zmaster587.advancedRocketry.space.GalacticCoord;
 import zmaster587.advancedRocketry.tile.hatch.TileDataBus;
 import zmaster587.advancedRocketry.universe.RegionScan;
@@ -117,6 +118,7 @@ public class TileObservatory extends TileMultiPowerConsumer implements IModularI
     private static final byte ABORT_SCAN = 20;
     private static final byte PASSIVE_SWEEP = 21;
     private static final byte TOGGLE_WHOLE_SYSTEM = 22;
+    private static final byte UPLOAD_CRYSTAL = 23;
     /** Progress id of the region-scan bar; the machine's own bar keeps id 0. */
     private static final int PROGRESS_SCAN = 1;
     /**
@@ -748,6 +750,12 @@ public List<ModuleBase> getModules(int ID, EntityPlayer player) {
                         zmaster587.libVulpes.inventory.TextureResources.buttonBuild,
                         LibVulpes.proxy.getLocalizedString("msg.observetory.scan.abort.tooltip"), 40, 18));
             }
+            // Reading a crystal INTO this world, the reverse of the survey that fills one. It costs
+            // no power and no data: the knowledge already exists, it is being put down here.
+            modules.add(new ModuleButton(100, 142, 10,
+                    LibVulpes.proxy.getLocalizedString("msg.observetory.upload.button"), this,
+                    zmaster587.libVulpes.inventory.TextureResources.buttonBuild,
+                    LibVulpes.proxy.getLocalizedString("msg.observetory.upload.tooltip"), 64, 18));
             modules.add(new ModuleButton(166, 42, 8,
                     LibVulpes.proxy.getLocalizedString(passive
                             ? "msg.observetory.scan.mode.passive" : "msg.observetory.scan.mode.active"),
@@ -1186,6 +1194,41 @@ public void onInventoryButtonPressed(int buttonId) {
         if (buttonId == 9) {
             PacketHandler.sendToServer(new PacketMachine(this, TOGGLE_WHOLE_SYSTEM));
         }
+        if (buttonId == 10) {
+            PacketHandler.sendToServer(new PacketMachine(this, UPLOAD_CRYSTAL));
+        }
+    }
+
+    /**
+     * Read the crystal in the machine into the KNOWLEDGE OF THIS BODY: what somebody carried here
+     * becomes what a launch pad standing here may be aimed at.
+     *
+     * <p>This is the one sanctioned crossing between the two discovery systems, and it goes one way.
+     * A crystal deposits into a body's set; a body's set never feeds a crystal, a console, or a jump
+     * target.</p>
+     *
+     * <p><b>An address without a world is skipped, and the count says so.</b> A procedural body
+     * carries no dimension until somebody descends to it, so a survey of unvisited space writes
+     * addresses that tier-1 has nothing to fly to yet - and an upload that silently did nothing
+     * would be indistinguishable from a broken button. Re-surveying such a system after somebody has
+     * landed there records the world it now has.</p>
+     *
+     * @return {@code {landed, total}}
+     */
+    private int[] uploadCrystalHere() {
+        ItemStack crystal = getStackInSlot(SLOT_CRYSTAL);
+        if (!ItemMemoryCrystal.isCrystal(crystal)) {
+            return new int[] {0, 0};
+        }
+        List<CrystalEntry> entries = ItemMemoryCrystal.memoryOf(crystal).list();
+        Set<Integer> landed = new HashSet<>();
+        for (CrystalEntry entry : entries) {
+            if (entry.namesBody()) {
+                landed.add(entry.dimId());
+            }
+        }
+        teachThisBody(landed);
+        return new int[] {landed.size(), entries.size()};
     }
 
 
@@ -1259,6 +1302,11 @@ else if (id == TOGGLE_WHOLE_SYSTEM) {
                 player.openGui(LibVulpes.instance, GuiHandler.guiId.MODULARNOINV.ordinal(),
                         getWorld(), pos.getX(), pos.getY(), pos.getZ());
             }
+            else if (id == UPLOAD_CRYSTAL) {
+                int[] result = uploadCrystalHere();
+                player.sendMessage(new net.minecraft.util.text.TextComponentTranslation(
+                        "msg.observetory.upload.result", result[0], result[1]));
+            }
             else if (id == START_SCAN || id == ABORT_SCAN || id == PASSIVE_SWEEP) {
                 if (id == ABORT_SCAN) {
                     abortRegionScan();

src/main/resources/assets/advancedrocketry/lang/en_US.lang

@@ -430,6 +430,9 @@ msg.observetory.scan.obscured=Dust in the way - coordinates only:
 msg.observetory.scan.idle=Idle
 msg.observetory.scan.abort=Stop
 msg.observetory.scan.abort.tooltip=Stop the survey. Everything already resolved is already on the crystal.
+msg.observetory.upload.button=Deposit
+msg.observetory.upload.tooltip=Read the crystal into what is known ON THIS WORLD, so a launch pad here can be aimed at it. An address of a world nobody has landed on yet has nothing to fly to and is skipped.
+msg.observetory.upload.result=Deposited %s of %s addresses into local knowledge.
 msg.observetory.scan.mode.active=Deep
 msg.observetory.scan.mode.passive=Local
 msg.observetory.scan.mode.tooltip=Local watches the neighbourhood and has its data ready; deep looks at a chosen distant region. One at a time - an instrument staring into deep space cannot see what is close.

src/main/resources/assets/advancedrocketry/lang/ru_RU.lang

@@ -263,6 +263,9 @@ msg.observetory.scan.obscured=Мешает пыль — только коорд
 msg.observetory.scan.idle=Простаивает
 msg.observetory.scan.abort=Стоп
 msg.observetory.scan.abort.tooltip=Прервать обзор. Всё, что уже разрешено, уже лежит в кристалле.
+msg.observetory.upload.button=Выгрузить
+msg.observetory.upload.tooltip=Прочитать кристалл в то, что известно НА ЭТОМ МИРЕ, чтобы отсюда мог целиться пусковой стол. Адрес мира, на который ещё никто не садился, лететь некуда — он пропускается.
+msg.observetory.upload.result=В местное знание внесено адресов: %s из %s.
 msg.observetory.scan.mode.active=Даль
 msg.observetory.scan.mode.passive=Округа
 msg.observetory.scan.mode.tooltip=Округа наблюдает соседние ячейки и держит данные наготове; даль смотрит на выбранную далёкую область. Одно за раз — инструмент, вглядывающийся в глубокий космос, не видит того, что рядом.