Add Function of Clearing Anchors and Saving Structure

Ivans-11 · Ivans-11 · commit 6b4378b8ab98 · 2025-08-25T19:52:05.000+08:00
diff --git a/README.md b/README.md
@@ -33,6 +33,7 @@ Of course, this mod can also be used independently. As long as you can generate
 
    * Keys are block IDs, and values are arrays of relative coordinates.
    * You can use [**Minecraftify2.0**](https://github.com/Ivans-11/Minecraftify2/releases) to generate JSON files from 3D models. See its [repository documentation](https://github.com/Ivans-11/Minecraftify2) for details.
+   * You can also use the `/builder save` command to export JSON files from the current world. See the following content for specific usage.
 
 2. Place a `builder:anchor_block` in the game world to define the reference origin and orientation.
 
@@ -55,6 +56,14 @@ Of course, this mod can also be used independently. As long as you can generate
    ```
 
    This will revert the most recent build (up to 3 steps).
+5. If you need to export a build from the current world, enter:
+
+   ```
+   /builder save <x> <y> <z> <name>
+   ```
+   Where `<x> <y> <z>` represents the selected area range.
+   The mod will use the nearest anchor block to the player as the starting point `(0,0,0)` and export the block data in the range from `(0,0,0)` to `(x,y,z)` to the `config/mybuilds/<name>.json` file.
+   Note that the x-axis corresponds to the red axis, the y-axis corresponds to the green axis, and the z-axis corresponds to the blue axis. The format of the exported JSON file is the same as that of the imported one.
 
 ## Command List
 
@@ -66,6 +75,12 @@ Of course, this mod can also be used independently. As long as you can generate
   List the coordinates of all anchor blocks
 * `/builder undo`
   Undo the most recent build operation
+* `/builder clear`
+  Clear all anchor blocks
+* `/builder save <x> <y> <z> <name>`
+  Export the block data within the specified area to the `config/mybuilds/<name>.json` file.
+* `/builder help`
+  Show help information
 
 ## Notes
 
@@ -77,6 +92,8 @@ Of course, this mod can also be used independently. As long as you can generate
 
 * Undo only applies to blocks placed using the `/builder place` command, and does not affect manually placed blocks.
 
+* Since JSON files only record the relative coordinates of blocks, it is not possible to import some special blocks (such as stairs, doors, etc., which contain more information) accurately.
+
 ## Acknowledgements
 
 This project is based on [FabricMC/fabric-example-mod](https://github.com/FabricMC/fabric-example-mod). 
diff --git a/README_zh.md b/README_zh.md
@@ -30,7 +30,8 @@
     }
    ```
    - 其中，键为方块 ID，值为相对坐标数组。
-   - 可使用工具 [**Minecraftify2.0**](https://github.com/Ivans-11/Minecraftify2/releases) 从三维模型文件生成，具体使用方法见其[仓库说明](https://github.com/Ivans-11/Minecraftify2)
+   - 可使用工具 [**Minecraftify2.0**](https://github.com/Ivans-11/Minecraftify2/releases) 从三维模型文件生成，具体使用方法见其[仓库说明](https://github.com/Ivans-11/Minecraftify2)。
+   - 也可利用 `/builder save` 命令从当前世界导出 JSON 文件，具体使用方法见后文。
 2. 在游戏中放置一个 `builder:anchor_block`（锚点方块） ，用于确定参考坐标系原点和朝向。
 
     ![](image/anchor.png)
@@ -50,6 +51,14 @@
    ```
 
    将撤回最近一次生成操作（最多支持 3 步）。
+5. 如果需要导出当前世界的建筑，输入：
+
+   ```
+   /builder save <x> <y> <z> <name>
+   ```
+   其中，`<x> <y> <z>` 为选择的区域范围
+   模组将以距离玩家最近的锚点为起始点 `(0,0,0)` ，导出 `(0,0,0)` 到 `(x,y,z)` 范围内的方块数据到 `config/mybuilds/<name>.json` 文件中。
+   注意，x 为红轴方向，y 为绿轴方向，z 为蓝轴方向。导出的 JSON 文件格式与导入的格式相同。
 
 ## 命令列表
 
@@ -61,14 +70,21 @@
   列出所有锚点方块的坐标
 - `/builder undo`
   撤回最近一次生成操作
+- `/builder clear`
+  清除所有锚点方块
+- `/builder save <x> <y> <z> <name>`
+  导出指定区域内的方块数据到 `config/mybuilds/<name>.json` 文件中
+- `/builder help`
+  显示帮助信息
 
 ## 注意
 
 - 必须先放置锚点方块才能生成建筑，生成建筑时会自动寻找距离玩家最近的锚点方块。
 - 锚点方块可在建筑方块物品栏中找到。
 
     ![](image/item_zh.png)
-- 撤回仅能恢复由 `/build place` 命令生成的方块，不影响手动放置的方块。
+- 撤回仅能恢复由 `/builder place` 命令生成的方块，不影响手动放置的方块。
+- 由于 JSON 文件只记录了方块的相对坐标，因此对于一些特殊的方块（如楼梯、门等包含更多信息的方块），无法做到精确导入。
 
 ## 致谢
 
diff --git a/gradle.properties b/gradle.properties
@@ -10,7 +10,7 @@ loader_version=0.16.14
 loom_version=1.11-SNAPSHOT
 
 # Mod Properties
-mod_version=1.0.0
+mod_version=1.0.1
 maven_group=com.example
 archives_base_name=builder
 
diff --git a/src/main/java/com/example/BuildHandler.java b/src/main/java/com/example/BuildHandler.java
@@ -1,5 +1,6 @@
 package com.example;
 
+import com.example.block.AnchorBlock;
 import com.example.block.AnchorState;
 import com.google.gson.*;
 import net.minecraft.block.Block;
@@ -16,6 +17,7 @@
 import net.minecraft.text.Text;
 
 import java.io.FileReader;
+import java.io.FileWriter;
 import java.io.File;
 import java.nio.file.Path;
 import java.nio.file.Paths;
@@ -52,13 +54,31 @@ public static void listBuilds(ServerCommandSource source) {
     public static void listAnchors(ServerCommandSource source) {
         ServerPlayerEntity player = source.getPlayer();
         ServerWorld world = source.getWorld();
-        AnchorState cache = AnchorState.getState(world.getServer());// Get cache
-        List<BlockPos> anchors = cache.getAnchors();// Get anchors
+        List<BlockPos> anchors = getAnchors(world);// Get anchors
+        if (anchors.isEmpty()) {
+            player.sendMessage(Text.literal("No Anchors Found"), false);
+            return;
+        }
+        player.sendMessage(Text.literal("Anchors:"), false);
         for (BlockPos p : anchors) {
             player.sendMessage(Text.literal(p.toString()), false);
         }
     }
 
+    // Clear all AnchorBlocks
+    public static void clearAnchors(ServerCommandSource source) {
+        ServerPlayerEntity player = source.getPlayer();
+        ServerWorld world = source.getWorld();
+        List<BlockPos> anchors = getAnchors(world);// Get anchors
+        for (BlockPos p : anchors) {
+            BlockState state = world.getBlockState(p);
+            if (state.getBlock() instanceof AnchorBlock) {
+                world.setBlockState(p, Blocks.AIR.getDefaultState());// Set to air
+            }
+        }
+        player.sendMessage(Text.literal("All Anchors Cleared"), false);
+    }
+
     // Load and place a build from a JSON file
     public static void loadAndPlace(ServerCommandSource source, String filename) {
         ServerWorld world = source.getWorld();
@@ -73,7 +93,7 @@ public static void loadAndPlace(ServerCommandSource source, String filename) {
         }
 
         BlockState anchorState = world.getBlockState(anchorPos);
-        if (!(anchorState.getBlock() instanceof com.example.block.AnchorBlock)) {
+        if (!(anchorState.getBlock() instanceof AnchorBlock)) {
             // Not found anchor
             player.sendMessage(Text.literal("Invalid Anchor, Please Place Anchor First"), false);
             return;
@@ -94,6 +114,28 @@ public static void loadAndPlace(ServerCommandSource source, String filename) {
                 if (block == Blocks.AIR) continue;
 
                 JsonArray coords = entry.getValue().getAsJsonArray();
+
+                // If it is an anchor block, record the position
+                if (block instanceof AnchorBlock) {
+                    player.sendMessage(Text.literal("Anchor Block Found: " + origin), false);
+                    for (JsonElement coordEl : coords) {
+                        JsonArray arr = coordEl.getAsJsonArray();
+                        int dx = arr.get(0).getAsInt();
+                        int dy = arr.get(1).getAsInt();
+                        int dz = arr.get(2).getAsInt();
+
+                        BlockPos placePos = transformPos(origin, dx, dy, dz, facing);
+
+                        BlockState oldState = world.getBlockState(placePos);
+                        snapshots.add(new UndoManager.BlockSnapshot(placePos, oldState));
+                        world.setBlockState(placePos, block.getDefaultState());
+                        player.sendMessage(Text.literal("Anchor Block Placed: " + placePos), false);
+                        cache.add(placePos);
+                        player.sendMessage(Text.literal("Anchor Block Added: " + placePos), false);
+                    }
+                    continue;
+                }
+
                 for (JsonElement coordEl : coords) {
                     JsonArray arr = coordEl.getAsJsonArray();
                     int dx = arr.get(0).getAsInt();
@@ -118,6 +160,68 @@ public static void loadAndPlace(ServerCommandSource source, String filename) {
         }
     }
 
+    // Save structure to a JSON file
+    public static void saveStructure(ServerCommandSource source, int x, int y, int z, String name) {
+        ServerWorld world = source.getWorld();
+        ServerPlayerEntity player = source.getPlayer();
+        BlockPos playerPos = player.getBlockPos();
+
+        AnchorState cache = AnchorState.getState(world.getServer());// Get cache
+        BlockPos anchorPos = findNearest(cache.getAnchors(), playerPos);// Find nearest anchor
+        if (anchorPos == null) {
+            player.sendMessage(Text.literal("Not Found Anchor, Please Place Anchor First"), false);
+            return;
+        }
+
+        BlockState anchorState = world.getBlockState(anchorPos);
+        if (!(anchorState.getBlock() instanceof AnchorBlock)) {
+            // Not found anchor
+            player.sendMessage(Text.literal("Invalid Anchor, Please Place Anchor First"), false);
+            return;
+        }
+
+        Direction facing = anchorState.get(Properties.HORIZONTAL_FACING);
+        BlockPos origin = anchorPos;
+
+        // Record the structure
+        JsonObject obj = new JsonObject();
+        for (int dx = 0; dx <= x; dx++) {
+            for (int dy = 0; dy <= y; dy++) {
+                for (int dz = 0; dz <= z; dz++) {
+                    if (dx == 0 && dy == 0 && dz == 0) continue;
+                    BlockPos placePos = transformPos(origin, dx, dy, dz, facing);
+                    BlockState state = world.getBlockState(placePos);
+                    Block block = state.getBlock();
+                    if (block != Blocks.AIR) {
+                        String blockId = Registries.BLOCK.getId(block).toString();
+                        JsonArray arr = new JsonArray();
+                        arr.add(dx);
+                        arr.add(dy);
+                        arr.add(dz);
+                        if (obj.has(blockId)) {
+                            obj.get(blockId).getAsJsonArray().add(arr);
+                        } else {
+                            JsonArray coords = new JsonArray();
+                            coords.add(arr);
+                            obj.add(blockId, coords);
+                        }
+                    }
+                }
+            }
+        }
+
+        // Save to file
+        Path filePath = Paths.get(PARENT_PATH, name + ".json");
+        try (FileWriter writer = new FileWriter(filePath.toFile())) {
+            writer.write(obj.toString());
+            player.sendMessage(Text.literal("Save Success: " + name), false);
+        } catch (Exception e) {
+            player.sendMessage(Text.literal("Save Failed: " + e.getMessage()), false);
+            e.printStackTrace();
+        }
+    }
+
+
     // Transform position based on facing
     private static BlockPos transformPos(BlockPos origin, int dx, int dy, int dz, Direction facing) {
         switch (facing) {
@@ -142,4 +246,10 @@ private static BlockPos findNearest(List<BlockPos> anchors, BlockPos playerPos)
         }
         return bestPos;
     }
+
+    private static List<BlockPos> getAnchors(ServerWorld world) {
+        AnchorState cache = AnchorState.getState(world.getServer());// Get cache
+        // Get copy of anchors to avoid ConcurrentModificationException
+        return new ArrayList<>(cache.getAnchors());
+    }
 }
diff --git a/src/main/java/com/example/BuilderMod.java b/src/main/java/com/example/BuilderMod.java
@@ -2,6 +2,8 @@
 
 import net.fabricmc.api.ModInitializer;
 import net.fabricmc.fabric.api.command.v2.CommandRegistrationCallback;
+
+import com.mojang.brigadier.arguments.IntegerArgumentType;
 import com.mojang.brigadier.arguments.StringArgumentType;
 import net.minecraft.server.command.CommandManager;
 import net.minecraft.text.Text;
@@ -43,24 +45,51 @@ public void onInitialize() {
                             })
                     )
                     .then(literal("anchors")// List anchor positions
-                           .executes(context -> {
+                            .executes(context -> {
                                 BuildHandler.listAnchors(context.getSource());
                                 return 1;
                             })
                     )
                     .then(literal("undo")// Undo the last build action
-                          .executes(context -> {
+                            .executes(context -> {
                                 UndoManager.undo(context.getSource().getPlayer(), context.getSource().getWorld());
                                 return 1;
                             })
                     )
+                    .then(literal("clear")// Clear all anchors
+                            .executes(context -> {
+                                BuildHandler.clearAnchors(context.getSource());
+                                return 1;
+                            })
+                    )
+                    .then(CommandManager.literal("save")// Save structure to file
+                        .then(CommandManager.argument("x", IntegerArgumentType.integer())
+                            .then(CommandManager.argument("y", IntegerArgumentType.integer())
+                                .then(CommandManager.argument("z", IntegerArgumentType.integer())
+                                    .then(CommandManager.argument("name", StringArgumentType.string())
+                                        .executes(context -> {
+                                            int x = IntegerArgumentType.getInteger(context, "x");
+                                            int y = IntegerArgumentType.getInteger(context, "y");
+                                            int z = IntegerArgumentType.getInteger(context, "z");
+                                            String name = StringArgumentType.getString(context, "name");
+
+                                            BuildHandler.saveStructure(context.getSource(), x, y, z, name);
+                                            return 1;
+                                        })
+                                    )
+                                )
+                            )
+                        )
+                    )
                     .then(literal("help")// Display help message
-                          .executes(context -> {
+                            .executes(context -> {
                                 context.getSource().sendFeedback(() -> Text.literal("Builder Mod Commands:"), false);
-                                context.getSource().sendFeedback(() -> Text.literal("/builder place <filename> - Place blocks based on the specified file."), false);
+                                context.getSource().sendFeedback(() -> Text.literal("/builder place <filename> - Place blocks based on the specified JSON file."), false);
                                 context.getSource().sendFeedback(() -> Text.literal("/builder list - List available build files."), false);
                                 context.getSource().sendFeedback(() -> Text.literal("/builder anchors - List anchor positions."), false);
                                 context.getSource().sendFeedback(() -> Text.literal("/builder undo - Undo the last build action."), false);
+                                context.getSource().sendFeedback(() -> Text.literal("/builder clear - Clear all anchors."), false);
+                                context.getSource().sendFeedback(() -> Text.literal("/builder save <x> <y> <z> <name> - Save the structure within the specified area to JSON file."), false);
                                 return 1;
                             })
                     )
diff --git a/src/main/java/com/example/UndoManager.java b/src/main/java/com/example/UndoManager.java
@@ -7,6 +7,9 @@
 import java.util.Map;
 import java.util.UUID;
 
+import com.example.block.AnchorBlock;
+import com.example.block.AnchorState;
+
 import net.minecraft.block.BlockState;
 //import net.minecraft.block.entity.BlockEntity;
 //import net.minecraft.nbt.NbtCompound;
@@ -47,6 +50,10 @@ public static void undo(ServerPlayerEntity player, ServerWorld world) {
                     //be.readNbt(snap.nbt);
                 //}
             //}
+            // If it is an anchor block, record the position
+            if (snap.state.getBlock() instanceof AnchorBlock) {
+                AnchorState.getState(world.getServer()).add(snap.pos);
+            }
         }
 
         player.sendMessage(Text.literal("Undo Success"), false);
diff --git a/src/main/resources/fabric.mod.json b/src/main/resources/fabric.mod.json
@@ -8,11 +8,11 @@
 		"Ivans"
 	],
 	"contact": {
-		"homepage": "https://github.com/Ivans-11/Builder",
+		"homepage": "https://www.curseforge.com/minecraft/mc-mods/builder-from-json",
 		"sources": "https://github.com/Ivans-11/Builder",
 		"issues": "https://github.com/Ivans-11/Builder/issues"
 	},
-	"license": "CC0-1.0",
+	"license": "MIT",
 	"icon": "assets/builder/icon.png",
 	"environment": "*",
 	"entrypoints": {
