xiaokun/netease-modsdk-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新3.4API

Browse Source
This commit is contained in:
boybook
2025-06-27 23:59:47 +08:00
parent c0f98b179b
commit 12738a142c
52 changed files with 1146 additions and 292 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
docs/mcdocs/1-ModAPI/更新信息/3.3.md
View File

@@ -1,15 +1,15 @@
# 3.3
2025.3.14：版本号（V3.3 BE1.20.50）包括Mod PC包，手机测试版启动器，和服务器引擎。
2025.3.21：版本号（V3.3 BE1.20.50）包括Mod PC包，手机测试版启动器，和服务器引擎。
示例Demo：<a href="../../../mcguide/20-玩法开发/13-模组SDK编程/60-Demo示例.html" rel="noopenner">前往此处下载</a>
## 一、更新时间表
1. 在2025年3月14日上线3.3第一个Beta版。
2. 在2025年3月27日上线3.3第二个Beta版。
3. 在2025年4月8日上线3.3稳定版。
4. 在2025年4月11日，全渠道将更新3.3版本玩家包体，玩家将陆续更新到3.3版本，请开发者合理安排更新节奏。
2. 在2025年3月21日上线3.3第二个Beta版。
3. 在2025年3月28日上线3.3稳定版。
4. 在2025年4月3日，全渠道将更新3.3版本玩家包体，玩家将陆续更新到3.3版本，请开发者合理安排更新节奏。
## 二、重要功能更新
@@ -22,7 +22,7 @@
![自定义指令](../picture/custom_command.png)
3. 支持播放方块/物品破坏粒子，以及物品被食用时的粒子，可用于增强游戏表现效果，实现加工、锻造等场景的完整视觉反馈链条。例如：机械动力中在传送带上压铸道具，农夫乐事砧板切碎食材等。
4. 我们重新设计了底层数据协议，原生支持Python基础数据类型的直接存储和传输，包括long、tuple、set和frozenset，便于开发者存储和传输复杂数据结构（如方块调色板）。涉及接口包括SetConfigData、GetConfigData、Mod SDK双端通信接口、Apollo通信接口等。
4. 我们重新设计了底层数据协议，原生支持Python基础数据类型的直接存储和传输，包括long、tuple、set和frozenset，便于开发者存储和传输复杂数据结构（如方块调色板）。涉及接口包括SetConfigData、GetConfigData、Mod SDK双端通信接口、Apollo通信接口等。**请不要在3.3存储含有tuple等数据后，在3.2旧版读取并再次存储，将导致数据格式错误**。
5. 新增物品组件<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/1-自定义物品/1-自定义基础物品.html#netease-initial-user-data" rel="noopenner">netease:initial_user_data</a>，用于指定在创造物品栏中注册的初始NBT数据，简化如自带附魔的物品或特殊属性道具的注册流程。
6. 新增方块组件<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/2-自定义方块/1-JSON组件.html#netease-block-animate-random-tick" rel="noopenner">netease:block_animate_random_tick</a>，该组件可方便地实现如落叶飘落、粒子飞散等效果，并对性能无明显影响。
7. 新增维度组件<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/4-自定义维度/1-自定义维度.html#维度配置" rel="noopenner">netease:ban_vanilla_structure</a>，用于灵活地屏蔽原版结构生成。
@@ -80,6 +80,8 @@
- 调整
1. 调整[SetHurtByEntity](../)(服务端)， damage改为浮点型<!--by xgb-->
1. 调整[Hurt](../接口/实体/行为.md#hurt)(服务端)， damage改为浮点型<!--by xgb-->
1. 调整[GetItemInfoByBlockName](../接口/物品.md#getiteminfobyblockname)(服务端)， 新增isLegacy参数，默认为True<!--by liruizhi-->
@@ -114,4 +116,5 @@
- 废弃（将在未来不可用）
1. 废弃SpawnItemToLevel，请使用CreateEngineItemEntity
1. 废弃SpawnItemToLevel，请使用CreateEngineItemEntity

93
docs/mcdocs/1-ModAPI/更新信息/3.4.md Normal file
View File

@@ -0,0 +1,93 @@
# 3.4
2025.5.22：版本号（V3.4 BE1.21.00）包括Mod PC包，手机测试版启动器，和服务器引擎。
示例Demo：<a href="../../../mcguide/20-玩法开发/13-模组SDK编程/60-Demo示例.html" rel="noopenner">前往此处下载</a>
## 一、更新时间表
1. 在2025年5月22日上线3.4第一个Beta版。
2. 在2025年6月05日上线3.4第二个Beta版。
3. 在2025年6月17日上线3.4稳定版。
4. 在2025年6月27日，全渠道将更新3.4版本玩家包体，玩家将陆续更新到3.4版本，请开发者合理安排更新节奏。
## 二、重要功能更新
1. 新增<a href="../../../mcguide/20-玩法开发/15-自定义游戏内容/2-自定义方块/3-特殊方块/11-自定义容器.html" rel="noopenner">自定义容器</a>，可以实现自定义容器界面，支持配置其他方块组件（如自定义实体方块组件）、容器名、交互时打开的自定义ui、以及自定义容器的大小等
2. 新增[PlayerTryPutCustomContainerItemServerEvent](../事件/物品.md#playertryputcustomcontaineritemserverevent)(服务端)用于监听玩家将物品放入自定义容器
3. [ClientItemTryUseEvent](../事件/物品.md#clientitemtryuseevent)(客户端)、[ClientItemUseOnEvent](../事件/物品.md#clientitemuseonevent)(客户端)、[ClientBlockUseEvent](../事件/方块.md#clientblockuseevent)(客户端)事件逻辑性调整。**三个事件cancel时即可取消使用，无需服务端再次cancel，且服务端事件将不再触发**
4. 调整LockCamera(客户端)与AddCameraTrackMotion(客户端)支持**roll旋转**
5. SpawnResources增加掉落经验球参数，设成True时按原版采集逻辑进行经验球掉落，如矿石类方块会产生随机数量的经验球
6. 新增GetPlayerCurrentExhaustionValue(服务端)、SetPlayerCurrentExhaustionValue(服务端) 获取和设置玩家当前消耗度
7. 方块实体模型的渲染消失问题修复，现在将根据netease:aabb组件中clip字段作为裁减碰撞盒，开发者可以自行配置netease:aabb组件中clip字段大小控制模型显示大小
8. 新版视角切换按钮贴图位于/textures/ui/perspective.png，材质包开发者请留意提前适配
## 三、API更新
- 新增
1. 新增[GetIntPos](../接口/通用/数学.md#getintpos)(服务端)， 获取坐标所在方块的位置<!--by lrz-->
1. 新增[GetHostPlayerId](../接口/通用/工具.md#gethostplayerid)(服务端)， 获取房主的entityId<!--by lrz-->
1. 新增[GetIntPos](../接口/通用/数学.md#getintpos)(客户端)， 获取坐标所在方块的位置<!--by lrz-->
1. 新增[GetHostPlayerId](../接口/通用/工具.md#gethostplayerid)(客户端)， 获取房主的entityId<!--by lrz-->
1. 新增[GetPlayerCurrentExhaustionValue](../接口/玩家/属性.md#getplayercurrentexhaustionvalue)(服务端)， 获取玩家当前消耗度<!--by qiuyukun-->
1. 新增[SetPlayerCurrentExhaustionValue](../接口/玩家/属性.md#setplayercurrentexhaustionvalue)(服务端)， 设置玩家当前消耗度<!--by qiuyukun-->
1. 新增[GetPropertyBag](../接口/自定义UI/UI控件.md#getpropertybag)(客户端)， 获取PropertyBag<!--by qiuyukun-->
1. 新增[SetPropertyBag](../接口/自定义UI/UI控件.md#setpropertybag)(客户端)， 设置PropertyBag<!--by qiuyukun-->
1. 新增[ChunkGeneratedServerEvent](../事件/世界.md#chunkgeneratedserverevent)(服务端)， 新增chunkPosX,chunkPosZ<!--by qiuyukun-->
1. 新增[PlayerTryPutCustomContainerItemServerEvent](../事件/物品.md#playertryputcustomcontaineritemserverevent)(服务端)， 玩家尝试将物品放入自定义容器时触发该事件<!--by lidi-->
- 调整
1. 调整[HideSwimGui](../接口/原生UI.md#hideswimgui)(客户端)， 修改接口描述, 隐藏潜伏按钮<!--by jiaoshe-->
1. 调整[SpawnResources](../接口/世界/实体管理.md#spawnresources)(服务端)， 新增是否生成经验球参数，默认为False，设成True时按原版采集逻辑进行经验球掉落，如矿石类方块会产生随机数量的经验球<!--by xgb-->
1. 调整[GetItemBasicInfo](../接口/物品.md#getitembasicinfo)(服务端)， 新增字段，enchant_slot_type<!--by qiuyukun-->
1. 调整[SetPos](../接口/实体/属性.md#setpos)(服务端)， 修改文档类型描述<!--by bailei-->
1. 调整[GetActorRenderParams](../接口/实体/渲染.md#getactorrenderparams)(客户端)， 修复返回数据<!--by lrz-->
1. 调整[LockCamera](../接口/玩家/摄像机.md#lockcamera)(客户端)， lockRot支持roll旋转<!--by qiuyukun-->
1. 调整[AddCameraTrackMotion](../接口/玩家/摄像机.md#addcameratrackmotion)(客户端)， targetRot和startRot支持roll旋转<!--by qiuyukun-->
1. 调整[GetItemBasicInfo](../接口/物品.md#getitembasicinfo)(客户端)， 新增字段，enchant_slot_type<!--by qiuyukun-->
1. 调整[ServerItemTryUseEvent](../事件/物品.md#serveritemtryuseevent)(服务端)， ClientItemTryUseEvent的cancel设置为True时，服务端事件不会被触发了。<!--by bl-->
1. 调整[ServerItemUseOnEvent](../事件/物品.md#serveritemuseonevent)(服务端)， 客户端事件ClientItemUseOnEvent设置ret设置为True时，服务端不再会接受到这个事件。<!--by bl-->
1. 调整[BlockStrengthChangedServerEvent](../事件/方块.md#blockstrengthchangedserverevent)(服务端)， 新增变化前的红石信号量参数<!--by qiuyukun-->
1. 调整[ClientItemTryUseEvent](../事件/物品.md#clientitemtryuseevent)(客户端)， ClientItemTryUseEvent事件设置cancel为True时,不会再给服务端同步物品使用网络包。<!--by bl-->
1. 调整[ClientItemUseOnEvent](../事件/物品.md#clientitemuseonevent)(客户端)， ClientItemUseOnEvent事件设置ret为True时，不会再给服务端同步物品使用网络包。<!--by bl-->
1. 调整[ClientBlockUseEvent](../事件/方块.md#clientblockuseevent)(客户端)， 当拦截交互逻辑时，不再会给服务端发送网络包，<!--by bl-->
1. 调整[BlockAnimateRandomTickEvent](../事件/方块.md#blockanimaterandomtickevent)(客户端)， 新增blockName与auxData参数<!--by xgb-->
1. 调整[ActorDamageCause](../枚举值/ActorDamageCause.md)， 微软把suicide改成了self_destruct<!--by xgb-->
1. 调整[OriginGUIName](../枚举值/OriginGUIName.md)， 增加摄像机视角按钮<!--by qiuyukun-->