[MD]# 📝 Endstone MXCR 更新日志：v2.7.9 -> v2.9.3
---
## ✨ v2.9.3 主要更新亮点
本次更新是 MXCR 插件的一次**里程碑式飞跃**，从 v2.7.9 纯方块复制工具，全面升级为 v2.9.3 **“方块+容器+实体”三位一体的深度克隆专家**。核心在于引入了强大的 **SAPI 桥接机制**，并对用户交互体验进行了革命性优化。
---
## 🚀 新增功能 (New Features)
### 1. 📦 全面引入 SAPI 桥接机制 (Script API Bridge)
* **核心突破**：新增 `container_manager.py` 和 `entity_manager.py` 模块，通过配套的 SAPI 行为包，实现了对 Minecraft 基岩版中复杂 NBT 数据的读写能力。
* **容器深度同步**：现在可以完美复制箱子、漏斗、熔炉等容器内的所有物品，包括物品的附魔、耐久度、自定义名称、Lore 等所有 NBT 标签。告别空箱子时代！
* **实体属性克隆**：能够完整还原生物的装备、药水效果、颜色（如羊毛颜色）、幼年状态、坐下状态以及其他特定组件属性。让你的生物复制不再是“白板”！
* **SAPI 连接诊断**：新增 `/mxcr bridge` 命令，用于检测 SAPI 桥接行为包是否正确加载并连接，提供详细的排查指引。
* **无需实验性玩法**：SAPI 行为包基于稳定的 Script API 开发，**无需开启任何实验性玩法**即可在生产环境稳定运行，大大降低了使用门槛。
### 2. 🔍 预览模式大幅增强与交互优化
* **预览面板全面升级**：在预览模式下，`/mxcr` 主菜单会动态出现 **[紫色] 预览面板** 按钮，提供更直观的图形化微调界面。
* **建筑变换功能**：预览面板新增了以下强大的变换操作：
* **旋转**：支持建筑以 90° 顺时针或逆时针旋转，并自动适配方块朝向 (如楼梯、活板门等)。
* **镜像翻转**：支持建筑沿 Y 轴进行镜像翻转，同样自动处理方块状态。
* **木棍快速跳转**：在选区模式下，手持 **木棍 (`modify_item_id`)** 点击空气，可让玩家坐标瞬间跳转至已选择的点 A 或点 B，极大提升了选区边界检查的效率。
* **脚下放置基准方块**：新增功能，通过菜单一键在玩家脚下 Y-1 位置放置一个可配置的方块（默认为橡木木板），方便在空中或复杂地形中进行精确的起始点定位。
### 3. ⏪ 撤销/重做系统全面升级
* **全数据快照**：撤销 (`/mxcr undo`) 和重做 (`/mxcr redo`) 操作现在不仅恢复方块，还会**同步恢复当时区域内的容器物品和实体状态**，确保操作的完整性和可靠性。
* **处理模式选择**：在执行撤销/重做时，会提示选择“快速实验”或“传统可靠”模式，以适应不同的服务器性能和网络状况。
### 4. 🛡️ 细粒度普通玩家权限系统
* 新增 `NormalPermissionManager` 模块，允许管理员为**非 OP、非授权玩家**设置更细致的功能权限和数量限制。
* 可配置项包括：是否允许复制、粘贴、删除自己的建筑、查看/加载/公开公共建筑、使用撤销/重做、刷新区块、脚下方块、搬迁模式等。
* 支持设置**最大保存建筑数量**和**单次复制最大方块数**，实现资源配额管理。
---
## ⚡ 优化与改进 (Improvements)
* **代码结构优化**：将容器和实体管理逻辑独立为单独的模块，提高了代码的可维护性和可扩展性。
* **命令列表扩展**：主插件命令列表增加了 `/mxcr bridge` 等新命令。
* **配置项增加**：`config.json` 新增 `foot_block_id` 等配置项，提供更多自定义选项。
* **错误处理增强**：SAPI 通信增加了超时和错误重试机制，提高了数据传输的稳定性。
* **性能优化**：`chunk_loader.py` 中的区块加载和恢复逻辑可能进行了进一步优化，以应对更复杂的数据结构和更大的建筑体积。
---
## 🐛 修复 (Bug Fixes)
* 修复了 v2.7.9 中可能存在的粒子显示不及时或卡顿问题。
* 修复了预览模式下相对位移计算的精度问题，确保位移准确。
* 增强了对玩家离线状态的处理，避免因玩家退出导致的异常。
---
<p align="center">
<b>Made with ❤️ by MXCR Developer</b><br>
<i>为基岩版建筑师而生，将不可能变为可能</i>
</p>[/MD]
