Minecraft 1.21.90 基岩版更新日志
### **Minecraft 1.21.90 基岩版更新日志***Minecraft 1.21.90 Bedrock Changelog*
**在《我的世界：基岩版》中追逐天际！**
*Chase the Skies in Minecraft: Bedrock Edition*
通过"追逐天际"更新体验翱翔主世界的快感！本次更新不仅带来激动人心的飞行坐骑，更为探索、建造开辟了新天地。精心培育恶魂宝宝，成年后即可与好友共乘云端！建造高空奇观，用拴绳组建骆驼商队，发掘全新音乐唱片，用玩家定位条寻找漫游的伙伴。基岩版玩家还可体验《我的世界》史上最大视觉革新——生动画质（Vibrant Visuals）。准备好开启天空冒险了吗？立即游玩！
*Experience the joy of soaring above the Overworld! This update introduces an exciting flying mount system, enabling unprecedented sky exploration and construction. Raise a ghastling to adulthood and ride Happy Ghasts with friends! Includes camel caravans, new music disc, Player Locator bar, and Minecraft's biggest visual refresh.*
---
### **特性与漏洞修复**
*Features and Bug Fixes*
#### **方块**
*Blocks*
**干涸恶魂方块**
*Dried Ghast*
- 在下界化石结构中生成
*Can be found in the Nether in Nether Fossil structures*
- 合成配方：1 个灵魂沙 + 8 个恶魂之泪
*Crafted with 1 Soul Sand Block and 8 Ghast Tears*
- 含水时经历 3 个阶段（约 20 分钟）后孵化恶魂宝宝
*When waterlogged undergoes 3 states over ~20 minutes to spawn Ghastling*
- 不同阶段产生音效和粒子
*Makes sounds/shows particles depending on state*
- 挖掘时立即恢复干燥状态
*Reverts to "dry" state if mined during waterlogging*
- 可通过猪灵交易获取
*Piglins give when bartered with*
- 新增成就 **"保持湿润！"**
*Added achievement "Stay Hydrated!"*
#### **生物**
*Mobs*
**恶魂宝宝**
*Ghastling*
- 快乐恶魂的幼年形态
*Young version of Happy Ghast*
- 由持续含水 20 分钟的干涸恶魂方块孵化
*Spawns from waterlogged Dried Ghast block (20 mins)*
- 跟随 16 格内的玩家/成年非水生被动生物
*Follows players/adult non-aquatic passive mobs within 16 blocks*
- 用雪球引诱和喂养
*Tempted and fed using Snowballs*
- 喂养雪球可加速成长（约 20 分钟成年）
*Grows into Happy Ghast in ~20 mins (faster if fed)*
- 召唤命令：`/summon happy_ghast ~ ~ ~ ~ ~ minecraft:spawn_baby`
*Summon command*
**快乐恶魂**
*Happy Ghast*
- 新型飞行坐骑，最多承载 4 名玩家
*New flying mount (capacity: 4 players)*
- 装备鞍具后可骑行，雪球和鞍具可引诱
*Equipped with harness, tempted by Snowballs/Harness*
- 雨天/雪天或在云层高度飞行时加速回血
*Regen speeds up in rain/snow/at cloud height*
- 控制位在面部前方，乘客位在两侧
*Pilot sits front above face, passengers in side slots*
- 潜行键下马，无人骑乘时在 64 格内游荡
*Crouch dismounts, idles within 64 blocks when empty*
- 装备鞍具时游荡范围缩小至 32 格
*Idles within 32 blocks if harnessed*
#### **物品**
*Items*
**鞍具**
*Harness*
- 合成配方：3 皮革 + 2 玻璃块 + 1 羊毛（颜色继承羊毛）
*Crafted: 3 Leather + 2 Glass + 1 Wool (color matches)*
- 可重新染色，仅装备于快乐恶魂
*Re-dyeable, only for Happy Ghast*
- 无骑乘时可用剪刀卸下
*Shears remove when no players mounted*
**定位条**
*Locator Bar*
- 全新 HUD 元素，显示其他玩家方向
*New UI element showing player directions*
- 120 度视角内显示彩色指示器
*Colored indicators when facing within 120°*
- 目标玩家高于/低于视角 30 度时显示↑/↓箭头
*Up/down arrow if 30° above/below viewport*
- 潜行、戴生物头颅/南瓜、隐身药水可隐藏位置
*Crouching/mob head/invisibility potion hides player*
#### **鞍具更新**
*Saddles Updates*
- **可合成鞍具**：3 皮革 + 1 铁锭
*Craftable: 3 Leather + 1 Iron Ingot*
- **战利品表变更**：部分箱子用 1-5 皮革替代鞍具
*Loot tables replace saddles with 1-5 Leather in:*
- 怪物房间箱子 | *Monster Room chests*
- 远古城市箱子 | *Ancient City chests*
- 沙漠/丛林金字塔箱子 | *Desert/Jungle Pyramid chests*
- 要塞祭坛箱子 | *Stronghold altar chests*
#### **拴绳系统更新**
*Leashing Updates*
- **生物互拴**：任何可拴绳生物可相互连接
*Any leashable entity can leash to any other*
- **剪刀优先**：对拴绳生物用剪刀优先解除拴绳
*Shears take precedence (e.g. unleashes sheep)*
- **物理优化**：按碰撞箱中心计算距离
*Break distance calculated between collision box centers*
- **鞘翅飞行**：使用烟花推进时自动解除拴绳
*Elytra boosting with fireworks unleashes mobs*
#### **拴绳结**
*Leash Knots*
- 可将生物拴至现有绳结
*Entities leashed to pre-existing knots*
- 通过交互回收拴绳生物
*Retrieve entities by interacting*
#### **生物互拴机制**
*Leashing Entities to Other Entities*
- **互拴条件**：
1. 生物已拴在玩家身上
*Entity already leashed to player*
2. 潜行状态下对目标生物交互
*Sneak + interact with target entity*
- **限制**：
- 禁止自拴 | *No self-leashing*
- 幼体不能作为拴绳起点 | *Babies cannot hold lead*
- 拴绳羊驼不组商队 | *Leashed llamas no form caravans*
- **已知问题**：双生物连接时拴绳渲染高度偏移
*Known issue: Y-axis offset when two mobs connected*
### **物理系统**
*Physics*
- 所有可拴绳实体在被牵引时行为更自然
*All leashable entities now behave more naturally when being pulled*
- **快乐恶魂牵引优化**：当马、骆驼、驴、骡子、船、运输船、嗅探兽被快乐恶魂拴绳牵引时，在空中会逐渐调整位置，与牵引者平滑对齐
*When leashed to Happy Ghast: Horses, Camels, etc. gradually align mid-air*
- **通用牵引规则**：实体始终朝向牵引方向，空中不再异常抖动
*In other cases: Entities align to pull direction, no erratic mid-air behavior*
- **船只物理**：船只应用空中摩擦力，不再环绕玩家或过度弹跳
*Mid-air friction now applies to Boats, preventing orbiting/bouncing*
- **拴绳断裂距离**：
- 常规实体：12 格 → **16 格**
- 快乐恶魂：**16 格**
*Leash break distance increased (12→16 blocks, 16 for Happy Ghast)*
- **朝向机制**：被牵引实体会转向牵引者
*Leashed objects now orient toward leasher*
- **距离计算**：以实体碰撞箱中心（非脚部）计算距离
*Distance calculated between collision box centers*
---
### **渲染系统**
*Rendering*
- **多拴绳渲染**：当船或大型生物（马/骆驼/嗅探兽等）被快乐恶魂牵引时，显示 **4 条拴绳**（原为1条）
*Boats/large mobs show four leashes when leashed to Happy Ghast*
- **鞍具特效**：装备鞍具的快乐恶魂新增环绕绳索纹理
*Harnessed Happy Ghast features custom rope layer*
---
### **剪刀功能更新**
*Shearing Updates*
| **功能** | **规则** |
|----------|----------|
| 解除拴绳 | 对拴绳实体使用剪刀可解除所有连接 |
| 移除拴绳结 | 可直接移除拴绳结 |
| 玩家保护 | 不可剪断其他玩家的拴绳 |
| 发射器支持 | 发射器可用剪刀解除拴绳 |
| 移除装备 | 可移除鞍具/马铠/鞍具/地毯（需无骑乘且玩家未潜行） |
| 劫掠兽例外 | 不可移除劫掠兽的鞍具 |
| 发射器限制 | 发射器不可移除生物装备 |
| 音效更新 | 移除装备时播放定制音效 |
---
### **音乐新增**
*Music*
- **5 首新曲目**（Amos Roddy 创作）：
`Below and Above`（天地之间）
`Broken Clocks`（破碎时钟）
`Fireflies`（萤火虫）
`Lilypad`（睡莲）
`O's Piano`（O的钢琴）
*Added to: 樱花林/森林/沙漠/雪林/繁茂洞穴*
- **新唱片"泪珠"**：恶魂火球被玩家弹回击杀时掉落
*New disc "Tears" dropped when Ghast killed by deflected fireball*
---
### **生动画质（Vibrant Visuals）**
*Graphics Overhaul*
#### **核心特性**
- 默认在支持设备启用
- 定制化大气效果（末地/下界/主世界）
- 保留方块美学：像素阴影/焦散/反射优化
- 跨平台兼容（领域订阅需另购）
#### **纹理更新**
| **类别** | **更新内容** |
|----------|--------------|
| 方块 | 玻璃反射增强，炼药锅金属质感调整 |
| 生物 | 蜜蜂/海豚/恶魂/猪鞍/炽足兽纹理翻新 |
| 植物 | 洞穴藤蔓/紫颂花/南瓜/萤火虫灌木优化 |
| 物品 | 盔甲纹饰/粒子/生物蛋/深色橡木船新纹理 |
| 发光效果 | 末影水晶/荧光地衣自发光校准 |
#### **漏洞修复**
```markdown
MCPE-203239：修复云层后方水渲染
MCPE-204062：减少体积雾中瀑布残影
MCPE-201809：夜视效果亮度一致性优化
MCPE-201984：修复靠近光源时雾突然变亮
MCPE-212398：修复末地传送门黑块问题
```
---
### **方块与物品**
*Blocks & Items*
#### **机制变更**
- 绯红/诡异菌根不可点燃（MCPE-80066）
- 信标光束高度上限 **2048**（MCPE-190223）
- 三叉戟在创造模式归类至"工具/武器"（MCPE-181002）
- 拴绳合成配方移除粘液球
#### **漏洞修复**
- 丛树叶透明化问题（MCPE-110630）
- 发射熔岩桶失败问题（MCPE-178295）
- 孢子花被水破坏时掉落物品（MCPE-127677）
---
### **生物行为调整**
*Mobs Behavior*
#### **关键修复**
| 生物 | 问题 | 解决方案 |
|------|------|----------|
| 猪灵蛮兵 | 和平模式不消失 | 现在正常消失（MCPE-88837） |
| 恶魂 | 发射火球时卡顿 | 修复移动逻辑（MCPE-201849） |
| 岩浆怪/史莱姆 | 死亡后短暂伤害玩家 | 修复伤害残留（MCPE-166394） |
| 蜘蛛 | 寒冷群系无流浪者骑手 | 恢复生成机制（MCPE-89549） |
#### **其他优化**
- 马/驴/骡子可通过喂食胡萝卜恢复生命与生长
- 烈焰人攻击距离 **16→48格**（同步Java版）
- 快乐恶魂骑乘时可被其他生物推动（玩家站立时除外）
### **音效修复与优化**
*Sounds*
- 修复鹦鹉模仿溺尸时错误使用僵尸音效的问题
- 修复鹦鹉模仿凋零骷髅时错误使用骷髅音效的问题（MCPE-174857）
- **草方块音效增强**：破坏/放置草方块的音效音量提升
- **拴绳定制音效**：拴绳连接/断开/回收生物/生物互拴时播放专属音效
- **拴绳结音效**：破坏拴绳结时播放音效（被攻击或生物全解除时）（MCPE-21743）
- **音乐淡出优化**：禁用游戏暂停时，离开世界后音乐正常淡出（MCPE-212932）
---
### **环境音效调整**
*Ambient Sounds*
- 更新多种方块环境音效的触发频率与位置
- **枯灌木**：环境音效触发概率小幅提升
- **沙粒音效**：
- 不再需要天空暴露条件
- 触发概率小幅降低
- 现可在所有生物群系触发
- **陶瓦**：不再触发沙粒音效
- **沙块**：不再触发风声
- **干草丛**：下方有2层沙/红沙/陶瓦时可触发风声
- **陶瓦**：不再触发风声
---
### **投射物物理优化**
*Projectiles*
```markdown
MCPE-201608：动态碰撞容差系统
• 旧机制：固定0.3格碰撞容差
• 新机制：
- 飞行前2刻：无容差（精准命中近处目标）
- 后续每刻：容差增加0.05格
- 上限：0.3格（保留远处目标容错率）
```
> 实现近距高精度与远距容错的平衡
---
### **领域（Realms）功能更新**
*Realms*
- **时间线强制参与**：领域所有者可要求成员必须同意时间线条款才能加入
- 启用路径：领域故事 → 设置 → 开启"需同意时间线"
- 未同意成员保留身份但无法游玩
- 所有者不受限制
- **界面重组**：
- `设置`：管理世界与领域配置
- `添加好友`：管理成员与邀请
---
### **喷溅药水机制**
*Splash Potions*
- 效果范围现基于目标碰撞箱距离计算（非中心位置）（MCPE-201604）
> 修复药水击中大型生物边缘时无效的问题
---
### **稳定性与性能**
*Stability and Performance*
- 修复分屏模式下玩家破坏他人打开的容器时崩溃
- 修复相同资源包不同版本切换时的报错
- 解决多设备同时下载服务器资源时的卡死问题
- 修复创建世界时调整资源包优先级导致的崩溃
---
### **用户界面优化**
*User Interface*
| **修复项** | **问题ID** | **效果** |
|------------|------------|----------|
| 捆绑包光标定位 | MCPE-189314 | 手柄L3/方向键悬停时准确定位 |
| 捆绑包提示重叠 | MCPE-187171 | 触屏设备快速交互时不重叠物品提示 |
| 捆绑包UI消失 | - | 控制器切换物品栏标签时正确关闭 |
| 文字背景透明度 | MCPE-79331 | 同步影响快捷栏提示/聊天背景/计分板 |
| 平坦世界预设 | MCPE-194367 | "雪之王国"使用雪层（非雪块）同步Java版 |
| 捆绑包拆分 | MCPE-188353 | 触控拆分物品栈转移数量准确 |
| 暂停文本溢出 | MCPE-217394 | "游戏已暂停"文本边界限制 |
| 快捷栏文本阴影 | MCPE-217870 | 亮色背景下的文字可读性提升 |
| 聊天背景控制 | - | 新增辅助设置调节聊天背景透明度 |
---
### **跨版本一致性修复**
*Vanilla Parity*
| **问题** | **修复方案** | **问题ID** |
|----------|--------------|------------|
| 海绵吸收含水屏障 | 修复吸水逻辑 | MCPE-174826 |
| 僵尸疣猪兽移速 | 同步Java版移速 | - |
| 猪灵/疣猪兽经验 | 堡垒遗迹自然生成者现在掉落经验 | MCPE-166103 |
| 冻峰生物群系 | 海底不生成冰层 | MCPE-194838 |
| 潜行交互阻断 | 修复潜行时无法使用物品的问题 | MCPE-64477 |
| 鹦鹉模仿频率 | 降低模仿敌对生物频率 | MCPE-80319 |
| 矿车光照 | 矿车中方块正确受光 | MCPE-22533 |
| 下界化石生成率 | 同步Java版生成频率 | MCPE-74632 |
| 船只牵引 | 拴绳可拉出水中船只 | - |
> 此部分共实现 **12 项** Java-基岩版特性同步
### **技术更新**
*Technical Updates*
#### **API 增强**
*API*
- **新增战利品条件**：`damaged_by_entity`
- 检测对掉落战利品的实体造成伤害的实体类型
- 类似 `killed_by_entity` 和 `entity_killed`，可通过 `entity_type` 字段筛选战利品表条目
```json
// 示例：检测被骷髅击杀时触发特殊战利品
"conditions": [
{
"condition": "damaged_by_entity",
"entity_type": "minecraft:skeleton"
}
]
```
---
### **@minecraft/server 2.0.0 正式发布**
*@MINECRAFT/SERVER 2.0.0*
> 完整文档：https://learn.microsoft.com/en-us/minecraft/creator/documents/scriptingv2.0.0overview
#### **稳定版迁移**
| **功能** | **变更** |
|----------|----------|
| 相机有效性检测 | `Camera.isValid` 从测试版移至稳定版 |
| 时间系统 | `TicksPerDay` 移至稳定版 |
| 染色方法 | `ScriptTintMethod` 枚举移至稳定版 |
| 地图颜色 | `ScriptBlockMapColorComponent` 枚举移至稳定版 |
#### **关键更新**
- **整数溢出防护**：`ScoreboardObjective.addScore` 检测溢出时保留原值
- **错误信息优化**：`NamespaceNameError` 错误信息增强，`name` 属性固定为 `"NamespaceNameError"`
- **事件重命名**：
- `BlockComponentPlayerDestroyEvent` → `BlockComponentPlayerBreakEvent`
- `onPlayerDestroy` → `onPlayerBreak`
- **实体朝向控制**：新增 `Entity.lookAt()` 方法
- **自定义组件扩展**：支持字符串/数组/对象/布尔值/数字赋值
```javascript
// V2 自定义组件示例
block.setComponent("example:demo", {
data: "文本数据",// 字符串
stats: , // 数组
config: { size: 4 } // 对象
});
```
- **游戏模式枚举标准化**：
`survival` → `Survival`
`creative` → `Creative`
`adventure` → `Adventure`
`spectator` → `Spectator`
#### **坐标系统重构**
- **局部坐标统一**：以下 API 改用单位立方体局部坐标（替代世界坐标）
```javascript
// 旧坐标: {x: 123.123, y: -22.44, z: -400.678}
// 新坐标: {x: 0.123, y: 0.44, z: 0.678} (MCPE-216825)
```
影响接口：
- `BlockRaycastHit.faceLocation`
- `PlayerPlaceBlockBeforeEvent.faceLocation`
- 等 8 个关键 API
#### **新增功能**
- **维度扩展**：
- `Dimension.getBlockBelow()` / `getBlockAbove()` 正式发布
- 新增 `localizationKey` 属性（维度名称本地化键）
- **玩家属性组件**：
- `EntityHungerComponent`（饥饿值）
- `EntitySaturationComponent`（饱和度）
- `EntityExhaustionComponent`（疲惫值）
- **盔甲系统**：
- `EntityEquippableComponent` 新增 `totalArmor`（总护甲值）和 `totalToughness`（总韧性）只读属性
---
### **@minecraft/server-admin 更新**
*@MINECRAFT/SERVER-ADMIN*
- **玩家传送增强**：`transferPlayer` 支持 NetherNet 传输
```javascript
// 新传输方式
serverAdmin.transferPlayer(player, {
netherNetId: "nether:portal-1a3b" // NetherNet ID
});
```
---
### **@minecraft/server-ui 2.0.0 发布**
*@MINECRAFT/SERVER-UI 2.0.0*
#### **问题修复**
- 手柄操作滑块时速度过快（新增超时机制）
#### **表单组件稳定化**
| **表单类型** | **迁移项目** |
|--------------|--------------|
| 下拉菜单 | `ModalFormDataDropdownOptions` |
| 滑块 | `ModalFormDataSliderOptions` |
| 文本框 | `ModalFormDataTextFieldOptions` |
| 开关 | `ModalFormDataToggleOptions` |
| 动作表单 | `header()`/`label()`/`divider()` 方法 |
> 所有选项接口新增 `tooltip` 属性（悬停提示）
---
### **方块组件修复**
*Block Components*
- **修复几何组件漏洞**：`minecraft:geometry.full_block` 现在正确影响：
- 生物生成（完整方块可生成生物）
- 箱子遮挡（完整方块可阻挡箱子）
- 草方块退化（上方有完整方块时退化为泥土）
- 菌岩退化（上方有完整方块时退化为下界岩）
- 藤蔓蔓延（可蔓延至完整方块）
- 呼吸判定（完整方块内无法呼吸）
---
### **方块系统优化**
*Blocks*
#### **剔除规则更新**
```json
// 新剔除规则模式
"culling_rules": {
"cull_against_full_and_opaque": false // 禁用对完整/不透明方块的剔除
}
```
> - `condition` 字段改为可选
> - 移除 `default` 值
#### **自定义组件 V2**
- 实验性开关移除：V2 成为默认标准（JSON 版本 ≥1.21.90）
- **弃用警告**：`minecraft:custom_components` 在 1.21.90 起弃用
- **材质错误处理**：`minecraft:material_instances` 缺失 `"*"` 材质不再报错
#### **粒子系统更新**
- **字段替换**：
`emitter_intensity` → `emitter_particle_count`（同步 `BlockDestructionParticlesComponent`）
```json
// block_destruction.json 示例
"particle_effect": {
"emitter_particle_count": 12 // 新字段
}
```
#### **崩溃修复**
- 手持纹理缺失的方块时崩溃
- 指向空图集条目的纹理配置导致崩溃
#### **命令修复**
- **`testforblock` 忽略方块状态**（MCPE-194284）：
- 修复 1.21.70 引入的漏洞（例如按钮按压状态始终返回 true）
#### **几何组件稳定化**
- `culling_layer` 和 `condition` 字段移出实验性阶段
---
### **相机系统**
*Camera*
- **过肩视角解锁**：使用 `camera_relative` 控制方案 + `follow_orbit` 预设激活
```javascript
camera.setCamera("follow_orbit", {
controlScheme: "camera_relative"
});
```
---
### **命令更新**
*Commands*
- **整数溢出防护**：`/scoreboard players operation` 检测到溢出时保留原值
- 支持操作符：`+=`, `-=`, `*=`, `/=`, `%=`
- **长命令保护**：超长命令不再导致断开连接，而是执行失败（MCPE-177722）
- **控制方案简化**：`/controlscheme` 不再需要启用实验性相机
### **组件系统更新**
*Components*
#### **漏洞修复与优化**
- 修复使用旧版有效方块ID时 `"minecraft:block_placer"` 组件误报警告的问题
- 修复 `"minecraft:entity_placer"` 组件使用有效实体事件标识符时的误报警告
- 粒子效果JSON新增资源引用验证：
- 基础渲染参数中的纹理引用
- 粒子消失条件中的方块引用（`particle_expire_if_in_blocks` / `particle_expire_if_not_in_blocks`）
- 生物群系JSON缺失方块/生物群系引用时记录内容警告
- 修复 `"minecraft:material_instances"` 方块组件缺失纹理的误报警告
---
### **新增实体组件**
*New Entity Components*
#### **1. 和平模式移除**
`minecraft:remove_in_peaceful`
```json
// 控制实体在和平难度下是否消失
{
"minecraft:remove_in_peaceful": true // 默认值可省略
}
```
> 适用于需在和平难度保留的Boss类实体
#### **2. 生物互拴系统**
`minecraft:leashable_to`
```json
// 允许实体作为拴绳枢纽
{
"minecraft:leashable_to": {
"can_retrieve_from": true // 是否允许玩家回收拴绳生物
}
}
```
**交互规则**：
- 玩家潜行+交互可将拴绳生物连接至此实体
- 用剪刀释放生物（需开启 `can_retrieve_from`）
#### **3. 拴绳物理增强**
`minecraft:leashable` **新增字段**：
| 字段 | 类型 | 值 | 物理效果 |
|------|------|----|----------|
| `can_be_cut` | 布尔 | `true`/`false` | 是否允许剪刀切断拴绳 |
| `spring_type` | 枚举 | `"bouncy"` | 高弹性弹簧（空中永不静止） |
||| `"dampened"` | 单阻尼弹簧（对齐移动方向） |
||| `"quad_dampened"` | 四阻尼弹簧（逐渐对齐牵引者） |
| `rotation_adjustment` | 枚举 | - | 实体静止时的朝向校准 |
---
### **交互组件升级**
*Interact Component*
- **物品生成位置调整**：`"minecraft:interact"` 的 `spawn_items` 新增 `y_offset` 子字段
```json
"spawn_items": {
"y_offset": 0.5 // 垂直偏移量（单位：格）
}
```
- **空中控制解禁**：`"minecraft:input_air_controlled"` 不再需要 `"use_beta_features"` 标记
---
### **专用服务器配置**
*Dedicated Server*
- **生动画质限制**：新增参数禁止连接时使用Vibrant Visuals
> 用于保持低配服务器性能稳定
---
### **编辑器 v1.0.0 发布**
*Editor*
> 文档地址：[编辑器功能](https://learn.microsoft.com/minecraft/creator/editor)｜[扩展开发](https://learn.microsoft.com/minecraft/creator/editor/extensions)
#### **核心特性**
**1. 导航控制革新**
```markdown
- 升降键：`E`(上) / `Q`(下)
- 视角切换：`T` 切换鼠标模式
- 滚轮缩放：以光标为中心缩放
- 中键拖拽：XY平面平移
- 环绕观察：
- `Z`/`C`：围绕方块光标旋转
- `Shift+Z`/`Shift+C`：围绕整个选区旋转
```
**2. 生动画质设置升级**
- 动态光照/大气调节控件
- **时间轴擦除器**：实时预览不同时段的光影效果
> 快速创建晨曦/黄昏等场景氛围
**3. 方块选择器**
- **颜色筛选模式**：按色板快速定位建筑方块
> 告别手动搜索，提升美学设计效率
**4. 空心选区生成**
- 一键将实心选区转为空心结构
```markdown
应用场景：
• 快速创建中空塔楼
• 生成地下洞穴系统
• 设计管道网络
```
**5. 线条工具增强**
```markdown
- 多段线绘制：左键添加连续点，Ctrl+左键添加独立点
- 动态调厚：`Shift+方向键` 调整线条厚度
- 选区转换：`Alt+S` 将线条转为选区体积
- 物理模拟：支持摩擦力/重力实时预览
```
### **编辑器 v1.0.0 功能亮点**
*Editor v1.0.0 Feature Highlights*
#### **1. 方块选择器颜色筛选**
*Pick blocks by color*
```markdown
🌈 **建筑美学革命！**
- 方块选择器新增 **颜色筛选模式**
- 按色系快速定位方块（如"深灰渐变"、"橡木色调"）
- 支持创建自定义色板保存常用配色方案
- 解放创造力：无需记忆方块ID，专注视觉设计！
```
#### **2. 空心选区生成**
*Hollow Selection Trim Action*
```markdown
🕳️ **一键生成空心结构**
- 新操作：将实心选区转换为 **空心壳体**
- 自动识别完全封闭的非空气方块
- 典型应用：
• 掏空中世纪塔楼
• 创建地下管道系统
• 设计飞船内部舱室
- 搭配笔刷工具快速生成复杂空腔
```
#### **3. 线条工具全面升级**
*Line Tool Improvements*
**交互优化**：
| 操作 | 键位 | 功能 |
|------|------|------|
| 添加连续点 | 左键 | 创建连接线段 |
| 添加独立点 | Ctrl+左键 | 创建断开控制点 |
| 微调位置 | Ctrl+Shift+方向键 | 单格精度移动点 |
| 线条转选区 | Alt+S | 将路径转为3D选区 |
**厚度控制**：
```markdown
Shift + ←/→：水平厚度调节
Shift + ↑/↓：垂直厚度调节
Shift + 任意方向键：等比例缩放（启用Uniform时）
```
#### **4. 时间轴动画系统**
*Timeline APIs*
```typescript
// 颜色时间轴示例（IColorTimelinePropertyItem）
const colorTimeline = new ColorTimeline();
colorTimeline.addKeyframe(0, "#FF0000"); // 0秒：红色
colorTimeline.addKeyframe(5, "#0000FF"); // 5秒：蓝色
// 应用至方块光照系统
// 数值时间轴示例（INumberTimelinePropertyItem）
const scaleTimeline = new NumberTimeline();
scaleTimeline.addNode(0, 1.0); // 起始尺寸
scaleTimeline.addNode(3, 2.5); // 3秒后放大2.5倍
// 驱动机械装置动画
```
---
### **全量更新日志**
*Full Editor Changelog*
#### **核心系统优化**
| 模块 | 变更 |
|------|------|
| **导航控制** | 默认升降键：E(上)/Q(下) |
| **视角操作** | 中键拖拽平移 | Z/C环绕方块光标 | Shift+Z/C环绕选区 |
| **资源管理** | 方块缩略图尺寸128→64（内存占用减少75%） |
| **世界导出** | 新增日志面板显示导出路径 |
#### **工具链增强**
- **智能填充**：新增"仅限选定方块"切换开关
- **自由选择**：按住Ctrl可直接移除方块（无需Shift组合键）
- **粘贴预览**：
- 全局快捷键：Ctrl+V 启动预览
- Shift+Ctrl+V 直接粘贴
- **方块检查器**：新增"重置方块数据"按钮
- **结构保存**：大型结构保存不再卡顿
#### **界面革新**
- **属性面板**：
- 支持唯一ID标识（uniqueId）
- 新增代理面板功能（addProxyPane）
- 延迟渲染优化（beginConstruct/endConstruct）
- **快捷栏**：添加后自动展开
- **全局UI缩放**：高分辨率设备默认75%
- **菜单系统**：
- 支持自定义工具提示
- 可添加动作图标
#### **渲染管线升级**
- 延迟光照设置面板回归
- 生动画质默认关闭（需手动启用）
- 水体参数可实时调节
- 移除"延迟技术预览"禁用时的点光源选项
---
### **关键问题修复**
*Critical Bug Fixes*
| 问题 | 解决方案 |
|------|----------|
| 地形工具指示器消失 | 确保鼠标点击后立即显示 |
| 多人游戏快捷栏错乱 | 修复玩家重进时加载他人配置 |
| 大型模态框无法滚动 | 添加滚动支持 |
| 颜色选择器卡死 | 修复点击色块时弹出层关闭逻辑 |
| 选区超出体积限制 | 添加边界错误拦截 |
| 旗帜复制失色 | 准确复制颜色与图案 |
| 挤压工具旋转错位 | 对齐方块旋转角度 |
**实体组件 (Entity Components)**
* 新增了 `minecraft:body_rotation_always_follows_head` 实体组件。
* 确保实体的身体始终与头部对齐。
* 不会覆盖 `minecraft:body_rotation_blocked` 组件。
**实体过滤器 (Entity Filters)**
* 新增了 `is_riding_self` 实体过滤器。
* 如果目标实体（subject entity）正在骑乘调用该过滤器的实体（calling entity），则返回 true。
* 新增了 `is_vehicle_family` 实体过滤器。
* 当目标实体正在骑乘具有指定族（family）的载具（vehicle）时，返回 true。
**实验性内容 (Experiments)**
* **自定义组件 V2 (Custom Components v2)** 实验已移除。当使用 **@minecraft/server** 版本 2.0.0 及以上时，自定义组件 V2 功能将自动启用。
* **物品 (Items)**
* 当使用 **自定义组件 V2** 时，自定义组件可以被赋予字符串 (string)、数组 (array)、对象 (object)、布尔值 (bool) 或数字 (number) 类型的值。
```json
"components": {
"example_namespace:example_component": "foo",
"example_namespace:example_component2": 4,
"example_namespace:example_component3": [
"hello",
"world"
],
"example_namespace:example_component4": true,
"example_namespace:example_component5": {
"stuff": 4
},
}
```
* 不再需要 **自定义组件 V2** 实验即可使用自定义组件 V2。
* 自定义组件 V2 在 JSON 版本 1.21.90 及更高版本中可用。
* `"minecraft:custom_components"` 在 1.21.90 版本中已弃用。
* 修复了在启用 **生动视觉效果 (Vibrant Visuals)** 时手持某些物品会导致法线计算错误和/或游戏崩溃的问题。
**游戏玩法 (Gameplay)**
* 修复了在使用 `player_relative` 控制方案时，玩家难以直接向前或向后移动的问题。
* 修复了在使用某些控制方案时，玩家头部有时会抖动的问题。
* 修复了所有相机的默认控制方案。
* 修复了 `minecraft:follow_orbit` 相机在其允许列表 (`allow list`) 中没有正确控制方案的问题。
* 修复了 `camera_relative_strafe` 控制方案。
* 弃用了 `align_target_and_camera_forward`。请改用 `control_scheme` 来切换控制方案。
**目标 (Goals)**
* `minecraft:rideable` 组件的 `"dismount_mode"` 现在能在乘客被 `minecraft:behavior.float` 目标强制下马时正确应用。
**图形 (Graphical)**
* 新增了按生物群系 (biome) 数据驱动部分 **生动视觉效果 / 延迟渲染 (Vibrant Visuals / Deferred Graphics)** 相关设置的功能。创作者可以提供多个版本的大气效果 (atmospherics)、色彩分级 (color grading)、光照 (lighting) 和/或水 (water) 配置，只要每个配置都有唯一的标识符和文件名。每组设置的保留 JSON 名称（例如 `lighting/global.json`）将继续像以前一样运作。创作者可以在 **客户端生物群系 JSON (Client Biome JSON)** 中使用 `minecraft:atmosphere_identifier`、`minecraft:color_grading_identifier`、`minecraft:lighting_identifier` 和 `minecraft:water_identifier` 来将特定的渲染设置连接到给定的生物群系。请注意，某些参数，如色调映射算子 (tone mapping operators)、焦散 (caustics) 和波浪模拟 (wave simulation) 的开关状态目前还不能按生物群系自定义。当玩家在不同生物群系之间移动时，参数将进行空间混合。更多细节请参阅更新的创作者文档。
* 未使用 `minecraft:particle_appearance_lighting` 组件渲染的粒子现在在 **生动视觉效果** 下能按预期渲染。
* 移除了用于切换图形模式的 `';'` 调试功能。
* 在 **生动视觉效果** 下重新校准了所有 MERS 纹理中的自发光值。
* 在 **生动视觉效果** 模式下，更新了所有 Xbox 平台上“偏好性能 (Favors Performance)”目标的阴影配置。
* 在 **生动视觉效果** 模式下，更新了 Xbox One 和 Xbox One X 上“偏好性能 (Prefers Performance)”目标的体积光 (Volumetric) 配置。
* 在 **生动视觉效果** 下降低了焦散 (caustics) 动画的强度和速度。
* 修复了在运行 Android 15 且启用 **生动视觉效果** 的 Xclipse GPU 上屏幕会渲染为黑色的问题 (MCPE-203972)。
* 在 **生动视觉效果** 下增加了自发光强度并调整了色调映射参数。
* 为 **生动视觉效果** 的色彩分级 JSON 文件添加了色温分级 (temperature grading) 设置。模式 (Schemas) 必须指定格式版本为 **1.21.90** 才能访问此新设置。
* 在 `color_grading` 中新增了 `temperature` 对象。
* `enabled` 设置为 `true` 或 `false` 以控制是否启用色温分级。
* `type` 设置为 `white_balance`（白平衡）或 `color_temperature`（色温）以控制应用的分级类型。
* `white_balance` 使用 `temperature` 值来调整相机的白点。较低的 `temperature` 值会使场景显得更蓝。
* `color_temperature` 是白平衡操作的逆操作。较低的 `temperature` 值会使场景显得更红。
* `temperature` 设置开尔文温度值 (kelvin)。
* 示例：
```json
...
"color_grading": {
"temperature": {
"enabled": true,
"type": "color_temperature",
"temperature": 6500.0
}
}
...
```
* 在雾效 (fog) JSON 文件中添加了 `henyey_greenstein_g` 设置。
* 新的 `henyey_greenstein_g` 部分允许为空气 (`air`) 和水 (`water`) 指定值（相位函数参数）。
* 示例：
```json
{
"format_version": "1.21.90",
"minecraft:fog_settings": {
"description": {
"identifier": "minecraft:test_henyey_greenstein_g"
},
"volumetric": {
"henyey_greenstein_g": {
"air": {
"henyey_greenstein_g": 0.5
}
}
}
}
}
```
* 副手 (`off-hand`) 装备的物品在游戏暂停时将不再发生位移 (MCPE-190716)。
* 修复了分屏游戏时不一致的云渲染问题 (MCPE-188934)。
* 修复了渲染控制器 (`render controllers`) 中 `on_fire_color` 的 `g` 和 `a` 值被错误地丢弃 `0` 的问题。这导致像恶魂火球 (`Ghast's fireballs`) 这样的实体会被染成绿色 (MCPE-218297)。
**物品 (Items)**
* 扩展了 `minecraft:wearable` 物品组件，允许隐藏玩家的位置，类似于生物头颅 (`Mob Heads`) 和雕刻南瓜 (`Carved Pumpkin`) 的效果。
* 新的 `"hides_player_location"` 布尔字段定义了当该物品装备在由 `"slot"` 字段指定的可穿戴槽位时，是否在定位器栏 (`Locator Bar`) 和定位器地图 (`Locator Maps`) 上隐藏玩家。
* `"hides_player_location"` 的默认值为 `false`。
* 所有先前定义的 `minecraft:wearable` 物品组件的 `"hides_player_location"` 值都将默认为 `false`。
**Molang**
* 修复了资源包 (`resource packs`) 中的 `query.health` 查询，使其在凋灵 (`Wither`) 死亡后返回 `0`。
* 修复了 `query.health` 对凋灵 (`Wither`) 的查询，使其能正确反映自开始死亡以来经过的游戏刻 (`ticks`)。
* 新增了 `query.is_riding_any_entity_of_type` Molang 查询，用于检查一个实体是否正在骑乘任何指定类型的另一个实体。
**网络协议 (Network Protocol)**
* 添加了 `ActorFlags::BODY_ROTATION_ALWAYS_FOLLOWS_HEAD` 标志。
**实验性技术更新 (Experimental Technical Updates)**
**API**
* 更新了当导入 (`imports`) 找不到时的错误信息。
* 对于自定义组件 V2，移除了在注册没有闭包 (`closures`) 的自定义组件时出现的内容警告 (`content warning`)。
* 这允许在脚本 (`script`) 中注册“纯数据 (`data-only`)”组件，这些组件仅包含参数 (`parameters`) 而没有功能 (`functionality`)，并可以添加到方块 (`blocks`) 和物品 (`items`) 上。
**@MINECRAFT/DIAGNOSTICS**
* 更新了 `SentryOptions` 属性：
* `dsn`：更新为允许使用 `SecretString`，允许使用来自 `@minecraft/server-admin` 的密钥 (`secrets`) 来初始化 Sentry。
* **(新增)** `maxBreadcrumbs`：为每个发送到 Sentry 的错误事件 (`error event`) 存储和报告的最大面包屑 (`breadcrumbs`) 数量。默认值为 20，支持范围从 0（无面包屑）到 100。
* **(新增)** `sampleRate`：一个介于 0 和 1 之间的数字，表示应发送到 Sentry 的事件百分比。例如，值 0.5 表示 50% 的事件会被发送。默认值为 1（100% 的事件）。0 表示不会发送任何事件。
* **(新增)** `debug`：当设置为 `true` 时，将启用来自 Sentry 系统的额外内容日志记录 (`content logging`)。默认为 `false`。
**@MINECRAFT/SERVER 2.1.0-beta**
* 自定义命令 (`Custom Command`) 注册将创建一个不带命名空间 (`namespace`) 的命令名称别名 (`alias`)。
* 如果该名称已被占用，则不会创建别名，并会出现一条内容日志警告 (`content log warning`)。
* 移除了未使用的类：`EntityIterator`, `EntityTypeIterator`, `FilterGroup`, `PlayerIterator`。
* 新增了类 `PlayerHotbarSelectedSlotChangeAfterEvent`。每当快捷栏槽位 (`hotbar slot`) 发生变化时都会触发此事件。
* 新增了枚举 `PlayerInventoryType`。
* 新增了类 `PlayerInventoryItemChangeAfterEvent`。每当玩家物品栏 (`inventory`) 中的物品发生变化时都会触发此事件。这包括 27 个物品栏槽位 (`inventory slots`) 和 9 个快捷栏槽位 (`hotbar slots`)。
* 更新了类 `Container`：
* `reverseFind` 已重命名为 `findLast`。
* `contains` 现在在找不到物品时返回 `undefined`。
* `firstEmptySlot` 现在在找不到空槽位时返回 `undefined`。
* `firstItem` 现在在找不到物品时返回 `undefined`。
* `find` 现在在找不到物品时返回 `undefined`。
* `reverseFind` 现在在找不到物品时返回 `undefined`。
* 为 `Dimension` 和 `Player` 添加了 `stopSound` 和 `stopAllSounds` 方法。
* 在测试版 (`beta`) 中新增了枚举 `LiquidSettings`。
* 在测试版 (`beta`) 中为脚本接口 `JigsawPlaceOptions` 和 `JigsawStructurePlaceOptions` 添加了可选属性 `liquidSettings`。默认为 `ApplyWaterlogging`。
* `CustomCommand` 接口新增属性 `cheatsRequired`。
* 如果未定义 (`undefined`) 或为 `true`（默认为 `true`)，执行自定义命令需要作弊 (`cheats`) 已启用。如果为 `false`，则自定义命令可以在未启用作弊的情况下执行。
* 移除了 `Player.isOp()`。
* 为 `Player` 添加了只读属性 `playerPermissionLevel`。
* 为 `Player` 添加了属性 `commandPermissionLevel`。
* 新增了枚举 `PlayerPermissionLevel`，包含 `Visitor`（访客）、`Member`（成员）、`Operator`（操作员）值。
* 在测试版 (`beta`) 中新增了枚举 `ContainerRulesErrorReason`。包含 `ContainerRulesError` 可能失败的原因。
* 在测试版 (`beta`) 中新增了接口 `ContainerRules`。包含容器操作规则，如果违反这些规则将抛出 `ContainerRulesError`。
* `Container`：
* 在测试版 (`beta`) 中添加了可选属性 `readonly containerRules?: ContainerRules`。如果容器的规则被破坏，将抛出 `ContainerRulesError`。
* 在测试版 (`beta`) 中添加了属性 `readonly weight: number`。容器中所有 `ItemStack` 的总重量 (`weight`)。
* `ItemStack`：
* 在测试版 (`beta`) 中添加了属性 `readonly weight: number`。`ItemStack` 中所有物品的总重量 (`weight`)。
* 在测试版 (`beta`) 中新增了类 `ItemInventoryComponent`。所有包含 `minecraft:storage_item` 组件的物品都将拥有此组件，并允许访问其容器 (`container`)。
* `BlockMovableComponent` API 已添加到测试版 (`beta`)。
* `BlockMovableComponent::movementType`
* `BlockMovableComponent::stickyType`
* 在测试版 (`beta`) 中启用了 `Player.applyImpulse` 和 `Player.clearVelocity`，它们不再抛出错误。
**@MINECRAFT/DEBUG-UTILITIES 1.0.0-beta**
* 新增了 **调试绘图 (Debug Drawing)** 功能。
* 新增了类：`DebugArrow`, `DebugBox`, `DebugCircle`, `DebugDrawer`, `DebugLine`, `DebugShape`, `DebugSphere`, `DebugText`。
* 新增了用于访问和使用此新功能的全局对象：`debugDrawer: DebugDrawer`。
* 修复了在使用 `/reload` 命令后 **调试绘图** 系统崩溃的问题。
* 修复了在使用 `/reload` 命令后 **调试绘图** 图元 (`primitives`) 不可见的问题。
* 修复了新加入世界的玩家看不到 **调试绘图** 图元的问题。
**方块 (Blocks)**
* **新增 `minecraft:random_offset` 组件**（位于“即将推出的创作者功能 (Upcoming Creator Features)”实验选项下）。这允许方块像原版游戏中的植物那样进行随机偏移。
* 示例：
```json
{
"format_version": "1.21.80",
"minecraft:block": {
"description": {
"identifier": "test:test_block"
},
"components": {
"minecraft:collision_box": {
"origin": [-4.0, 4.0, -4.0],
"size":
},
"minecraft:random_offset": {
"x": {
// 这是我们可以从中选择的可能值范围
"range": {
"min": -4,
"max": 4
},
// 这是在给定范围内等间距的步长。
// 提供 0 表示使用范围内的所有可能值
"steps": 16
},
"y": {
"range": {
"min": -4,
"max": 4
},
"steps": 16
},
"z": {
"range": {
"min": -4,
"max": 4
},
"steps": 16
}
}
}
}
}
```
* **新增 `minecraft:movable` 组件**（位于“即将推出的创作者功能 (Upcoming Creator Features)”实验选项下）。这允许方块配置它们在**被活塞 (Piston) 移动时**应如何反应。
* `"movement_type"` (必需)：指定方块被活塞移动时应如何反应。
* `"push_pull"`：允许方块被活塞/粘性活塞 (Sticky Piston) 推动，并被粘性活塞拉动（例如：草方块 (Grass)）。
* `"push"`：允许方块被活塞/粘性活塞推动（例如：带釉陶瓦 (Glazed Terracotta)）。
* `"immovable"`：不允许方块被活塞/粘性活塞推动或拉动（例如：基岩 (Bedrock)）。
* `"popped"`：当被活塞/粘性活塞推动时，方块会被弹射 (pop) 出来（例如：树叶 (Leaves)）。
* `"sticky"` (可选)：指定方块在被活塞移动时应如何处理相邻的方块。
* `"none"`：默认值。不添加任何额外行为。
* `"same"`：当被活塞移动时，会带动相邻的方块一起移动。它不会带动具有不同 `"sticky": "same"` 的方块（例如：蜂蜜块 (Honey Block) 可以带动另一个蜂蜜块，但不能带动粘液块 (Slime Block)）。
* **注意**：此字段仅在 `"movement_type": "push_pull"` 时有效。
* 示例：
```json
"format_version": "1.21.90",
"minecraft:movable": {
"movement_type": "push_pull",
"sticky": "same"
}
```
**方块组件 (Block Components)**
* 在 `UpcomingCreatorFeatures` 实验下，为 `"minecraft:geometry"` 方块组件新增了 `"uv_lock"` 字段。
* UV 锁定 (UV locking) 将允许面 (faces) 保持与默认几何状态相同的纹理方向，无论 `"minecraft:transformation"` 组件如何旋转几何体。
* **限制**：
* 如果使用 Box UVs 的几何体的盒子侧面不相等（即盒子具有非正方形 UVs），则不支持 UV 锁定。
* 具有每面 UVs (per-face UVs) 和非正方形面的几何体将支持 UV 锁定。
* 如果方块 JSON 的 `format_version` 小于 1.19.80，则不支持 UV 锁定。
**命令 (Commands)**
* 为 `/place structure` 和 `/place jigsaw` 命令添加了可选属性 `liquidSettings`。默认为 `apply_waterlogging`（应用含水）。
**Jigsaw**
* 修复了在水中放置 Jigsaw 结构时错误替换水的问题 (MC-216342)。
* 为 `minecraft:jigsaw` JSON 添加了可选属性 `liquid_settings`，允许控制放置结构时如何处理液体。默认为 `apply_waterlogging`（应用含水）。
**组件 (Components)**
* `BlockDestructionParticlesComponent`（方块破坏粒子组件）新增了一个名为 `particle_count`（粒子数量）的字段，允许创作者确定方块破坏时生成的粒子数量。
**用户界面 (User Interface)**
* 触摸屏方向键 (d-pad) 控件在使用相机相对控制方案 (camera relative control schemes) 时现在显示正确的按钮。
**世界生成 (World Generation)**
* 地形匹配 (Terrain Matching) 的 Jigsaw 模板池 (Template Pool) 不再生成浮空岛 (floating islands)。
* 命名空间 (Namespaces) 现在可用于模板池元素位置 (Template Pool element location) 和 Jigsaw 方块标识符 (Jigsaw Block identifiers)。
页:
[1]