netease-modsdk-wiki/docs/mcdocs/1-ModAPI/接口/实体/molang.md

sidebarDepth

sidebarDepth
1

molang

Get

客户端

method in mod.client.component.queryVariableCompClient.QueryVariableComponentClient

• 描述

  获取某一个实体计算节点的值，如果不存在返回注册时的默认值

• 参数

  参数名	数据类型	说明
  variableName	str	节点名称，必须以"query.mod."开头

• 返回值

  数据类型	说明
  float	节点的值

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateQueryVariable(entityId)
result = comp.Get('query.mod.state')

GetMolangValue

客户端

method in mod.client.component.queryVariableCompClient.QueryVariableComponentClient

• 描述

  获取实体molang变量的值

• 参数

  参数名	数据类型	说明
  molangName	str	molang变量名称，如query.can_fly

• 返回值

  数据类型	说明
  float或long	节点的值，不存在返回None

• 备注

  • 因为没有渲染上下文，某些molang无法通过该种方式获取到正确的值，如query.is_first_person、variable.is_first_person等。
  • 当molangName传入query.get_name或者query.owner_identifier等需要返回字符串的变量值时，返回其hash64，类型是个int，可以用于比较。query.get_name：返回生物的名字；query.owner_identifier：返回其owner的identifier

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateQueryVariable(entityId)
result = comp.GetMolangValue('query.can_fly')

GetStringHash64

客户端

method in mod.client.component.queryVariableCompClient.QueryVariableComponentClient

• 描述

  返回字符串变量的hash64

• 参数

  参数名	数据类型	说明
  key	str	需要计算的字符串变量,如“steve"

• 返回值

  数据类型	说明
  long	结果值，如果传入不是字符串则返回None

• 备注

  • 可以配合GetMolangValue使用，可以获取query.get_name或者query.owner_identifier等返回hash64的是不是等于某个值

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateQueryVariable(levelId)
result = comp.GetStringHash64('steve')

Register

客户端

method in mod.client.component.queryVariableCompClient.QueryVariableComponentClient

• 描述

  注册实体计算节点

• 参数

  参数名	数据类型	说明
  variableName	str	节点名称，必须以"query.mod."开头
  defalutValue	float	默认值

• 返回值

  数据类型	说明
  bool	注册是否成功

• 备注

  • 注意节点的值使用单精度浮点数存储，如果用来设置整数，那么值大于16777216（或小于-16777216）时就会有误差

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateQueryVariable(levelId)
result = comp.Register('query.mod.state', 0.0)

Set

客户端

method in mod.client.component.queryVariableCompClient.QueryVariableComponentClient

• 描述

  设置某一个实体计算节点的值

• 参数

  参数名	数据类型	说明
  variableName	str	节点名称，必须以"query.mod."开头
  value	float	计算节点的值

• 返回值

  数据类型	说明
  bool	设置是否成功

• 备注

  • 注意节点的值使用单精度浮点数存储，如果用来设置整数，那么值大于16777216（或小于-16777216）时就会有误差

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateQueryVariable(entityId)
result = comp.Set('query.mod.state', 1.0)

UnRegister

客户端

method in mod.client.component.queryVariableCompClient.QueryVariableComponentClient

• 描述

  注销实体计算节点

• 参数

  参数名	数据类型	说明
  variableName	str	节点名称，必须以"query.mod."开头

• 返回值

  数据类型	说明
  bool	注销是否成功

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateQueryVariable(levelId)
result = comp.UnRegister('query.mod.state')