netease-modsdk-wiki/docs/mcdocs/1-ModAPI/接口/世界/指令.md

sidebarDepth

sidebarDepth
1

指令

GetCommandPermissionLevel

服务端

method in mod.server.component.commandCompServer.CommandCompServer

• 描述

  返回设定使用/op命令时OP的权限等级（对应server.properties中的op-permission-level配置）

• 参数

  无

• 返回值

  数据类型	说明
  int	权限等级：1-OP可以绕过重生点保护；2-OP可以使用所有单人游戏作弊命令；3-OP可以使用大多数多人游戏中独有的命令；4-OP可以使用所有命令

• 示例

import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateCommand(levelId)
opLevel = comp.GetCommandPermissionLevel()
print "GetCommandPermissionLevel oplevel={}".format(opLevel)

GetDefaultPlayerPermissionLevel

服务端

method in mod.server.component.commandCompServer.CommandCompServer

• 描述

  返回新玩家加入时的权限身份（对应server.properties中的default-player-permission-level配置）

• 参数

  无

• 返回值

  数据类型	说明
  int	权限身份：0-Visitor；1-Member；2-Operator；3-自定义

• 示例

import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateCommand(levelId)
opLevel = comp.GetDefaultPlayerPermissionLevel()
print "GetDefaultPlayerPermissionLevel oplevel={}".format(opLevel)

SetCommand

服务端

method in mod.server.component.commandCompServer.CommandCompServer

• 描述

  使用游戏内指令

• 参数

  参数名	数据类型	说明
  cmdStr	str	指令
  entityId	str	实体Id:可选，如果不设置，则随机选择玩家
  showOutput	bool	是否输出到聊天窗口：可选，默认False，如果为True的话，指令正确时，才会和聊天框输入原生指令一样输出返回信息。只有当该参数为True的时候会触发OnCommandOutputServerEvent与OnCommandOutputClientEvent

• 返回值

  数据类型	说明
  bool	命令是否执行成功

• 备注

  • entityId 为非玩家时，即使showOutput为true，也不会输出到聊天窗口，且OnCommandOutputClientEvent 事件不会被触发

• 示例

import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateCommand(levelId)
comp.SetCommand("/tp @p 100 5 100")#传送指令

SetCommandPermissionLevel

服务端

method in mod.server.component.commandCompServer.CommandCompServer

• 描述

  设置当玩家使用/op命令时OP的权限等级（对应server.properties中的op-permission-level配置）

• 参数

  参数名	数据类型	说明
  opLevel	int	权限等级：1-OP可以绕过重生点保护；2-OP可以使用所有单人游戏作弊命令；3-OP可以使用大多数多人游戏中独有的命令；4-OP可以使用所有命令

• 返回值

  数据类型	说明
  bool	命令是否执行成功

• 备注

  • 此API不会修改已经获取了op的玩家的权限等级，仅影响调用API之后才获取op的玩家，建议在游戏初始化时调用此API

• 示例

import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateCommand(levelId)
opLevel = 4
suc = comp.SetCommandPermissionLevel(opLevel)
print "SetCommandPermissionLevel to {} suc={}".format(opLevel, suc)

SetDefaultPlayerPermissionLevel

服务端

method in mod.server.component.commandCompServer.CommandCompServer

• 描述

  设置新玩家加入时的权限身份（对应server.properties中的default-player-permission-level配置）

• 参数

  参数名	数据类型	说明
  opLevel	int	权限身份：0-Visitor；1-Member；2-Operator；3-自定义

• 返回值

  数据类型	说明
  bool	命令是否执行成功

• 备注

  • 此API不会修改已经加入过游戏的玩家的权限身份，仅影响调用API之后才新加入的玩家，建议在游戏初始化时调用此API

• 示例

import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateCommand(levelId)
opLevel = 1
suc = comp.SetDefaultPlayerPermissionLevel(opLevel)
print "SetDefaultPlayerPermissionLevel to {} suc={}".format(opLevel, suc)