手册:中国版2.0

2.0

版本

中国版

发布日期

2022年1月21日

◄◄ 1.25

2.1 ►►

2.0是中国版的一次主要更新，发布于2022年1月21日，更新了基岩版1.17.2的内容。

游戏

• 更新了基岩版1.17.2。
• 更新了网络游戏开服工具2.0。

数据驱动功能

世界生成

生物群系源

• 加入了自定义生物群系源。
  • 在维度的定义文件中使用netease:biome_source组件配置生物群系源。
• 加入了四种生物群系源节点。
  • random_with_weight用于在生物群系池中随机抓取一个生物群系进行填充。
  • fixed_zoom_2x用于将当前的生物群系图等比放大两倍。
  • fuzzy_zoom_2x用于将当前的生物群系图模糊放大两倍。
  • vanilla_zoom_2x用于将当前的生物群系图使用原版放大方法放大两倍。

方块

额外方块

• 加入了自定义可含额外方块的方块。
  • 目前支持自定义可含水、含雪的方块。
• 加入了六种方块服务端定义组件。
  • 使用netease:water_source组件配置方块可含静态水。
  • 使用netease:water_flow_source组件配置方块可含流动水。
  • 使用netease:water_only组件配置该方块只能含水。
  • 使用netease:water_destory组件配置该方块不能含水，且会被水摧毁。
  • 使用netease:snow_recover_able组件配置方块可含雪。
  • 使用netease:can_built_over组件配置顶层雪是否可直接放置在可含雪方块中。

方块实体

• 现在可以在方块实体的客户端定义文件中使用原版粒子和声音效果。
  • 使用particle_effects描述属性自定义粒子效果。
  • 使用sound_effects描述属性自定义声音效果。

物品

书

• 加入了自定义书。
  • 在行为包的customBooks文件夹中被数据驱动。
  • 在customBooks文件夹可以自定义任意名称的自己文件夹，文件夹名同时被认为是该自定义书的书本标识符。
  • BP/customBooks/<book_identifier>/book.json文件用于定义该书挂接的物品的物品标识符、标题、二级标题、首页以及页面、目录和章节的配置。
  • BP/customBooks/<book_identifier>/category文件夹用于放置目录的JSON定义文件。
  • BP/customBooks/<book_identifier>/entry文件夹用于放置章节的JSON定义文件。

燃料

• 加入了netease:fuel组件，用于自定义燃料。

冷却

• 加入了netease:cooldown组件，用于自定义一个物品使用的冷却时间。

模组SDK

方块

额外方块

• 为服务端Minecraft:blockInfo组件加入了SetLiquidBlock方法，用于设置某位置处的额外方块。
• 为服务端Minecraft:blockInfo组件加入了SetSnowBlock方法，用于设置某位置含雪及雪层高度。
• 为服务端Minecraft:blockInfo组件加入了GetLiquidBlock方法，用于获取某位置处的额外方块。
• 为服务端加入了Minecraft:Engine:BlockLiquidStateChangeServerEvent事件，方块转为含额外方块或者脱离含额外方块前触发。
• 为服务端加入了Minecraft:Engine:BlockLiquidStateChangeAfterServerEvent事件，方块转为含额外方块或者脱离含额外方块后触发。
• 为服务端加入了Minecraft:Engine:BlockSnowStateChangeServerEvent事件，方块转为含雪或者脱离含雪前触发。
• 为服务端加入了Minecraft:Engine:BlockSnowStateChangeAfterServerEvent事件，方块转为含雪或者脱离含雪后触发。

物品

书

• 在额外客户端API中加入了GetBookManager函数，用于获取自定义书的书本管理器。

附魔

• Minecraft:Engine:OnItemPutInEnchantingModelServerEvent事件数据中的playerId字段的数据类型更改为字符串。

实体

运动

• 为服务端Minecraft:actorMotion组件加入了ResetMotion方法，用于重置非玩家生物运动的瞬时方向向量。

宿存

• 为服务端Minecraft:attr组件加入了SetPersistent方法，用于设置一个实体是否宿存。

AI

• 为服务端Minecraft:controlAi组件加入了GetBlockControlAi方法，用于获取是否已屏蔽原版的控制AI。

模型

• 为客户端加入了Minecraft:Engine:EntityModelChangedClientEvent事件，实体切换模型时触发。

生命

• 为服务端加入了Minecraft:Engine:HealthChangeServerEvent事件，生物生命值发生变化时触发。
• 为客户端加入了Minecraft:Engine:HealthChangeClientEvent事件，生物生命值发生变化时触发。

标签

• 为服务端Minecraft:tag组件加入了GetEntityTags方法，用于获取实体的标签列表。
• 为服务端Minecraft:tag组件加入了AddEntityTag方法，用于为一个实体添加一个标签。
• 为服务端Minecraft:tag组件加入了RemoveEntityTag方法，用于移除一个实体的一个标签。
• 为服务端Minecraft:tag组件加入了EntityHasTag方法，用于判断实体是否存在某个指定的标签。

特性

• 为客户端Minecraft:attr组件加入了GetAttrValue方法，用于获取一个特性的当前值。
• 为客户端Minecraft:attr组件加入了GetAttrMaxValue方法，用于获取一个特性的最大值。

玩家

生成

• 为服务端Minecraft:game组件加入了GetSpawnDimension方法，用于获取玩家默认出生的维度。
• 为服务端Minecraft:game组件加入了SetSpawnDimensionAndPosition方法，用于设置玩家默认出生的维度与世界出生点。
• 为服务端Minecraft:player组件加入了GetPlayerRespawnPos方法，用于获取单个玩家的重生点。

导航

• 为额外客户端API中的StartNavTo函数加入sfxDepthTest参数，是否开启序列帧深度检测。

粒子

特效

• 为客户端Minecraft:engineEffectBindControl组件加入了Pause方法，用于暂停一个模型特效的播放。
• 为客户端加入了Minecraft:Engine:OnModBlockNeteaseEffectCreatedClientEvent事件，自定义方块实体成功绑定骨骼特效或成功创建粒子特效或序列帧特效时触发。

游戏玩法

游戏规则

• 外放了服务端Minecraft:game组件的SetCanBlockSetOnFireByLightning方法，用于设置禁止或允许闪电点燃方块。
• 外放了服务端Minecraft:game组件的SetCanActorSetOnFireByLightning方法，用于设置禁止或允许闪电点燃实体。

常规

用户界面

• 在额外客户端API中加入了GetTopScreen函数，用于获得当前活动的UI场景栈的栈顶屏幕。
• 为额外客户端API中的PushScreen函数加入createParams参数，用于传递创建UI的自定义参数。
• 在屏幕节点类中加入了GetScreenName函数，用于获得该实例代理的屏幕的名称。

联机大厅

• 为服务端Minecraft:httpToServer组件加入了QueryLobbyUserItem方法，用于查询未发货的订单。
• 为服务端Minecraft:httpToServer组件加入了LobbyGetStorage方法，用于获取存储器数据。
• 为服务端Minecraft:httpToServer组件加入了LobbySetStorageAndUserItem方法，用于设置存储器数据，设置订单已发货。
• 为服务端加入了Minecraft:Engine:lobbyGoodBuySucServerEvent事件，玩家登录联机大厅或者在联机大厅游戏内购买商品时触发。

Molang

• 为客户端Minecraft:queryVariable组件加入了GetStringHash64方法，用于模拟计算Molang返回值中字符串类型对应的哈希值。
• 为客户端Minecraft:queryVariable组件的GetMolangValue方法加入了获取字符串类型的Molang的值的功能，字符串将计算为哈希值输出。

枚举

• 加入了SetBlockType枚举。

修复

AI

• 现在服务端Minecraft:controlAi组件的SetBlockControlAi方法也会冻结使用原版模型的生物的动作。

命令

• 修复了可以通过/summon npc命令召唤教育版NPC的问题。

虚拟世界

• 修复了客户端Minecraft:virtualWorld组件的ModelUpdateAnimationMolangVariable方法在客户端实体中配置了scripts/initialize时不生效的问题。

Apollo SDK

事件

• 在服务端系统中加入了NotifyToMultiClients方法，用于同时向多个客户端通知一个事件。

游戏服

• 在游戏服的Minecraft:Engine:MasterResponseTransferFailServerEvent事件的数据中加入了reason字段，返回失败的错误代码。
• 为游戏服加入了Minecraft:Engine:MasterResponseTransferSucServerEvent事件，当玩家试图转服时，成功定位到可转服的目标服务器时触发。

控制服

• 在控制服管理器中加入了RollingUpdateServers方法，用于滚动更新服务器。
• 在控制服管理器中加入了RollingCloseServers方法，用于滚动关闭服务器。
• 为控制服加入了Minecraft:Engine:RollingUpdateServersEndEvent事件，滚动更新服务器结束时触发。
• 为控制服加入了Minecraft:Engine:RollingCloseServersEndEvent事件，滚动关闭服务器结束时触发。

启动器

• 启动器API中的GetUserGuest函数已弃用。

常规

运营命令

• 加入了/netease/update-player-online-limit命令，用于修改全局最高同时在线人数限制。

枚举

• 加入了AniCheatBlockBreak枚举。
• 加入了AniCheatConsts枚举。
• 加入了AniCheatMove枚举。
• 加入了AniCheatMoveRewind枚举。
• 加入了AniCheatMoveUnSupportRewind枚举。