# 1.24
温馨提示,预计在9月23日,全渠道更新1.24版本玩家包体,玩家将陆续更新到1.24版本,请开发者合理安排更新节奏。
2021.09.16:版本号(v1.24 BE1.16.202)
- 重大功能介绍
自定义流体
包含流体颜色、贴图、范围、流速设置
可自定义桶装载自定义流体
可设置液体传播火的效果以及进入液体获得的效果
自定义附魔
- 支持自定义魔咒、魔咒等级
- 可在附魔书、附魔台、铁砧上获得自定义附魔
- 物品上可包含自定义附魔
详见 自定义附魔
自定义方块功能拓展:
支持方块重力表现,可自定义铁砧、沙砾等下落效果。
- 支持设置方块下落表现
- 支持设置下落速度以及伤害
- 可获取方块开始下落、结束下落、下落过程接触到实体的事件
详见 自定义重力方块
可获取实体下落到方块的事件,可自定义粘液块的弹跳效果。详见OnAfterFallOnBlockServerEvent,OnAfterFallOnBlockClientEvent
可获取实体在方块上移动的事件,可自定义类似冰、灵魂沙等不同的摩擦效果。详见OnStandOnBlockServerEvent,OnStandOnBlockClientEvent
自定义方块实体渲染,可实现表现力更强的自定义方块。
- 方块实体支持添加动画,支持使用由BlockBench制作的原版模型或者是游戏原版模型。
- 方块实体支持添加特效,可通过配置或者接口,为自定义方块实体附加粒子特效及序列帧特效。
详见 自定义方块实体外观
自定义分页、分组
支持多个自定义分页,可让物品分类更灵活。
支持把物品放在原有分组或自定义分组中,自定义分组支持多个,可让物品分类更规整。
后处理效果
渐晕效果。画面随中心距离逐渐变暗,实现类似瞄准镜等视觉效果。
详见渐晕
(展示视频中涉及的demo下载地址如下:自定义附魔 (opens new window)、其他内容 (opens new window))
- 新增
新增 Shader使用简介 教程
新增StartCoroutine,开启服务端协程,实现函数分段式执行,可用于缓解复杂逻辑计算导致游戏卡顿问题
新增StopCoroutine,停止服务端协程
新增OpenChatGui,打开原版聊天栏
新增StartCoroutine,开启客户端协程,实现函数分段式执行,可用于缓解复杂逻辑计算导致游戏卡顿问题
新增StopCoroutine,停止客户端协程
新增GetTypeFamily,获取生物行为包字段 type_family
新增AddModEnchantToInvItem,新增给物品栏中物品添加自定义附魔信息接口
新增RemoveEnchantToInvItem,新增给物品栏中物品移除附魔信息接口
新增RemoveModEnchantToInvItem,新增给物品栏中物品移除自定义附魔信息接口
新增GetInvItemModEnchantData,新增获取物品栏的物品自定义附魔信息
新增GetEquItemModEnchant,新增支持获取生物装备槽位中盔甲的自定义附魔
新增SetItemMaxDurability,设置物品的最大耐久值
新增GetItemMaxDurability,获取指定槽位的物品最大耐久
新增GetPlayerExhaustionRatioByType,获取玩家某行为饥饿度消耗倍率
新增SetPlayerExhaustionRatioByType,设置玩家某行为饥饿度消耗倍率
新增SetPlayerAttackSpeedAmplifier,设置玩家攻击速度倍数
新增SetBlockEntityMolangValue,设置自定义方块实体的Molang变量,用于控制自定义实体的动画转变。
新增GetBlockEntityMolangValue,获取自定义方块实体的Molang变量的值。
新增SetEnableBlockEntityAnimations,是否开启自定义方块实体的动画效果。
新增CreateParticleEffectForBlockEntity,在自定义方块实体上创建粒子特效。
新增GetParticleEffectIdInBlockEntity,获取在自定义方块实体中已创建的粒子特效的Id。
新增RemoveParticleEffectInBlockEntity,移除在自定义方块实体上创建的粒子特效。
新增CreateFrameEffectForBlockEntity,在自定义方块实体上创建序列帧特效。
新增GetFrameEffectIdInBlockEntity,获取在自定义方块实体中已创建的序列帧特效的Id。
新增RemoveFrameEffectInBlockEntity,移除在自定义方块实体上创建的序列帧特效。
新增SetBlockEntityParticlePosOffset,设置自定义方块实体中粒子特效位置的偏移值
新增SetBlockEntityFramePosOffset,设置自定义方块实体中序列帧特效位置的偏移值
新增SetBlockEntityModelPosOffset,设置自定义方块实体的实体模型位置偏移值
新增SetBlockEntityModelScale,设置自定义方块实体的实体模型大小的缩放值。
新增SetBlockEntityModelRotation,设置自定义方块实体的实体模型在各个轴上的旋转值。
新增GetPos,获取序列帧特效的世界坐标位置。
新增GetRot,获取序列帧特效的旋转角度。
新增GetScale,获取序列帧特效的缩放值。
新增SetParticleSize,设置粒子特效中粒子大小的最小值及最大值。
新增GetParticleMaxSize,获取粒子特效中粒子大小的最大值。
新增GetParticleMinSize,获取粒子特效中粒子大小的最小值。
新增SetParticleVolumeSize,设置粒子发射器的体积大小缩放。
新增GetParticleVolumeSize,获取粒子发射器的体积大小缩放值。
新增SetParticleMaxNum,设置粒子发射器所包含的最大粒子数量。
新增GetParticleMaxNum,获取粒子发射器包含的最大粒子数量。
新增SetParticleEmissionRate,设置粒子发射器每帧发射粒子的频率。
新增GetParticleEmissionRate,获取粒子发射器每帧发射粒子的频率。
新增GetPos,获取粒子发射器的世界坐标位置。
新增GetRot,获取粒子发射器的旋转角度。
新增SetRotUseZXY,设置粒子发射器的旋转,旋转顺序按照绕z,x,y轴旋转
新增Swing,本地玩家播放原版攻击动作
新增SetEnableVignette,是否开启渐晕效果
新增CheckVignetteEnabled,检测是否开启渐晕效果
新增SetVignetteRGB,设置渐晕效果的渐晕颜色
新增SetVignetteCenter,设置渐晕效果的渐晕中心位置
新增SetVignetteRadius,设置渐晕效果的渐晕半径
新增SetVignetteSmoothness,设置渐晕效果的渐晕模糊系数
新增HeavyBlockStartFallingServerEvent,增加重力方块变为下落的方块实体后触发的事件
新增FallingBlockReturnHeavyBlockServerEvent,增加下落的方块实体变回普通重力方块时触发的事件
新增FallingBlockBreakServerEvent,增加下落的方块实体被破坏时触发的事件
新增FallingBlockCauseDamageBeforeServerEvent,增加下落的方块计算砸实体伤害的事件,可修改部分属性
新增OnBeforeFallOnBlockServerEvent,增加实体刚降落到方块上时服务端触发的事件,主要用于伤害计算
新增OnAfterFallOnBlockServerEvent,增加实体刚降落到方块上时服务端触发的事件,主要用于力的计算
新增OnStandOnBlockServerEvent,增加当实体站立到方块上时服务端持续触发的事件
新增PlayerTrySleepServerEvent,玩家尝试使用床睡觉。
新增PlayerSleepServerEvent,玩家使用床睡觉成功。
新增PlayerStopSleepServerEvent,玩家停止睡觉
新增OnItemPutInEnchantingModelServerEvent,玩家将可附魔物品放到附魔台上时的事件,可修改此时附魔台的选项
新增GrindStoneRemovedEnchantClientEvent,新增玩家点击砂轮合成得到的物品事件
新增FallingBlockCauseDamageBeforeClientEvent,增加下落的方块计算砸实体伤害的事件,可修改部分属性
新增OnAfterFallOnBlockClientEvent,增加实体刚降落到方块上时客户端触发的事件,主要用于力的计算
新增OnStandOnBlockClientEvent,增加当实体站立到方块上时客户端持续触发的事件
新增EnchantSlotType,附魔槽位枚举值
新增PlayerExhauseRatioType,饥饿度消耗倍率类型
- 调整
调整SetMobKnockback,增加备注:在damageEvent事件里面使用该接口时,需把damageEvent事件回调的knock参数设置为False
调整SetMotion,增加备注:在damageEvent事件里面使用该接口时,需把damageEvent事件回调的knock参数设置为False
调整SetMotion,优化文档说明
调整DepartCamera,坐船情况下,分离相机后玩家的镜头水平转动时能够360度转动。
调整SetEntityOpacity,更正接口功能作用范围为:只对骨骼模型生效
调整EntityTickServerEvent,添加实体identifier参数
调整ChunkLoadedServerEvent,该事件不再需要添加区块白名单
调整AnvilCreateResultItemAfterClientEvent,返回值新增合成前两个物品的物品信息字典
调整ChunkLoadedClientEvent,该事件不再需要添加区块白名单
调整ChunkAcquireDiscardedClientEvent,该事件不再需要添加区块白名单
- 修复
修复GetBiomeName,修复了在mod有自定义下界的情况下,获取原版下界未加载区块变成自定义下界群系的问题。
修复SetEntityScale,修复了某些情况大小会被重置的问题
修复ActorAcquiredItemClientEvent,修复了与村民交易时会触发两次的问题
- 废弃(将在未来不可用)
废弃AddChunkPosWhiteList,区块加载与卸载事件不再需要白名单
废弃AddChunkPosWhiteList,区块加载与卸载事件不再需要白名单
废弃SetRot,该接口设置的旋转值按照x,y,z轴旋转,与其他接口不兼容,故逐步废弃。请使用SetRotUseZXY接口
废弃SetUiItem,推荐使用UI面向对象ItemRendererUIControl.SetUiItem接口