Import live AfterBlock packets in Paper plugin

.gitignore

@@ -4,3 +4,4 @@ __pycache__/
 .venv/
 dist/
 build/
+paper-plugin/target/

CODEX_BUILD_LOG.md

@@ -27,3 +27,6 @@ This file records how Codex was used to build the hackathon entry.
 - Added per-tile Minecraft origins/bounds and documented the Paper bridge path for placing Living Canvas tiles and representing motion through particles, map updates, or block-frame updates.
 - Reframed the project as DreamWall: AfterBlock Museum with `dreamwall.museum.v1`, deterministic hall placement, curation scores, artifact spirits, passport cards, seeded relic demos, museum-terminal UI, and a GitHub Actions Paper plugin build workflow.
 - Expanded AfterBlock assets into a resource-pack pipeline: 1,200 generated item textures, 1,200 3D model JSONs, custom model data overrides, contact-sheet screenshots, a browser gallery, and a `/dreamwall demo` Paper command for an in-game pedestal proof.
+- Added `/dreamwall import` and `/dreamwall import here` to the Paper bridge. The plugin now calls the live Gradio `curate_artifact` endpoint, parses `dreamwall.museum.v1`, and places a packet-derived pedestal/sign/item in Minecraft.
+- Added Gson shading plus explicit Maven Central resolution so the Paper jar compiles into a self-contained PebbleHost-friendly plugin.
+- Verified the shaded jar locally with temporary Maven 3.9.9 and prepared an ignored deploy bundle at `dist/pebblehost/` with the plugin jar, `AfterBlockMuseum.zip`, and hashes.

docs/PEBBLEHOST_DEPLOY.md

@@ -0,0 +1,78 @@
+# PebbleHost Deployment Checklist
+
+This is the shortest path to make the AfterBlock Museum demo visible in a live Minecraft server.
+
+## Local Build Artifacts
+
+Build the Paper plugin:
+
+```bash
+/tmp/apache-maven-3.9.9/bin/mvn -q -f paper-plugin/pom.xml package
+```
+
+Prepared local bundle:
+
+```text
+dist/pebblehost/dreamwall-paper-bridge-0.1.0.jar
+dist/pebblehost/AfterBlockMuseum.zip
+dist/pebblehost/SHA256SUMS
+```
+
+Current hashes from the verified local bundle:
+
+```text
+7ace99dec709e01c3f118bb48cde406b9711d6683d74e848707015692a78087c  AfterBlockMuseum.zip
+0bc7e6b3bb2e80b01943cea42bb3efdd7432eac6db39e394b3564dbfc584829e  dreamwall-paper-bridge-0.1.0.jar
+```
+
+## Upload Targets
+
+Upload with SFTP or the PebbleHost file manager:
+
+```text
+plugins/dreamwall-paper-bridge-0.1.0.jar
+AfterBlockMuseum.zip
+```
+
+The known PebbleHost SFTP endpoint from the account screen was:
+
+```text
+sftp://uk144.pebblehost.net:2222
+```
+
+Use the PebbleHost panel username/password. Do not commit credentials.
+
+## Server Resource Pack
+
+In the PebbleHost panel or `server.properties`, set the server resource pack URL to a downloadable URL for:
+
+```text
+AfterBlockMuseum.zip
+```
+
+The pack contains:
+
+```text
+1,200 PNG item textures
+1,200 item model JSON files
+1,200 CustomModelData overrides on minecraft:paper
+```
+
+## In-Game Smoke Test
+
+After restarting the server, run these as an op player:
+
+```text
+/dreamwall
+/dreamwall fetch
+/dreamwall demo
+/dreamwall import here
+```
+
+Expected result:
+
+- `/dreamwall fetch` reports the Hugging Face Space is reachable.
+- `/dreamwall demo` places a small pedestal and gives a Paper item using `CustomModelData 730002`.
+- `/dreamwall import here` calls the live `curate_artifact` endpoint, parses `dreamwall.museum.v1`, places a packet-derived pedestal/sign beside the player, and gives a Paper item using the packet's `custom_model_data`.
+
+If the Paper item looks like ordinary paper, the plugin is working but the resource pack is not loaded.

paper-plugin/README.md

@@ -9,6 +9,8 @@ The hackathon Space is the official submission surface. This plugin scaffold is
 - `/dreamwall` shows the configured Space endpoint.
 - `/dreamwall fetch` calls the Space app domain and confirms the bridge can reach Hugging Face.
 - `/dreamwall demo` places a safe local pedestal/sign proof and gives the player a Paper item with `CustomModelData 730002`.
+- `/dreamwall import` calls the live `curate_artifact` Gradio endpoint, parses the returned `dreamwall.museum.v1` packet, and places a packet-derived pedestal/sign/item at the artifact coordinates.
+- `/dreamwall import here` uses the same live packet but places it two blocks in front of the player for fast video proof.
 - A scheduled task can be extended to poll approved museum artifacts.
 - The Space now emits `dreamwall.museum.v1`, the main AfterBlock packet for the hackathon demo.
 - The Space also emits `living_canvas.mc.v1` for the secondary wall/canvas mode.
@@ -28,7 +30,7 @@ The main Space endpoint is `curate_artifact`, which emits `dreamwall.museum.v1`
 - curation scores
 - resonance links
 
-Expected `/dreamwall fetch` V1 behavior:
+Implemented `/dreamwall import` V1 behavior:
 
 1. Fetch latest artifact packet.
 2. Place pedestal/sign/painting marker at coordinates.
@@ -125,3 +127,4 @@ The jar will be in `target/dreamwall-paper-bridge-0.1.0.jar`.
 5. Edit `plugins/DreamWall/config.yml` if needed.
 6. Run `/dreamwall fetch` in game or console.
 7. Run `/dreamwall demo` in game to place a pedestal proof and receive the AirPods demo item.
+8. Run `/dreamwall import here` in game to place a live Hugging Face artifact packet beside you.

paper-plugin/pom.xml

@@ -15,6 +15,10 @@
   </properties>
 
   <repositories>
+    <repository>
+      <id>central</id>
+      <url>https://repo.maven.apache.org/maven2/</url>
+    </repository>
     <repository>
       <id>papermc</id>
       <url>https://repo.papermc.io/repository/maven-public/</url>
@@ -28,6 +32,11 @@
       <version>1.21.4-R0.1-SNAPSHOT</version>
       <scope>provided</scope>
     </dependency>
+    <dependency>
+      <groupId>com.google.code.gson</groupId>
+      <artifactId>gson</artifactId>
+      <version>2.11.0</version>
+    </dependency>
   </dependencies>
 
   <build>
@@ -37,6 +46,22 @@
         <artifactId>maven-compiler-plugin</artifactId>
         <version>3.13.0</version>
       </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-shade-plugin</artifactId>
+        <version>3.6.0</version>
+        <executions>
+          <execution>
+            <phase>package</phase>
+            <goals>
+              <goal>shade</goal>
+            </goals>
+            <configuration>
+              <createDependencyReducedPom>false</createDependencyReducedPom>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
     </plugins>
   </build>
 </project>

paper-plugin/src/main/java/com/dreamwall/DreamWallPlugin.java

@@ -6,8 +6,14 @@ import java.net.http.HttpClient;
 import java.net.http.HttpRequest;
 import java.net.http.HttpResponse;
 import java.time.Duration;
+import java.util.Locale;
 import java.util.logging.Level;
 
+import com.google.gson.JsonArray;
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonParser;
+
 import org.bukkit.Location;
 import org.bukkit.Material;
 import org.bukkit.Particle;
@@ -16,7 +22,6 @@ import org.bukkit.block.Block;
 import org.bukkit.block.Sign;
 import org.bukkit.command.Command;
 import org.bukkit.command.CommandSender;
-import org.bukkit.entity.ItemFrame;
 import org.bukkit.entity.Player;
 import org.bukkit.inventory.ItemStack;
 import org.bukkit.inventory.meta.ItemMeta;
@@ -58,12 +63,18 @@ public final class DreamWallPlugin extends JavaPlugin {
             placeDemoArtifact(sender);
             return true;
         }
+        if (args.length > 0 && args[0].equalsIgnoreCase("import")) {
+            boolean placeHere = args.length > 1 && args[1].equalsIgnoreCase("here");
+            importArtifact(sender, placeHere);
+            return true;
+        }
 
         sender.sendMessage("DreamWall bridge is configured for: " + spaceUrl());
         sender.sendMessage("Canvas: " + getConfig().getInt("canvas-size", 12) + "x" + getConfig().getInt("canvas-size", 12)
                 + " plots, plot size=" + getConfig().getInt("plot-size", 32));
         sender.sendMessage("Use /dreamwall fetch to test Hugging Face reachability.");
         sender.sendMessage("Use /dreamwall demo in-game to place a safe AfterBlock pedestal proof.");
+        sender.sendMessage("Use /dreamwall import or /dreamwall import here to place a live Space artifact packet.");
         return true;
     }
 
@@ -94,6 +105,92 @@ public final class DreamWallPlugin extends JavaPlugin {
         });
     }
 
+    private void importArtifact(CommandSender sender, boolean placeHere) {
+        if (!(sender instanceof Player player)) {
+            sender.sendMessage("/dreamwall import must be run by an in-game player.");
+            return;
+        }
+        sender.sendMessage("Importing one live AfterBlock artifact from " + spaceUrl() + " ...");
+        getServer().getScheduler().runTaskAsynchronously(this, () -> {
+            try {
+                JsonObject packet = fetchMuseumPacket();
+                getServer().getScheduler().runTask(this, () -> placePacketArtifact(player, packet, placeHere));
+            } catch (IOException | InterruptedException e) {
+                sender.sendMessage("DreamWall import failed: " + e.getMessage());
+                Thread.currentThread().interrupt();
+            } catch (RuntimeException e) {
+                sender.sendMessage("DreamWall import parse failed: " + e.getMessage());
+            }
+        });
+    }
+
+    private JsonObject fetchMuseumPacket() throws IOException, InterruptedException {
+        String payload = "{\"data\":[\"Minecraft\",\"@afterblock\",\"object_photo\",\"a white AirPods case from a first year desk\",\"A small object that carried private worlds through public noise.\",null]}";
+        String callBody = post(spaceUrl() + "/gradio_api/call/curate_artifact", payload);
+        JsonObject call = JsonParser.parseString(callBody).getAsJsonObject();
+        String eventId = call.get("event_id").getAsString();
+        String stream = get(spaceUrl() + "/gradio_api/call/curate_artifact/" + eventId);
+        for (String line : stream.split("\\R")) {
+            if (line.startsWith("data: ")) {
+                JsonArray outputs = JsonParser.parseString(line.substring(6)).getAsJsonArray();
+                JsonObject packet = JsonParser.parseString(outputs.get(5).getAsString()).getAsJsonObject();
+                String type = text(packet, "type", "");
+                if (!"dreamwall.museum.v1".equals(type)) {
+                    throw new IOException("unexpected packet type " + type);
+                }
+                return packet;
+            }
+        }
+        throw new IOException("no data event returned by Gradio");
+    }
+
+    private void placePacketArtifact(Player player, JsonObject packet, boolean placeHere) {
+        JsonObject minecraft = packet.getAsJsonObject("minecraft");
+        JsonObject artifact = packet.getAsJsonObject("artifact");
+        JsonObject coordinates = minecraft.getAsJsonObject("coordinates");
+        World world = player.getWorld();
+        Location base = placeHere
+                ? player.getLocation().getBlock().getLocation().add(0, 0, 2)
+                : new Location(world, number(coordinates, "x", player.getLocation().getBlockX()),
+                        number(coordinates, "y", player.getLocation().getBlockY()),
+                        number(coordinates, "z", player.getLocation().getBlockZ()));
+
+        Material pedestalMaterial = materialFromPacket(minecraft);
+        base.getBlock().setType(pedestalMaterial);
+        base.clone().add(0, 1, 0).getBlock().setType(Material.AMETHYST_BLOCK);
+
+        Block signBlock = base.clone().add(0, 1, -1).getBlock();
+        signBlock.setType(Material.OAK_SIGN);
+        String title = text(minecraft, "title", text(artifact, "title", "AfterBlock Relic"));
+        String owner = text(minecraft, "owner_handle", text(artifact, "owner_handle", "@unknown"));
+        String hall = text(minecraft, "hall", text(artifact, "hall", "Museum"));
+        String plaque = text(minecraft, "plaque_text", text(artifact, "plaque_line", "Preserved in AfterBlock"));
+        if (signBlock.getState() instanceof Sign sign) {
+            sign.setLine(0, trimLine(title));
+            sign.setLine(1, trimLine(owner));
+            sign.setLine(2, trimLine(hall));
+            sign.setLine(3, trimLine(plaque));
+            sign.update();
+        }
+
+        ItemStack item = new ItemStack(Material.PAPER);
+        ItemMeta meta = item.getItemMeta();
+        if (meta != null) {
+            meta.setDisplayName(trimLine(title) + " Passport");
+            int customModelData = integer(minecraft, "custom_model_data", 730001);
+            meta.setCustomModelData(customModelData);
+            item.setItemMeta(meta);
+        }
+        player.getInventory().addItem(item);
+        world.spawnParticle(Particle.ENCHANT, base.clone().add(0.5, 1.4, 0.5), 38, 0.45, 0.65, 0.45, 0.015);
+        player.sendMessage("Imported " + title + " by " + owner + " into " + hall + ".");
+        player.sendMessage("Gave Paper item with CustomModelData " + integer(minecraft, "custom_model_data", 730001) + ".");
+        if (!placeHere) {
+            player.sendMessage("Placed at packet coordinates " + base.getBlockX() + " " + base.getBlockY() + " " + base.getBlockZ()
+                    + ". Use /dreamwall import here for a nearby proof.");
+        }
+    }
+
     private void placeDemoArtifact(CommandSender sender) {
         if (!(sender instanceof Player player)) {
             sender.sendMessage("/dreamwall demo must be run by an in-game player.");
@@ -147,6 +244,58 @@ public final class DreamWallPlugin extends JavaPlugin {
         return response.body();
     }
 
+    private String post(String url, String body) throws IOException, InterruptedException {
+        HttpRequest request = HttpRequest.newBuilder()
+                .uri(URI.create(url))
+                .timeout(Duration.ofSeconds(18))
+                .header("User-Agent", "DreamWall-Paper-Bridge/0.1")
+                .header("Content-Type", "application/json")
+                .POST(HttpRequest.BodyPublishers.ofString(body))
+                .build();
+        HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());
+        if (response.statusCode() < 200 || response.statusCode() >= 300) {
+            throw new IOException("HTTP " + response.statusCode() + " from " + url);
+        }
+        return response.body();
+    }
+
+    private Material materialFromPacket(JsonObject minecraft) {
+        JsonArray materials = minecraft.has("materials") && minecraft.get("materials").isJsonArray()
+                ? minecraft.getAsJsonArray("materials")
+                : new JsonArray();
+        for (JsonElement element : materials) {
+            String name = element.getAsString().toUpperCase(Locale.ROOT).replace("MINECRAFT:", "");
+            Material material = Material.matchMaterial(name);
+            if (material != null && material.isBlock()) {
+                return material;
+            }
+        }
+        return Material.POLISHED_DEEPSLATE;
+    }
+
+    private String text(JsonObject object, String key, String fallback) {
+        if (object == null || !object.has(key) || object.get(key).isJsonNull()) {
+            return fallback;
+        }
+        return object.get(key).getAsString();
+    }
+
+    private int integer(JsonObject object, String key, int fallback) {
+        if (object == null || !object.has(key) || object.get(key).isJsonNull()) {
+            return fallback;
+        }
+        return object.get(key).getAsInt();
+    }
+
+    private int number(JsonObject object, String key, int fallback) {
+        return integer(object, key, fallback);
+    }
+
+    private String trimLine(String value) {
+        String cleaned = value == null ? "" : value.replaceAll("\\s+", " ").trim();
+        return cleaned.length() <= 15 ? cleaned : cleaned.substring(0, 15);
+    }
+
     private String spaceUrl() {
         return getConfig().getString("space-url", "https://build-small-hackathon-dreamwall-mc.hf.space").replaceAll("/+$", "");
     }

paper-plugin/src/main/resources/plugin.yml

@@ -7,7 +7,7 @@ description: Bridge a Paper server to the DreamWall MC Hugging Face Space.
 commands:
   dreamwall:
     description: Show or test the DreamWall Space bridge.
-    usage: /dreamwall [fetch|demo]
+    usage: /dreamwall [fetch|demo|import]
     permission: dreamwall.use
 permissions:
   dreamwall.use: