# 微软粒子

# BindEntity

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    绑定粒子发射器到指定实体的指定骨骼上

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id 需要已经创建且未被销毁的粒子发射器
    entity_id str或int 需要绑定的实体id
    bone_name str 需要绑定的骨骼名称(不区分大小写) 默认值为"body"
    offset tuple(float,float,float) 三维 表示粒子发射器的绑定偏移 默认值为(0, 0, 0)
    rotation tuple(float,float,float) 表示粒子发射器绑定的三维旋转(角度制,按照ZYX顺序旋转) 默认值为(0, 0, 0)
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 绑定变换的计算是在局部空间下完成的。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.Create("netease:tutorial_particle")
comp.BindEntity(parId, localId, "rightitem", (0, 0, 0), (0, 0, 0))

# BindModel

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    绑定粒子发射器到指定骨骼模型的指定骨骼上

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id 需要已经创建且未被销毁的粒子发射器
    model_id int 绑定的骨骼模型的ID(见model组件的GetModelId)
    bone_name str 绑定具体骨骼的名称(不区分大小写),默认值为"root"
    offset tuple(float,float,float) 三维 表示粒子发射器的绑定偏移 默认值为(0, 0, 0)
    rotation tuple(float,float,float) 表示粒子发射器绑定的三维旋转(角度制,按照ZYX顺序旋转) 默认值为(0, 0, 0)
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 绑定变换的计算是在局部空间下完成的,没有指定骨骼的情况下默认绑定到"root"上,如果root不存在则该粒子不会显示,也不会被销毁。
    • 切换至其他骨骼模型后导致model_id改变,所以绑定到原model_id上的粒子发射器也会一起消失。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(clientApi.GetLevelId())

par_Id = comp.Create("netease:tutorial_particle")
comp.BindModel(par_Id, model_id, "root", (0, 0, 0), (0, 0, 0))

# Create

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    创建粒子发射器, 创建后立即播放

  • 参数

    参数名
    数据类型
    说明
    effect_name str 粒子发射器名称(粒子发射器json文件中的identifier)
    offset tuple(float,float,float) 三维 表示在某处创建粒子发射器 默认值为(0, 0, 0)
    rotation tuple(float,float,float) 粒子发射器创建后使用的三维旋转(使用角度制,按照ZYX顺序旋转) 默认值为(0, 0, 0)
  • 返回值

    数据类型
    说明
    int 粒子发射器实例ID 返回0表示创建失败
  • 备注

    • 粒子发射器json文件可以通过微软官方编辑器SnowStorm进行创建编辑, 开发者们可以通过访问在线网站 https://snowstorm.app 或在Visual Studio Code扩展商店中搜索"snowstorm"来使用这个编辑器
    • 粒子发射器json文件应存放在 资源包/particles 路径下
    • 粒子发射器json文件内容不应该包含中文,否则会无法解析
    • 请注意,如果粒子发射器出现在世界空间(即 没有绑定实体), 即使粒子发射器json文件定义了minecraft:emitter_lifetime_looping组件, 也只会播放一次或一个周期,随后销毁
    • 部分原版粒子使用了minecraft:emitter_rate_manual组件,需要额外调用EmitManually函数才能发射粒子
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
parId = comp.Create("netease:tutorial_particle", (0, 0, 0), (0, 0, 0))

# CreateBindEntity

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    创建粒子发射器并绑定到指定实体的指定骨骼上, 创建后立即播放

  • 参数

    参数名
    数据类型
    说明
    effect_name str 粒子发射器名称(粒子发射器json文件中的identifier)
    entity_id str或int 需要绑定的实体id
    bone_name str 需要绑定的骨骼名称(不区分大小写) 默认值为"body"
    offset tuple(float,float,float) 三维 表示粒子发射器的绑定偏移 默认值为(0, 0, 0)
    rotation tuple(float,float,float) 表示粒子发射器绑定的三维旋转(使用角度制,按照ZYX顺序旋转) 默认值为(0, 0, 0)
  • 返回值

    数据类型
    说明
    int 粒子发射器实例id 返回0表示创建失败
  • 备注

    • 粒子发射器json文件可以通过微软官方编辑器SnowStorm进行创建编辑, 开发者们可以通过访问在线网站 https://snowstorm.app 或在Visual Studio Code扩展商店中搜索"snowstorm"来使用这个编辑器
    • 粒子发射器json文件应存放在 资源包/particles 路径下
    • 粒子发射器json文件内容不应该包含中文,否则会无法解析
    • 绑定变换的计算是在局部空间下完成的。
    • 部分原版粒子使用了minecraft:emitter_rate_manual组件,需要额外调用EmitManually函数才能发射粒子
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))

# EmitManually

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    手动发射粒子一次

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id 需要已经创建且未被销毁的粒子发射器
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 部分原版粒子使用了minecraft:emitter_rate_manual组件,在创建粒子发射器后不会自动发射粒子,需要额外调用该函数
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("minecraft:water_evaporation_manual", localId, "rightitem")
comp.EmitManually(parId) # 手动发射一次粒子

# Exist

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    判断指定粒子发射器是否存在

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    bool 返回True时,表示指定的粒子发射器存在于场景中
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.Exist(parId)
comp.RemoveAll()
print comp.Exist(parId)

# GetActiveDuration

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    获取粒子发射器的激活周期

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    float 表示粒子发射器激活周期 粒子发射器无效时会返回0.0
  • 备注

    • 粒子发射器的激活周期在其对应的json文件(资源包/particles/xxx.json)中定义
    • 粒子发射器的播放周期等于 激活周期(active_time) + 休眠周期(sleep_time)
    • 对于没有定义激活周期的粒子发射器,其返回值为一个较大的数字(大约为1000000)
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.GetActiveDuration(parId)

# GetBindingID

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    返回粒子绑定的实体id,没有则返回"0"

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    str 绑定的实体id
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.Create("netease:tutorial_particle")
comp.BindEntity(parId, localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.GetBindingID(parId)

# GetBindingModelID

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    返回绑定的骨骼模型id 没有则返回-1

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    int 绑定的骨骼模型id
  • 示例

import mod.client.extraClientApi as clientApi
compFactory = clientApi.GetEngineCompFactory()
comp = compFactory.CreateParticleSystem(clientApi.GetLevelId())
parId = comp.Create("netease:tutorial_particle")
comp.BindModel(parId, modelId, 'root', (0, 0, 0), (0, 0, 0))
print comp.GetBindingModelID(parId)

# GetDuration

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    获取粒子发射器的播放周期(激活+休眠时间)

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    float 表示粒子发射器播放周期 粒子发射器无效时会返回0.0
  • 备注

    • 粒子发射器的播放周期在其对应的json文件(资源包/particles/xxx.json)中定义
    • 粒子发射器的播放周期等于 激活周期(active_time) + 休眠周期(sleep_time)
    • 对于没有定义播放周期的粒子发射器,其返回值为一个较大的数字(大约为1000000)
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.GetDuration(parId)

# GetFacingMode

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    返回粒子发射器的粒子朝向模式

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    str 粒子朝向模式字符串 返回字符串"none"表示非法
  • 备注

    • 朝向模式暂不支持使用脚本设置,可以在粒子编辑器SnowStorm中编辑该属性:https://snowstorm.app

    • 目前支持的朝向模式如下:

        rotate_xyz              粒子朝向相机,面片与相机视角垂直
        rotate_y                粒子朝向相机,但是面片只旋转世界Y轴
        lookat_xyz              粒子旋转XYZ轴看向相机位置
        lookat_y                粒子仅旋转Y轴来看向相机位置
        lookat_direction        可以选择根据速度方向或者自定义方向来决定粒子面片朝向
        direction_x             粒子面片朝向发射器的x轴
        direction_y             粒子面片朝向发射器的y轴
        direction_z             粒子面片朝向发射器的z轴
        emitter_transform_xy    跟随粒子发射器的xy面朝向
        emitter_transform_xz    跟随粒子发射器的xz面朝向
        emitter_transform_yz    跟随粒子发射器的yz面朝向
      
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.GetFacingMode(parId)

# GetLoopAge

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    获取粒子发射器当前播放周期内已播放的时间

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    float 表示粒子发射器在当前播放周期内已播放的时间 粒子发射器id无效时会返回0.0
  • 备注

    • 0.0 <= 已播放的时间 <= 粒子发射器播放周期
    • 返回的周期内已播放时间,受到SetTimeScale、Replay和PlayAt等函数的影响。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.GetLoopAge(parId)
comp.PlayAt(parId, 0.5)
print comp.GetLoopAge(parId)

# GetPos

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    获取粒子发射器位置

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
    is_local bool 是否获取局部空间
  • 返回值

    数据类型
    说明
    Tuple 表示粒子发射器位置的三维向量
  • 备注

    • 如果粒子没有进行绑定(即 没有放在世界空间),则它的局部空间位置等于世界空间位置。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId0 = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 1, 0), (0, 0, 0))
parId1 = comp.Create("netease:tutorial_particle", (0, 1, 0), (0, 0, 0))
print 'local position:', comp.GetPos(parId0, True)
print 'local position:', comp.GetPos(parId1)

print 'world position:', comp.GetPos(parId0, False)
print 'world position:', comp.GetPos(parId1, False)

# GetRot

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    获取粒子发射器局部旋转

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
    is_local bool 表示是否获取局部空间旋转 默认值为True(即 默认获取局部空间旋转)
  • 返回值

    数据类型
    说明
    Tuple 粒子发射器三维旋转(使用角度制)
  • 备注

    • 如果粒子发射器没有进行绑定,则它的局部空间旋转等于世界空间旋转
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (45, 0, 45))
print comp.GetRot(parId) # True
print comp.GetRot(parId, False)

# GetSleepDuration

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    获取粒子发射器的休眠周期

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    float 表示粒子发射器休眠周期 粒子发射器无效时会返回0.0
  • 备注

    • 粒子发射器的休眠周期在其对应的json文件(资源包/particles/xxx.json)中定义
    • 粒子发射器的播放周期等于 激活周期(active_time) + 休眠周期(sleep_time)
    • 对于没有定义休眠周期的粒子发射器,其返回值为0.0
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.GetSleepDuration(parId)

# GetTimeScale

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    获取粒子发射器的播放速度

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    float 表示粒子发射器播放速度 粒子发射器无效时会返回0.0
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem")
print comp.GetTimeScale(parId)
comp.SetTimeScale(parId, 0.2)
print comp.GetTimeScale(parId)

# GetVariable

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    获取粒子发射器的Molang变量值

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
    variable_name str Molang变量名(例如variable.emitter_age)
  • 返回值

    数据类型
    说明
    float 表示粒子发射器的Molang变量值 无效时会返回0.0
  • 备注

    • Molang变量可以在粒子发射器json文件内自行定义。

    • 另外,粒子发射器以及粒子内置了一些Molang变量可供使用:

        variable.emitter_random_1   粒子发射器随机数,范围是0.0到1.0,仅在粒子发射器创建时生成一次
        variable.emitter_random_2   粒子发射器随机数,范围是0.0到1.0,仅在粒子发射器创建时生成一次
        variable.emitter_random_3   粒子发射器随机数,范围是0.0到1.0,仅在粒子发射器创建时生成一次
        variable.emitter_random_4   粒子发射器随机数,范围是0.0到1.0,仅在粒子发射器创建时生成一次
        variable.emitter_lifetime   粒子发射器的播放周期(生命周期)
        variable.emitter_age        粒子发射器当前播放时间
        variable.emitter_speed      粒子发射器的世界空间移动速度,标量,目前仅网易版我的世界可用
        variable.entity_scale       当粒子发射器绑定实体时,这个值表示绑定实体的大小缩放
        variable.particle_lifetime  粒子的生命周期
        variable.particle_age       粒子生成后已经过的时间
        variable.particle_random_1  粒子随机数,范围是0.0到1.0,仅在粒子生成时生成一次
        variable.particle_random_2  粒子随机数,范围是0.0到1.0,仅在粒子生成时生成一次
        variable.particle_random_3  粒子随机数,范围是0.0到1.0,仅在粒子生成时生成一次
        variable.particle_random_4  粒子随机数,范围是0.0到1.0,仅在粒子生成时生成一次
      
    • 关于Molang表达式的使用,目前大家可以参考微软官方文档: https://docs.microsoft.com/en-us/minecraft/creator/reference/content/molangreference/examples/molangconcepts/molangintroduction

  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.GetVariable(parId, 'variable.custom_size') # variable.custom_size 是粒子json文件中自定义的变量

# Hide

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    隐藏粒子发射器(不渲染)

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 请注意,这个函数并不停止粒子发射器的更新,因此粒子发射器在没有绑定实体或被设计为仅播放一次的情况下,会因为播放结束而自然销毁。
    • 可以和Show函数配合使用。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.IsHiding(parId)

# 可以等待粒子出现后调用
comp.Hide(parId)
print comp.IsHiding(parId)

# IsHiding

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    返回粒子发射器是否正在被隐藏(不渲染)

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    bool 表示粒子发射器是否正在隐藏
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.IsHiding(parId)
comp.Hide(parId)
print comp.IsHiding(parId)

# IsPausing

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    返回粒子发射器的逻辑是否正在被暂停

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    bool 表示粒子发射器是否被暂停
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.IsPausing(parId)
comp.Pause(parId)
print comp.IsPausing(parId)

# Pause

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    暂停粒子发射器的逻辑更新,但保持渲染状态

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 可以和Resume函数配合使用,用于暂停粒子发射器的逻辑。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.IsPausing(parId)

# 等待一段时间后调用可以看到时间静止的效果
comp.Pause(parId)
print comp.IsPausing(parId)

# Play

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    播放粒子发射器

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 粒子发射器在创建时就会立即播放,因此不需要手动调用这个函数。
    • 这个函数等价于调用Resume和Show,如果同时需要这两个功能,建议直接使用这个函数。
    • 这个函数用于和Stop函数配合使用,可以使粒子发射器在被停止的时间点继续播放(恢复逻辑更新、开启渲染)。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
comp.Stop(parId)
print comp.IsHiding(parId)
print comp.IsPausing(parId)

comp.Play(parId)
print comp.IsHiding(parId)
print comp.IsPausing(parId)

# PlayAt

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    设置粒子发射器播放时间点

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
    at_second float 播放时间点
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 这个函数可以和Stop函数配合使用(跳转到指定时间点、继续逻辑更新且开启渲染)。
    • 这个函数可以使粒子发射器跳转到它的某个时间点进行播放。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.GetLoopAge(parId)

comp.PlayAt(parId, 0.5)
print comp.GetLoopAge(parId)

# Remove

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    销毁指定粒子发射器

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id 对于不存在的粒子发射器id不会进行任何操作
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 原版的雨水等粒子发射器目前无法通过类似接口销毁,可能是因为它们使用了旧版的微软粒子系统
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.Exist(parId)
comp.Remove(parId)
print comp.Exist(parId)

# RemoveByName

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    销毁场景中指定名称(粒子发射器json中的identifier)的所有粒子发射器

  • 参数

    参数名
    数据类型
    说明
    effect_name str 粒子发射器名称(json中的identifier)
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 原版的雨水等粒子发射器目前无法通过类似接口销毁,可能是因为它们使用了旧版的微软粒子系统进行管理
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.Exist(parId)
comp.RemoveByName("netease:tutorial_particle")
print comp.Exist(parId)

# Replay

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    重播粒子发射器

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 这个函数可以和Stop函数配合使用(重新进行逻辑更新、开启渲染)。
    • 这个函数可以使粒子发射器回到它的时间点零,重新播放(不能用于已经被销毁的粒子发射器)。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))

# 可以等待一段时间后调用
comp.Replay(parId)

# Resume

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    恢复粒子发射器的逻辑更新,不影响渲染状态

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 可以和Pause函数配合使用,用于恢复粒子发射器的逻辑更新。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
comp.Pause(parId)
print comp.IsPausing(parId)

# 可以等待一段时间后调用
comp.Resume(parId)
print comp.IsPausing(parId)

# SetPos

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    设置粒子发射器位置

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
    pos Tuple 三维 表示粒子发射器局部空间位置 默认值为(0, 0, 0)
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 粒子发射器没有进行绑定(即 被放在世界空间)时,它的局部空间位置就是世界空间位置。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId0 = comp.CreateBindEntity("netease:tutorial_particle", localId, "leftitem", (0, 1, 0), (0, 0, 0))
parId1 = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, -1, 0), (0, 0, 0))

comp.SetPos(parId0, (0, 0.5, 0))
comp.SetPos(parId1) # (0, 0, 0)

# SetRelative

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    设置粒子是否在局部空间进行计算

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id 需要粒子发射器已绑定实体
    is_relative bool 表示粒子是否在局部空间进行计算 默认参数值为True
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 此函数对于没有绑定的粒子发射器无效
    • 有关的值可以在粒子发射器json文件中的minecraft:emitter_local_space组件内预先定义, 如果没有该组件,则默认在世界坐标系下(False)进行变换
    • 设置relative为False时,涉及粒子运动相关的计算都会当作是在世界空间进行的。
    • 设置relative为True时,涉及粒子运动相关的计算都会当作是在局部空间进行的。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

# 开发者可以对比两者的区别来理解两个不同的计算空间
parId0 = comp.CreateBindEntity("netease:tutorial_particle", localId, "leftitem", (0, 1.0, 0), (90, 0, 0))
comp.SetRelative(parId0, False)
parId1 = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 1.0, 0), (90, 0, 0))
comp.SetRelative(parId1, True)

# SetRot

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    设置粒子发射器局部旋转

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
    rot Tuple 粒子发射器三维旋转(使用角度制,按照ZYX顺序旋转) 默认值为(0, 0, 0)
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 如果粒子发射器没有进行绑定,则它的局部空间旋转就是世界空间旋转
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId0 = comp.CreateBindEntity("netease:tutorial_particle", localId, "leftitem", (0, 0, 0), (0, 0, 0))
parId1 = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
comp.SetRot(parId1, (0, 0, 90))

# SetRotUseZXY

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    设置粒子发射器局部旋转,旋转顺序按照绕z,x,y轴旋转

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
    rot Tuple 粒子发射器三维旋转(使用角度制,按照ZXY顺序旋转) 默认值为(0, 0, 0)
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 如果粒子发射器没有进行绑定,则它的局部空间旋转就是世界空间旋转
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId0 = comp.CreateBindEntity("netease:tutorial_particle", localId, "leftitem", (0, 0, 0), (0, 0, 0))
parId1 = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
# 绕z轴旋转90度,然后绕x轴旋转90度,最后再绕y轴旋转90度
comp.SetRotUseZXY(parId1, (90, 90, 90))

# SetTimeScale

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    设置粒子发射器的播放速度

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
    scale float 表示播放倍率 可以为负数进行倒放
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 倒放时已经消失的粒子(请注意是单个粒子而不是粒子发射器)不会重新出现,也不会生成新的粒子
    • 如果倒放到了时间点0,没有绑定或者不循环播放的粒子发射器会被销毁
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId0 = comp.CreateBindEntity("netease:tutorial_particle", localId, "leftitem")
# comp.SetTimeScale(parId0, 1.0)
parId1 = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem")
comp.SetTimeScale(parId1, 0.2)

# SetVariable

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    设置粒子发射器的Molang变量值

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
    variable_name str Molang变量名
    value float 表示粒子发射器的Molang变量值
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • Molang变量可以在粒子发射器json文件内自行定义。

    • 另外,粒子发射器以及粒子内置了一些Molang变量可供使用:

        variable.emitter_random_1   粒子发射器随机数,范围是0.0到1.0,仅在粒子发射器创建时生成一次
        variable.emitter_random_2   粒子发射器随机数,范围是0.0到1.0,仅在粒子发射器创建时生成一次
        variable.emitter_random_3   粒子发射器随机数,范围是0.0到1.0,仅在粒子发射器创建时生成一次
        variable.emitter_random_4   粒子发射器随机数,范围是0.0到1.0,仅在粒子发射器创建时生成一次
        variable.emitter_lifetime   粒子发射器的播放周期(生命周期)
        variable.emitter_age        粒子发射器当前播放时间
        variable.emitter_speed      粒子发射器的世界空间移动速度,标量,目前仅网易版我的世界可用
        variable.entity_scale       当粒子发射器绑定实体时,这个值表示绑定实体的大小缩放
        variable.particle_lifetime  粒子的生命周期
        variable.particle_age       粒子生成后已经过的时间
        variable.particle_random_1  粒子随机数,范围是0.0到1.0,仅在粒子生成时生成一次
        variable.particle_random_2  粒子随机数,范围是0.0到1.0,仅在粒子生成时生成一次
        variable.particle_random_3  粒子随机数,范围是0.0到1.0,仅在粒子生成时生成一次
        variable.particle_random_4  粒子随机数,范围是0.0到1.0,仅在粒子生成时生成一次
      

      部分内置的变量(例如variable.emitter_age)会每帧进行刷新,修改它们的值可能会没有任何效果。

    • 关于Molang表达式的使用,目前大家可以参考微软官方文档: https://docs.microsoft.com/en-us/minecraft/creator/reference/content/molangreference/examples/molangconcepts/molangintroduction

  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId0 = comp.CreateBindEntity("netease:tutorial_particle", localId, "leftitem", (0, 0, 0), (0, 0, 0))
parId1 = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))

comp.SetVariable(parId1, "variable.custom_size", 0.1) # 修改内置的Molang值效果不明显甚至无效,因此建议自定义变量名

# Show

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    显示粒子发射器(开启渲染)

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 可以和Hide函数配合使用,用于恢复粒子发射器的显示。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
# 可以等待粒子出现后调用
comp.Hide(parId)
print comp.IsHiding(parId)

# 可以等待粒子隐藏后调用
comp.Show(parId)
print comp.IsHiding(parId)

# Stop

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    停止粒子发射器播放(不渲染且不更新逻辑)

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • 这个函数等价于调用Pause和Hide,如果同时需要这两个功能,建议直接使用这个函数。
    • 因为逻辑被停止更新,所以粒子发射器不会由于播放结束而被自然销毁。
    • 可以使用Play、Replay或PlayAt函数来播放被停止的粒子发射器。
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (0, 0, 0), (0, 0, 0))
print comp.IsHiding(parId)
print comp.IsPausing(parId)

# 可以等待一段时间后调用
comp.Stop(parId)
print comp.IsHiding(parId)
print comp.IsPausing(parId)

# Unbind

客户端

method in mod.client.component.particleSystemCompClient.ParticleSystemCompClient

  • 描述

    解除指定粒子发射器的绑定状态

  • 参数

    参数名
    数据类型
    说明
    par_id int 粒子发射器id 需要已经创建且未被销毁的粒子发射器
    keep_position bool 解绑后是否保持粒子发射器在世界空间的位置 默认值为True
    keep_rotation bool 解绑后是否保持粒子发射器在世界空间的旋转 默认值为True
  • 返回值

    数据类型
    说明
    bool 表示调用是否成功
  • 备注

    • keep_position为False时,解绑后的粒子发射器将使用绑定时的局部偏移作为世界空间位置(即例子中的(6, 6, 6)) keep_rotation为False时,解绑后的粒子发射器将使用绑定时的局部旋转作为世界空间旋转(即例子中的(0, 0, 0))
    • keep_position为True时,解绑后的粒子发射器会保持在解绑前一刻所在的世界空间位置 keep_rotation为True时,解绑后的粒子发射器会保持解绑前一刻的世界空间旋转
    • 请注意,如果粒子发射器出现在世界空间(即 没有绑定实体), 即使粒子发射器json文件定义了minecraft:emitter_lifetime_looping组件, 也只会播放一次或一个周期,随后销毁
  • 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateParticleSystem(None)
localId = clientApi.GetLocalPlayerId()

parId = comp.CreateBindEntity("netease:tutorial_particle", localId, "rightitem", (6, 6, 6), (0, 0, 0))
comp.Unbind(parId)

BindEntity

BindModel

Create

CreateBindEntity

EmitManually

Exist

GetActiveDuration

GetBindingID

GetBindingModelID

GetDuration

GetFacingMode

GetLoopAge

GetPos

GetRot

GetSleepDuration

GetTimeScale

GetVariable

Hide

IsHiding

IsPausing

Pause

Play

PlayAt

Remove

RemoveByName

Replay

Resume

SetPos

SetRelative

SetRot

SetRotUseZXY

SetTimeScale

SetVariable

Show

Stop

Unbind