# 指令

# 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 指令
    playerId str 玩家id:可选,如果playerId不设置,则随机选择玩家
    showOutput bool 是否输出到聊天窗口:可选,默认False,如果为True的话,指令正确时,才会和聊天框输入原生指令一样输出返回信息。只有当该参数为True的时候会触发OnCommandOutputServerEvent与OnCommandOutputClientEvent
  • 返回值

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

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)