文档和工具 文档和工具Beta版

2019.11.22更改:版本号(v1.16 BE1.13.1)

1. 新增服务端与客户端modAttr组件,支持AOI的脚本层属性同步,详见组件说明

2. 微软自定义生物可自行设定是否为实验性的,详见《3-2 自定义生物文档》中关于is_experimental的说明

3. 自定义生物群系新增对自定义特征的支持,通过json配置Feature Rules与Feature,可用于在地形生成时自动放置由结构方块导出的结构。可通过服务端组件neteaseStructureFeatureWhiteList管理结构白名单,白名单内结构在放置时会触发PlaceNeteaseStructureFeatureEvent服务端事件,支持取消放置。详见《3-8 自定义生物群系》

4. PlayerAttackEntityEvent事件新增支持设置击退效果是否生效,详见《3-1 Mod SDK文档》相关事件

5. 新增服务端biome组件及相关接口,详见《3-1 Mod SDK文档》服务端组件biome

6. 由于已支持更强大的json配置配方,RegisterRecipe(rcp)接口从《3-1 Mod SDK文档》中删除

7. 修复《3-4 UI说明文档》中九宫格相关UI拼写错误,buttom改为bottom

8. “自定义spawn_rules”、“生物生成规则说明文档”并入《3-8 自定义生物群系》” ,并剔除重复部分

9. “我的世界基岩版饥饿度机制说明”并入《3-1 Mod SDK文档》中相应的接口说明中

10. “配置文件说明文档”名字修改为“其它基础游戏配置”

11. 新增自定义物品设置物品名字说明,详见《3-9 自定义物品》自定义物品名字部分

12. CreateEngineEntity和CreateEngineEntityByTypeStr增加isNpc参数,详见《3-1Mod SDK文档》

13. controlAi组件SetBlockControlAi接口,修复部分生物失效bug

14. button增加触控事件吞噬功能。详见《3-5 UI API文档》,AddTouchEventHandler中args参数及备注中args的说明

15. 《3-2 自定义生物文档》中删除网易自定义生物。由于微软的自定义生物已经覆盖了网易自定义生物功能,建议使用微软自定义生物。

16. 自定义生物蛋支持发射器。

17. 增加自定义盔甲功能,详见自定义物品文档中的盔甲内容

18. “自定义生物群系”的json格式升级到微软1.13版本。“群系开发模板”移动至demo的behavior/tools目录,并添加“版本升级工具”提供给基于2019.10.24版本开发的开发者。详见《3-8 自定义生物群系》

19. 自定义方块增加“netease:solid”及“netease:pathable”两个component,详见《3-10 自定义方块》

20. 《自定义生物群系》中,“群系开发模板”的json中统一添加了维度名的标签,并去除了“版本升级工具”的相关内容。

21. 自定义特征结构白名单组件更名为feature,添加结构白名单函数更名为AddNeteaseFeatureWhiteList,从结构白名单中移除结构的函数更名为RemoveNeteaseFeatureWhiteList,清空结构白名单函数更名为ClearAllNeteaseFeatureWhiteList,详见《3-1 Mod SDK文档》中feature组件

22. 《自定义生物群系》中补充了Feature Rules文件部分变量及函数的解释说明

2019.11.11 更改:版本号(v1.16 BE1.12.0)

1. 新增“获取指定位置所属的生物群系信息”接口,祥见《3-1Mod SDK文档》生物群系组件

2. 新增更多客户端model相关接口及细化文档,详见客户端组件 model

3. 新增更多客户端game相关接口,详见客户端组件 game

4. 新增更多客户端textboard相关接口,详见客户端组件 textboard

5. 新增客户端blockInfo组件及相关接口

6. 新增服务端scale组件及相关接口

7. 新增更多服务端 action相关接口,详见客户端组件 action

8. 自定义方块新增对自定义刷怪笼方块的支持,可生成原生生物、微软自定义生物及网易自定义生物,详见《3-10 自定义方块》

9. 自定义方块新增对自定义传送门方块的支持,可配置贴图、目标维度、粒子特效,详见《3-10 自定义方块》

10. 新增自定义武器/工具功能,详见自定义物品文档

11. 新增自定义生物蛋功能,详见自定义物品文档

2019.10.24 更改:版本号(v1.16 BE1.12.0)

1. 添加“自定义生物群系”文档,支持自定义维度下的生物群系的自定义

2. 添加“自定义方块”文档,支持json配置的自定义方块,并支持“MOD SDK文档”中“方块”分类的事件及组件。

3. 添加“自定义物品”文档,支持json配置的自定义物品,并支持“MOD SDK文档”中“物品”分类的事件及组件。去除了“MOD SDK文档”中旧版自定义物品的相关内容

4. 新增自定义盔甲功能,详见自定义物品文档

5. camera组件添加GetChosen接口,支持获取选中的方块

6. button支持多点触控,需要使用AddTouchEventHandler注册

7. 修改PlayerAttackEntityEvent事件支持取消

8. 新增AddEntityServerEvent服务端事件

9. 新增饥饿值调整相关接口,详见服务端组件player相关接口

10. 新增进入和离开维度事件DimensionChagneClientEvent、DimensionChagneServerEvent

11. 新增禁止物品使用配置文件和动态管理禁止物品,详见ModSdk文档客户端组件itembanned组件以及《3-14 配置文件说明文档》

12. 新增支持Addon自定义配方,详见《3-12 自定义配方》

13. 新增服务端组件bloackUseEventWhiteList管理对NewModBlockUseEvent事件进行监听

14. 新增更多camera相关接口,详见客户端组件camera

15. 特效绑定参数文档说明细化

16. 新增ActorUseItemServerEvent、ActorUseItemClientEvent事件:玩家使用物品(该事件不提供取消接口)

17. 新增客户端actorCollidable组件:控制玩家是否可碰撞

18. 新增Addon支持spawn_rules自定义,详见《3-11 自定义spawn_rules》

19. 新增 ActorAcquiredItemServerEvent、ActorAcquiredItemClientEvent 事件:玩家获得物品

20. 新增可禁止游戏中藤曼蔓延,详见服务端组件game DisableVineBlockSpread

21. 支持对原版方块白名单监听方块使用事件(ClientNewModBlockUseEvent和NewModBlockUseEvent),并且支持取消使用功能,白名单管理详见服务端组件blockUseEventWhiteList

22. 新增CanSee视野判断接口

23. 新增DamageEvent的可配置参数knock,选择是否击退被攻击者(其他不变)

2019.9.11 更改:版本号(v1.15 BE1.12.9)

1. button绑定回调函数方式修改;并且回调增加move和cancel事件;详见《UI API文档》 AddTouchEventHandler

2. armorslot组件增加修改装备槽位接口

3. PlayerTouchNewModItemEvent事件兼容新版物品

4. 新增OnArmorExchangeServerEvent事件:装备穿上/脱下

5. 新增ClientPlayerInventoryOpenEvent事件:客户端打开和关闭背包事件

6. 新增ClientChestOpenEvent事件:客户端打开和关闭箱子事件

7. tame组件支持实体被玩家驯服

8. 新增ServerPlayerGetExperienceOrbEvent事件:玩家拾起经验球事件

9. item组件支持自定义物品添加到快捷栏或者背包固定槽位

10. component接口化改版

11. 增加mod加载失败时异常信息的输出

12. 支持微软自定义生物,详见《3-2 自定义生物文档》

13. 支持根据特效编辑器配置好的序列帧属性生成序列帧,见“创建特效编辑器编辑的序列帧特效”

14. 支持根据特效编辑器配置好的绑定信息创建特效,见“创建模型特效”

15. Mod SDK文档增加 OnKeyPressInGame的键码描述、伤害增加伤害来源cause

16. 新增客户端组件:actorRender组件。详见ModSdk文档客户端组件实体部分的actorRender组件

17. 新增客户端组件:skyRender组件。详见ModSdk文档客户端组件界面部分的skyRender组件

18. 新增客户端组件:fog组件。详见ModSdk文档客户端组件界面部分的fog组件

19. command组件支持指定玩家功能,command组件调用setCommand时第二个参数可以选择传入玩家ID

2019.7.31 更改:版本号(v1.15 BE1.11.4)

1. 新增服务器组件:gravity组件,设置实体重力。详见ModSdk文档服务端gravity组件

2. 新增设置世界levelGravity,详见ModSdk文档服务器game组件

3. 服务器moveto组件移到生物分类。并添加寻路距离及回调的说明

4. 新增服务器组件chunkSource,可用于区块的长加载。

5. 新增OnItemSlotButtonClickedEvent事件,事件参数详见文档。

6. 新增entityEvent组件和tame组件,详见mod sdk服务器组件部分。

2019.7.8 更改:版本号(v1.14 BE1.11.4)

1. 新增设置游戏gamerule功能,包括作弊选项。详见ModSdk文档服务器game组件的gameRulesInfo

2. 新增设置生物nameTag功能。详见ModSdk文档服务器name组件

3. 新增交换背包物品的槽位功能。详见ModSdk文档服务器item组件

4. 新增设置背包物品数量功能。详见ModSdk文档服务器item组件

5. 新增blockChest组件,支持获取、设置箱子内物品。详见ModSdk文档blockChest组件

6. 新增breath组件,支持获取、设置玩家氧气相关信息。详见ModSdk文档breath组件

7. 新增设置物品tips功能,详见ModSdk文档服务器item组件的customTips

8. 新增关闭生物实例AI的功能,详见ModSdk文档服务器controlAi组件

9. 新增导航(寻路提示)功能,详见ModSdk文档clientApi的GetNavPath及StartNavTo

10. 新增《从零开始创造MOD》文档,Mod示例内增加tutorialMod的demo

11. 优化《Mod入门简介》中的MOD 开发指引,优化文档中对AwesomeMod entities的描述

12. 优化AwesomeMod。增加代码注释,修复按钮弹起后显示问题

2019.5.22 更改:版本号(1.13)

1. 新增OnClientPlayerStartMove事件:客户端玩家开始移动事件

2. 新增OnClientPlayerStopMove事件:客户端玩家移动结束事件

3. 新增OnModItemUseClientEvent事件:使用自定义物品,客户端事件

4. 新增OnModItemUseOnClientEvent事件:对方块使用自定义物品,客户端事件

5. 新增OnModItemUseServerEvent事件:使用自定义物品,服务端事件

6. 新增OnModItemUseOnServerEvent事件:对方块使用自定义物品,服务端事件

7. 新增offHand,carried,inventory客户端组件,详见文档相应组件描述

8. 新增offHand,carried,inventory服务端组件,详见文档相应组件描述

9. operation组件新增moveLock 属性,详见文档描述

10. 新增ApproachEntityClientEvent,LeaveEntityClientEvent客户端事件。玩家靠近、远离生物事件

11. 新增导航相关api

2019.4.16更改:版本号(1.13)

get_player_inventory_slot添加extraId,去除不会覆盖原有值的描述

2019.3.16更改:版本号(1.12)

1. 优化《自定义物品、配方.md》里的说明

2. 新增查询背包指定位置的物品,详见inventory组件

3. 新增屏蔽玩家与容器交互功能,详见服务器game组件

4. 新增禁止玩家丢弃物品功能,详见服务器game组件

5. 内存优化

6. 新增接口控件ProjectileCritHitEvent事件是否开启,详见ProjectileCritHitEvent

7. 加大exdata数据存储量

8. 新增DestroyBlockEvent事件

9. 新增方块组合生成生物事件,详见ServerPreBlockPatternEvent

10. ModBlockUseEvent增加点击方块坐标

2019.3.5更改:版本号(1.11)

1.新增dimension功能,详见dimsnsion组件和createEntity接口

2.新增锁饥饿度功能,详见服务器game组件

3.新加《mod开发时遇到BUG可能的原因》文档

2019.1.29更改:版本号(1.11)

1.data/manifest增加版本信息,version

2.规范文档更新

3.增加mod开发辅助工具

2019.1.10更改:版本号(1.11)

1.UI功能完善,增加UI生命周期函数,layer层级、响应问题优化,详见UI文档

2.UI接口增加namespace参数,详见UI文档

3.modDemo规范化,详见DeveloperDemoMod

4.屏幕分辨率获取接口,详见game组件

5.更新客户端组件:operation新增inair属性。修复按着移动键屏蔽move会一直移动的bug

6.自定义item:相关组件新增extraId字段

7.Carried组件:新增获取是否附魔

8.新增服务端组件:action组件,设置攻击目标对象,实现仇恨效果

2018.12.15更改:版本号(1.11)

1. 更新服务端事件: ServerMobSpawnEvent生成怪物的事件可以控制是否生成。

2. 更新服务端组件: ride组件可以设置是不是可以骑乘,驯服者骑乘,骑乘位置是哪里,骑乘控制以及骑乘的保存。

3. 新增服务端组件:collisionBox组件,设置物体包围盒

4. 增加服务端事件:DamageEvent

5. 更新客户端组件:model增加动画播放速度设置,获取当前播放动画名字。

6. 更新客户端组件:game可以设置不渲染本地玩家。

2018.12.10更改: 版本号(1.11)

1.更新服务器组件:Pos组件当生物不存在时返回none

2.新增服务器事件:替换模型后,走路动作、攻击动作、跳跃动作起始事件与终止事件

3.更新服务器组件:attr组件增加moveDir变量获取生物移动方向

4.更新服务器组件:model组件支持使用平台皮肤和更换骨骼贴图

5.更新客户端组件:actorMotion组件支持客户端移动Player

6.更新客户端组件:model增加原版自定义皮肤功能

7.更新客户端组件:operation操作锁定功能

8.更新UI文档:GetInputVector获取游戏中玩家输入移动的向量

9.更新UI文档:HideHudGUI隐藏游戏中的UI界面

10.Bug修复:textboard第一人称渲染问题

2018.10.10更改:

1.UI node可以设置点击UI时是否响应下层游戏(挥手攻击方块等),设置为False时点击UI不会响应到,True则可以。

2.修复PC端在点击F11后,点击UI界面时,捕捉不到entity的问题,现在可以像鼠标一样点击获取entity。

3.bug修复:health组件获取血量不正确的bug

4.新增设置单个实体血条是否显示功能,详见文档health组件

5.新增设置单个实体名字是否显示功能,详见文档name组件

6.新增设置名字是否透视功能,详见文档game组件

7.新增摄像机锁定及解锁功能,详见文档camera组件

8.新增获取准星选中的实体功能,详见文档camera组件

9.新增设置玩家视角功能,详见文档playerView组件

10.新增伤害功能,详见文档hurt组件

2018.9.17更改:

1.自定义物品的id改为了用str字符串形式,从而避免多mod加载中有冲突;兼容以前mod的形式,但不兼容以前mod的存档。新的自定义物品接口参数可以看文档,新例子也添加到RoboCraft,。对应地,之前接口中设置或获取modValue的component或者event,都会附加一个modExtendValue作为真正的自定义扩展id值。建议开发者以后编码按照新接口,避免旧接口弃用时存在问题。

2. 增加服务器组件:指令组件

3. 服务器事件:玩家攻击事件增加修改伤害值

4. 增加服务器组件:attr组件,提供设置血量、速度和伤害值

5. 新增锁定摄像机功能,详见Camera组件

6. 新增骑乘事件,详见modApi文档EntityStartRidingEvent、EntityStopRidingEvent

7. 修复特效资源缺失导致的程序崩溃

8. 修复pos组件获取位置不正确的问题

9. 所有生物支持骨骼模型

10. 服务器组件:game组件,增加获取区域内实体

11. 客户端组件:帧动画绑定骨骼组件,增加rot和offset实现特效旋转和偏移

12. 客户端组件:粒子绑定骨骼组件,增加rot和offset

13. 服务器组件:game组件,增加通知栏消息

14. bug修复:加载模型时皮肤仍存在的bug

15. bug修复:复活事件重复通知的bug

16. bug修复:第三人称血条、特效渲染位置错乱修复

17. 新增自定义Block的多面向支持。如使用此功能,需要完整定义blocks.json, terrain_texture.json。详细内容参考文档,使用可以参考例子。

18. MOD版本管理。MOD版本管理采取向下兼容,即新的游戏引擎版本,可以兼容新引擎开发的MOD和旧引擎开发的MOD,旧引擎则不能使用新引擎开发的MOD。后续在开发者平台上传MOD时会有MOD引擎版本选择,开发者根据文档中的引擎版本号选择即可。开发者想更新MOD脚本内容(修BUG等等),只需要在MOD的manifest.json中的header的version字段进行版本升级([0, 0, 1] --> [0, 0 ,2]),然后重新上传到开发者平台即可完成更新操作。

19. 设置自定义装备属性,可以设置装备的耐损度和防御值。设置依然是在自定义armor的时候指定;设定后,在该mod期间,属性不会变化。

20. 增加对装备栏进行操作的接口。主要是armorSlotComp,详见文档和示例。

2018.7.25 更新内容

1. OnScriptTickClient、OnScriptTickServer部分机器超过30帧修复

2. 骨骼绑定特效失败时崩溃修复

3. 上下半身动作播放功能,详见api文档model组件

4. system的update()中设置needsUpdate失效修复

5. walkEnd事件延迟问题修复

6. 绑定特效没绑定成功时,特效设置为不显示

7. 特效有机率残留bug修复

8. exDataComp数据失效修复

9. 性能优化

10. 增加复活事件

11. 自定义物品联机显示错误问题修复

12. UI按钮增加cancel事件

13. BlockInfo的Component增加 placeBlock 的接口,用于同帧内更新一个或多个block;之前的blockId、auxData、pos暂时保留用于兼容接口,已弃用,建议不使用。

2018.6.25 更新内容

1.增加了drop itemEntity的示例,详见testFpsSystem.py#OnHitResult

2.增加了实体变种数据值组件,可以获取实体变种的auxValue,目前支持药水的变种数据值,详见文档。

3.修改了物品使用事件回调的监听事件:

ModItemReleaseUseServerEvent改为ModItemUseServerEvent;

ModItemReleaseUseClientEvent改为ModItemUseClientEvent。

4. 子弹伤害hook,ProjectileDoHitEffectEvent事件中, 参数cancel设置为True时,碰撞伤害无效

5. 增加受击cd设置功能,详见api文档中的game组件

6. 增加是显示血条功能,详见api文档中的game组件

7. 性能优化

8. 新增服务器model组件,客户端model组件的模型同步及存盘功能移植到服务器组件

9. 粒子特效使用贴图原色支持,详见特效规范Particle Json

10. 特效需要切换镜头才能看到bug维护

11. 第一人称特效挂接位置不在相应的骨骼上bug维护

12. 特效挂到第一人称骨骼上,第三人称没此骨骼的时候会crash bug维护。当前版本请尽量保证第一人称和第三人称骨骼名称统一,不然可能出现位置错乱问题。

13. 修复联机模式下,调用设置玩家血条颜色时崩溃问题

14. 更新了Addon加载相关信息,更新了Python加载的具体要求和实例,更新了所用到的目录信息,具体内容参见Addon加载.docx

2018.6.13 更新内容

1.骨骼模型播放动画isLoop为False时播放失败修复

2.准星图在开枪时能够放大缩小样例,详见fpsBattle.py#OnClickShoot

3.按钮up down事件不准确bug修复

4.客户端rot组件,详见API文档

5.特效绑定第一人称模型时,特效不显示问题修复

6.scriptTick事件更改。客户端OnScriptTickClient,服务器OnScriptTickServer, 详见API文档

7.Scoreboard UI样例,详见fpsBattle.py#TestScoreBoard

8.客户端新增UiInitFinished事件,创建UI时机使用这个, 详见API文档,样例testFpsSystem.py#__init__

9.button长按、短按实现样例, 详见fpsBattle.py#OnClickShoot

10.特效文档,详见Particle Json.docx

11.补充了骨骼模型组件使用文档

12.服务端engineType组件更改,可以获取entity的类型;增加了客户端engineType。详见文档。

13.子弹碰撞事件ProjectileDoHitEffectEvent修改:如果碰撞到Block,给出精确整型的BlockPos,击中面,可用BlockPos信息和blockInfo组件获取Block的id。详见文档和mod样例。

14.增加客户端的右手物品更换事件,物品修改或物品性质改变时会通知,数量改变不会通知。

15.新增UI文档,详见UI文档

16.射子弹时,骨骼模型播放射击动作样例,详见testFpsSystem.py#PlayAni

17.开镜及镜头缩放样例,详见fpsBattle.py#OnClickAim

18.Mod样例增加物品栏信息获取、物品消耗等操作,详见testFpsSystem.py#Shoot