Merge pull request #23 from box3lab/dev_coolfish

feat(box3import): 添加Y轴偏移参数支持

Author: ifishcool

README.md

@@ -33,9 +33,11 @@
     列出 `config/box3/` 目录下所有可导入的地形文件（`.gz`）。
   - `/box3import <fileName>`  
     从 `config/box3/<fileName>.gz` 导入建筑（命令中不需要带后缀，会自动补 `.gz`）。
-  - `/box3import <fileName> <ignoreBarrier>`  
+  - `/box3import <fileName> <offsetY>`  
+    在当前位置基础上在 Y 轴方向额外偏移 `offsetY` 格（正数向上，负数向下）。
+  - `/box3import <fileName> <offsetY> <ignoreBarrier>`  
     当 `ignoreBarrier = true` 时，跳过屏障方块（不会在世界中放置这些方块）。
-  - `/box3import <fileName> <ignoreBarrier> <ignoreWater>`  
+  - `/box3import <fileName> <offsetY> <ignoreBarrier> <ignoreWater>`  
     当 `ignoreWater = true` 时，所有流体统一替换为空气。
 
 ### 🧩 导入神奇代码岛的模型物品

README_en.md

@@ -35,9 +35,11 @@ You can also migrate structures from Box3 directly into your Minecraft world, pr
   - `/box3import <fileName>`  
     Import a structure from `config/box3/<fileName>.gz`.  
     (You don’t need to type the `.gz` extension in the command.)
-  - `/box3import <fileName> <ignoreBarrier>`  
+  - `/box3import <fileName> <offsetY>`  
+    Apply an additional vertical offset of `offsetY` blocks relative to your current position (positive = up, negative = down).
+  - `/box3import <fileName> <offsetY> <ignoreBarrier>`  
     When `ignoreBarrier = true`, barrier blocks will be skipped (they will not be placed in the world).
-  - `/box3import <fileName> <ignoreBarrier> <ignoreWater>`  
+  - `/box3import <fileName> <offsetY> <ignoreBarrier> <ignoreWater>`  
     When `ignoreWater = true`, all fluids are uniformly replaced with air.
 
 ### 🧩 Importing Box3 Model Items