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