# 1.24

温馨提示,预计在9月23日,全渠道更新1.24版本玩家包体,玩家将陆续更新到1.24版本,请开发者合理安排更新节奏。

2021.09.16:版本号(v1.24 BE1.16.202)

  • 重大功能介绍
  1. 自定义流体

    • 包含流体颜色、贴图、范围、流速设置

    • 可自定义桶装载自定义流体

    • 可设置液体传播火的效果以及进入液体获得的效果

    详见 自定义流体 自定义桶

  2. 自定义附魔

    • 支持自定义魔咒、魔咒等级
    • 可在附魔书、附魔台、铁砧上获得自定义附魔
    • 物品上可包含自定义附魔

    详见 自定义附魔

  3. 自定义方块功能拓展:

  4. 自定义方块实体渲染,可实现表现力更强的自定义方块。

    • 方块实体支持添加动画,支持使用由BlockBench制作的原版模型或者是游戏原版模型。
    • 方块实体支持添加特效,可通过配置或者接口,为自定义方块实体附加粒子特效及序列帧特效。

    详见 自定义方块实体外观

  5. 自定义分页、分组

    • 支持多个自定义分页,可让物品分类更灵活。

    • 支持把物品放在原有分组或自定义分组中,自定义分组支持多个,可让物品分类更规整。

    详见 自定义物品分组 自定义物品分页

  6. 后处理效果

    • 渐晕效果。画面随中心距离逐渐变暗,实现类似瞄准镜等视觉效果。

      详见渐晕

    (展示视频中涉及的demo下载地址如下:自定义附魔 (opens new window)其他内容 (opens new window))

  • 新增
  1. 新增 Shader使用简介 教程

  2. 新增StartCoroutine,开启服务端协程,实现函数分段式执行,可用于缓解复杂逻辑计算导致游戏卡顿问题

  3. 新增StopCoroutine,停止服务端协程

  4. 新增OpenChatGui,打开原版聊天栏

  5. 新增StartCoroutine,开启客户端协程,实现函数分段式执行,可用于缓解复杂逻辑计算导致游戏卡顿问题

  6. 新增StopCoroutine,停止客户端协程

  7. 新增GetTypeFamily,获取生物行为包字段 type_family

  8. 新增AddModEnchantToInvItem,新增给物品栏中物品添加自定义附魔信息接口

  9. 新增RemoveEnchantToInvItem,新增给物品栏中物品移除附魔信息接口

  10. 新增RemoveModEnchantToInvItem,新增给物品栏中物品移除自定义附魔信息接口

  11. 新增GetInvItemModEnchantData,新增获取物品栏的物品自定义附魔信息

  12. 新增GetEquItemModEnchant,新增支持获取生物装备槽位中盔甲的自定义附魔

  13. 新增SetItemMaxDurability,设置物品的最大耐久值

  14. 新增GetItemMaxDurability,获取指定槽位的物品最大耐久

  15. 新增GetPlayerExhaustionRatioByType,获取玩家某行为饥饿度消耗倍率

  16. 新增SetPlayerExhaustionRatioByType,设置玩家某行为饥饿度消耗倍率

  17. 新增SetPlayerAttackSpeedAmplifier,设置玩家攻击速度倍数

  18. 新增SetBlockEntityMolangValue,设置自定义方块实体的Molang变量,用于控制自定义实体的动画转变。

  19. 新增GetBlockEntityMolangValue,获取自定义方块实体的Molang变量的值。

  20. 新增SetEnableBlockEntityAnimations,是否开启自定义方块实体的动画效果。

  21. 新增CreateParticleEffectForBlockEntity,在自定义方块实体上创建粒子特效。

  22. 新增GetParticleEffectIdInBlockEntity,获取在自定义方块实体中已创建的粒子特效的Id。

  23. 新增RemoveParticleEffectInBlockEntity,移除在自定义方块实体上创建的粒子特效。

  24. 新增CreateFrameEffectForBlockEntity,在自定义方块实体上创建序列帧特效。

  25. 新增GetFrameEffectIdInBlockEntity,获取在自定义方块实体中已创建的序列帧特效的Id。

  26. 新增RemoveFrameEffectInBlockEntity,移除在自定义方块实体上创建的序列帧特效。

  27. 新增SetBlockEntityParticlePosOffset,设置自定义方块实体中粒子特效位置的偏移值

  28. 新增SetBlockEntityFramePosOffset,设置自定义方块实体中序列帧特效位置的偏移值

  29. 新增SetBlockEntityModelPosOffset,设置自定义方块实体的实体模型位置偏移值

  30. 新增SetBlockEntityModelScale,设置自定义方块实体的实体模型大小的缩放值。

  31. 新增SetBlockEntityModelRotation,设置自定义方块实体的实体模型在各个轴上的旋转值。

  32. 新增GetPos,获取序列帧特效的世界坐标位置。

  33. 新增GetRot,获取序列帧特效的旋转角度。

  34. 新增GetScale,获取序列帧特效的缩放值。

  35. 新增SetParticleSize,设置粒子特效中粒子大小的最小值及最大值。

  36. 新增GetParticleMaxSize,获取粒子特效中粒子大小的最大值。

  37. 新增GetParticleMinSize,获取粒子特效中粒子大小的最小值。

  38. 新增SetParticleVolumeSize,设置粒子发射器的体积大小缩放。

  39. 新增GetParticleVolumeSize,获取粒子发射器的体积大小缩放值。

  40. 新增SetParticleMaxNum,设置粒子发射器所包含的最大粒子数量。

  41. 新增GetParticleMaxNum,获取粒子发射器包含的最大粒子数量。

  42. 新增SetParticleEmissionRate,设置粒子发射器每帧发射粒子的频率。

  43. 新增GetParticleEmissionRate,获取粒子发射器每帧发射粒子的频率。

  44. 新增GetPos,获取粒子发射器的世界坐标位置。

  45. 新增GetRot,获取粒子发射器的旋转角度。

  46. 新增SetRotUseZXY,设置粒子发射器的旋转,旋转顺序按照绕z,x,y轴旋转

  47. 新增Swing,本地玩家播放原版攻击动作

  48. 新增SetEnableVignette,是否开启渐晕效果

  49. 新增CheckVignetteEnabled,检测是否开启渐晕效果

  50. 新增SetVignetteRGB,设置渐晕效果的渐晕颜色

  51. 新增SetVignetteCenter,设置渐晕效果的渐晕中心位置

  52. 新增SetVignetteRadius,设置渐晕效果的渐晕半径

  53. 新增SetVignetteSmoothness,设置渐晕效果的渐晕模糊系数

  54. 新增HeavyBlockStartFallingServerEvent,增加重力方块变为下落的方块实体后触发的事件

  55. 新增FallingBlockReturnHeavyBlockServerEvent,增加下落的方块实体变回普通重力方块时触发的事件

  56. 新增FallingBlockBreakServerEvent,增加下落的方块实体被破坏时触发的事件

  57. 新增FallingBlockCauseDamageBeforeServerEvent,增加下落的方块计算砸实体伤害的事件,可修改部分属性

  58. 新增OnBeforeFallOnBlockServerEvent,增加实体刚降落到方块上时服务端触发的事件,主要用于伤害计算

  59. 新增OnAfterFallOnBlockServerEvent,增加实体刚降落到方块上时服务端触发的事件,主要用于力的计算

  60. 新增OnStandOnBlockServerEvent,增加当实体站立到方块上时服务端持续触发的事件

  61. 新增PlayerTrySleepServerEvent,玩家尝试使用床睡觉。

  62. 新增PlayerSleepServerEvent,玩家使用床睡觉成功。

  63. 新增PlayerStopSleepServerEvent,玩家停止睡觉

  64. 新增OnItemPutInEnchantingModelServerEvent,玩家将可附魔物品放到附魔台上时的事件,可修改此时附魔台的选项

  65. 新增GrindStoneRemovedEnchantClientEvent,新增玩家点击砂轮合成得到的物品事件

  66. 新增FallingBlockCauseDamageBeforeClientEvent,增加下落的方块计算砸实体伤害的事件,可修改部分属性

  67. 新增OnAfterFallOnBlockClientEvent,增加实体刚降落到方块上时客户端触发的事件,主要用于力的计算

  68. 新增OnStandOnBlockClientEvent,增加当实体站立到方块上时客户端持续触发的事件

  69. 新增EnchantSlotType,附魔槽位枚举值

  70. 新增PlayerExhauseRatioType,饥饿度消耗倍率类型

  • 调整
  1. 调整SetMobKnockback,增加备注:在damageEvent事件里面使用该接口时,需把damageEvent事件回调的knock参数设置为False

  2. 调整SetMotion,增加备注:在damageEvent事件里面使用该接口时,需把damageEvent事件回调的knock参数设置为False

  3. 调整SetMotion,优化文档说明

  4. 调整DepartCamera,坐船情况下,分离相机后玩家的镜头水平转动时能够360度转动。

  5. 调整SetEntityOpacity,更正接口功能作用范围为:只对骨骼模型生效

  6. 调整EntityTickServerEvent,添加实体identifier参数

  7. 调整ChunkLoadedServerEvent,该事件不再需要添加区块白名单

  8. 调整AnvilCreateResultItemAfterClientEvent,返回值新增合成前两个物品的物品信息字典

  9. 调整ChunkLoadedClientEvent,该事件不再需要添加区块白名单

  10. 调整ChunkAcquireDiscardedClientEvent,该事件不再需要添加区块白名单

  • 修复
  1. 修复GetBiomeName,修复了在mod有自定义下界的情况下,获取原版下界未加载区块变成自定义下界群系的问题。

  2. 修复SetEntityScale,修复了某些情况大小会被重置的问题

  3. 修复ActorAcquiredItemClientEvent,修复了与村民交易时会触发两次的问题

  • 废弃(将在未来不可用)
  1. 废弃AddChunkPosWhiteList,区块加载与卸载事件不再需要白名单

  2. 废弃AddChunkPosWhiteList,区块加载与卸载事件不再需要白名单

  3. 废弃SetRot,该接口设置的旋转值按照x,y,z轴旋转,与其他接口不兼容,故逐步废弃。请使用SetRotUseZXY接口

  4. 废弃SetUiItem,推荐使用UI面向对象ItemRendererUIControl.SetUiItem接口