手冊:中國版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列舉。