---
sidebarDepth: 1
---
# 指令

## GetCommandPermissionLevel

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.commandCompServer.CommandCompServer

- 描述

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

- 参数

    无

- 返回值

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

- 示例

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



## GetDefaultPlayerPermissionLevel

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.commandCompServer.CommandCompServer

- 描述

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

- 参数

    无

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | int | 权限身份：0-Visitor；1-Member；2-Operator；3-自定义 |

- 示例

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



## SetCommand

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.commandCompServer.CommandCompServer

- 描述

    使用游戏内指令

- 参数

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

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 命令是否执行成功 |

- 示例

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



## SetCommandPermissionLevel

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.commandCompServer.CommandCompServer

- 描述

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

- 参数

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

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 命令是否执行成功 |

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

- 示例

```python
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

<span style="display:inline;color:#ff5555">服务端</span>

method in mod.server.component.commandCompServer.CommandCompServer

- 描述

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

- 参数

    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- | :--- |
    | opLevel | int | 权限身份：0-Visitor；1-Member；2-Operator；3-自定义 |

- 返回值

    | <div style="width: 4em">数据类型</div> | 说明 |
    | :--- | :--- |
    | bool | 命令是否执行成功 |

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

- 示例

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