v1.4.3

本次更新针对 Minecraft 1.21.11 版本的模组进行了优化，以支持将建筑结构导入 Unity（例如神岛材质包 Unity 工具）。

现在你可以使用以下新指令：

• 导出指令：
  • /box3export <文件名>
    自动扫描玩家附近最近的两个 红石块（minecraft:redstone_block），将其作为导出区域的立方体对角点，并将结构导出至 config/box3/<文件名>.gz。
  • 扫描逻辑：按距离由近及远依次搜索标记方块，找到两个有效点后即停止；最大搜索范围为 1024 格。

导出后，你可以将文件重新导入 Minecraft，或导入至其他编辑器。

What's Changed

• Dev coolfish by @ifishcool in #26

Full Changelog: v1.4.2...v1.4.3

v1.4.2

本次更新主要针对神岛模型的放置机制进行了优化调整，具体内容如下：

• 模型方块化：将原本以“模型展示物品”形式放置的模型，改为基于“方块实体”的实现方式。
• 交互式参数调节：现在支持通过手持物品进行实时参数调整——空手可切换调节模式，使用木棍增加参数值，使用烈焰棒减少参数值。
• 模型复制与粘贴：新增参数复制粘贴功能。使用纸可复制当前模型的参数（包括缩放、偏移和旋转设置），使用书则可粘贴已保存的参数配置。

⚠️ 因底层实现方式调整，API 发生了较大变化。经我们测试，在 1.21.6 - 1.21.10 以及 1.20.3 - 1.20.6 版本中放置模型时会出现闪退问题，但其他已有的功能正常。因此，后续版本在 CurseForge 和 Modrinth 平台将默认支持的版本范围调整为 1.21.11、1.20 - 1.20.2、1.21 - 1.21.1。需要说明的是，模组本身兼容的版本范围并未缩减，仍保持不变。

What's Changed

• Dev coolfish by @ifishcool in #24

Full Changelog: v1.4.1...v1.4.2

v1.4.1

本次更新主要包含了一些细节优化和小功能的新增，具体内容如下：

• 超平坦世界预设优化
  在创建新世界时，选择“超平坦”模式后，点击“自定义”并选用我们预设的“神岛平原”，即可生成与神岛完全一致的初始地形。该地形共分为8层：第一层为草方块，第二至第七层为泥土，第八层为石头。

• 神岛建筑导入支持Y轴偏移
  针对神岛本身已有8层土层结构，直接导入建筑可能出现高度不匹配的问题，现新增了Y轴偏移参数。使用时，您只需站在目标地面上，即可生成与地面平行、无落差的建筑。
  命令格式：
  /box3import <fileName> <offsetY>
  该命令将在当前位置的基础上，沿Y轴方向额外偏移指定的格数（正数向上，负数向下）。

• 问题修复
  修复了在生存模式下，弹跳方块导致玩家跌落并扣血的问题。

What's Changed

• Dev coolfish by @ifishcool in #19
• Dev coolfish by @ifishcool in #20
• Dev coolfish by @ifishcool in #21
• Dev coolfish by @ifishcool in #22
• Dev coolfish by @ifishcool in #23

Full Changelog: v1.4.0...v1.4.1

v1.4.0

⚠️ 重要说明

本次更新为不兼容更新，因模组ID（box3mod -> box3）更变且所有的方块 ID 变更并移除了神岛液体，v1.3.1 及更早版本均无法直接兼容本版本。
同时新增了对mc1.21.1-1.21.0和mc1.20.x版本的支持。

🛠️ 方块变更

从本版本起，移除了神岛液体方块，统一替换为 Minecraft 原版水方块。
此外，所有方块 ID 已去除原前缀 voxel_，现在可以通过类似 box3:dark_grass 的方式直接获取方块。

🛠️ 命令变更

原命令格式：

/box3import <fileName> <ignoreBarrier> <useVanillaWater>

当 useVanillaWater = true 时，所有神岛流体统一替换为 Minecraft 原版水方块。

现已变更为：

/box3import <fileName> <ignoreBarrier> <ignoreWater>

当 ignoreWater = false （默认）时，所有神岛流体统一替换为 Minecraft 原版水方块。
当 ignoreWater = true 时，所有神岛流体统一替换为空气。

同时，fileName 参数现支持自动识别当前目录下的地形gz文件，并提供列表提示。

What's Changed

• Dev coolfish by @ifishcool in #16
• Dev coolfish by @ifishcool in #17
• Dev coolfish by @ifishcool in #18

Full Changelog: v1.3.1...v1.4.0

v1.3.1

本次更新修复了一个兼容性问题：此前在使用 Xaero's Minimap 小地图模组时，神岛方块在地图上可能会出现颜色错误或完全看不见的情况，现在已恢复正常。

📦 安装要求

组件	最低版本	推荐版本
Minecraft	≥ 1.21.8	1.21.11
Fabric Loader	≥ 0.18.4	0.18.4
Fabric API	任意版本	0.119.0
Java	≥ 21	Java 21

Full Changelog: 1.3.0...v1.3.1

v1.3.0

本次更新引入了模型资源包支持，现在只需将模型打包为资源包，即可导入并使用。

📦 安装要求

组件	最低版本	推荐版本
Minecraft	≥ 1.21.8	1.21.11
Fabric Loader	≥ 0.18.4	0.18.4
Fabric API	任意版本	0.119.0
Java	≥ 21	Java 21

🛠️ 新功能使用说明

🧩 导入神奇代码岛的模型物品

• 资源包导入：支持从 minecraft/resourcepacks/ 目录直接导入资源包文件。
• 自动注册模型：将模型放入资源包后，将自动注册至创造模式物品栏。
• 专用标签页：新增 Box3:模型 标签页，集中管理所有已导入的模型物品。
• 模型销毁器：新增道具“模型销毁器”，右键点击模型即可将其删除。
• 获取模型资源包：访问 https://box3lab.com/mc-resource-pack 一键转换适用于本模组的资源包文件。

What's Changed

• Dev coolfish by @ifishcool in #13
• Dev coolfish by @ifishcool in #14
• Dev coolfish by @ifishcool in #15

Full Changelog: 1.2.0...1.3.0

v1.2.0

本次更新主要修复了从神奇代码岛地图导入至 Minecraft 时，旋转码、屏障方块及透明方块可能出现的叠加显示问题。

⚠️ 重要说明

由于地图导入方式的优化，v1.1.0 版本与本版本存在兼容性问题。新版本已不再支持使用 JSON 地形文件进行导入，改为采用 GZ 压缩格式文件。

📦 安装要求

组件	最低版本	推荐版本
Minecraft	≥ 1.21.8	1.21.11
Fabric Loader	≥ 0.18.4	0.18.4
Fabric API	任意版本	0.119.0
Java	≥ 21	Java 21

🛠 修复内容

导入建筑修复

• 旋转码：导入建筑时，旋转码会与原地形中的保持一致。

渲染与视觉优化

• 连通玻璃效果：对于在配置中被标记为透明的方块（如各种玻璃及彩色玻璃），相邻的同类方块接触面将自动隐藏，避免出现一格一格的深色分隔线，从而提升大面积玻璃墙的整体观感。
• 屏障方块优化：
  • 屏障方块默认完全不可见但仍保留碰撞体积，适用于隐形边界、防掉落等场景。

⚙️ 新功能使用说明

🔍 屏障可见性切换

通过以下命令可以控制屏障方块的显示状态：

• /box3barrier
  查看当前屏障是否可见。
• /box3barrier <true/false>
  开启或关闭屏障显示（屏障始终保持碰撞体积，仅控制是否渲染）。
• /box3barrier toggle
  在“显示”与“隐藏”之间快速切换。状态将保存至本地配置文件，下次进入世界时会自动沿用。

What's Changed

• Dev coolfish by @ifishcool in #11
• Dev coolfish by @ifishcool in #12

Full Changelog: 1.1.0...1.2.0

v1.1.0

本次更新新增了从神奇代码岛地图导入至 Minecraft 的功能。若您希望保留纯净的方块系统而无需其他功能，请继续使用 V1.0.0 版本。

📦 安装要求

组件	最低版本	推荐版本
Minecraft	>=1.21.8	1.21.11
Fabric Loader	>=0.18.4	0.18.4
Fabric API	任意版本	0.119.0+
Java	>=21	Java 21

新功能使用方式

• JSON 地图导入：支持从 minecraft/config/box3mod/ 目录下的 JSON 文件导入方块地图。
• 建筑迁移：支持将神奇代码岛中的建筑结构迁移至 Minecraft 世界，并保持方块外观一致。
• 获取建筑文件：请访问 https://box3lab.com/build2mc 获取神奇代码岛建筑的 JSON 文件。

指令说明：

• /box3import <fileName>
  从 config/box3mod/<fileName>.json 导入建筑。

• /box3import <fileName> <ignoreBarrier>
  若 ignoreBarrier = true，则跳过透明屏障方块（不会在世界中放置这些方块）。

• /box3import <fileName> <ignoreBarrier> <useVanillaWater>
  若 useVanillaWater = true，所有流体将统一替换为 Minecraft 原版水方块。

What's Changed

• Dev coolfish by @ifishcool in #8
• Dev coolfish by @ifishcool in #9
• Dev coolfish by @ifishcool in #10

Full Changelog: 1.0.0...1.1.0

v1.0.0

🎉 神岛方块模组发布啦！ 本次我们成功将 神奇代码岛的方块 完整移植到了《我的世界》Java版中，共收录 384个 方块，为您带来原汁原味的创造体验！

🛠 安装要求

组件	最低要求
Minecraft	≥1.21.8
Fabric Loader	≥0.18.4
Fabric API	任意兼容版本
Java	≥21

📥 安装指南

🟢 基础安装（推荐）

1. 确保已安装 Java 21 或更高版本
2. 下载并安装 Fabric Loader 0.18.4+
3. 将 Fabric API 放入 mods 文件夹
4. 下载本模组并放入同一 mods 文件夹
5. 启动游戏，开始探索新方块世界！

What's Changed

• Dev coolfish by @ifishcool in #1
• Dev coolfish by @ifishcool in #2
• Dev coolfish by @ifishcool in #3
• Dev coolfish by @ifishcool in #4
• Dev coolfish by @ifishcool in #5
• Dev coolfish by @ifishcool in #6
• Dev coolfish by @ifishcool in #7
• Dev coolfish by @ifishcool in #8

New Contributors

• @ifishcool made their first contribution in #1

Full Changelog: https://github.com/box3lab/Box3Blocks-MCMod/commits/1.0.0