mirai-console/net.mamoe.mirai.console.command

Package-level declarations

Types

abstract class AbstractCommand @JvmOverloads constructor(val owner: CommandOwner, val primaryName: String, val secondaryNames: Array<out String>, val description: String = "<no description available>", parentPermission: Permission = owner.parentPermission) : Command

Command 的基础实现

AbstractCommandSender

sealed class AbstractCommandSender : CommandSender, CoroutineScope

所有 CommandSender 都必须继承自此对象.

AbstractPluginCustomCommandSender

abstract class AbstractPluginCustomCommandSender(val owner: Plugin) : AbstractCommandSender, PluginCustomCommandSender

所有 PluginCustomCommandSender 的父类

AbstractPluginCustomCommandSenderJ

abstract class AbstractPluginCustomCommandSenderJ(val owner: Plugin) : AbstractPluginCustomCommandSender

AbstractUserCommandSender

sealed class AbstractUserCommandSender : AbstractCommandSender, UserCommandSender

UserCommandSender 的实现

BuiltInCommand

@ConsoleExperimentalApi

interface BuiltInCommand : Command

BuiltInCommands

object BuiltInCommands

内建指令列表

Command

interface Command

指令

CommandContext

@NotStableForInheritance

interface CommandContext

指令执行环境

CommandExecuteResult

@ExperimentalCommandDescriptors

sealed class CommandExecuteResult

指令的执行返回

CommandExecutionException

class CommandExecutionException(val sender: CommandSender, val command: Command, val name: String, cause: Throwable) : RuntimeException

在 CommandManager.executeCommand 中抛出异常时包装的异常.

CommandManager

interface CommandManager

指令管理器

CommandOwner

interface CommandOwner : PermissionIdNamespace

指令的所有者. JvmPlugin 是一个 CommandOwner.

CommandPermissionDeniedException

class CommandPermissionDeniedException(val commandSender: CommandSender, val command: Command) : RuntimeException

在 CommandManager.executeCommand 中, CommandSender 未拥有 Command.permission 所要求的权限时抛出的异常.

CommandSender

interface CommandSender : CoroutineScope, Permittee

指令发送者.

CommandSenderOnMessage

interface CommandSenderOnMessage<T : MessageEvent> : CommandSender

代表一个真实用户主动私聊机器人或在群内发送消息而执行指令

CompositeCommand

abstract class CompositeCommand(owner: CommandOwner, primaryName: String, secondaryNames: String, description: String = "no description available", parentPermission: Permission = owner.parentPermission, overrideContext: CommandArgumentContext = EmptyCommandArgumentContext) : AbstractCommand, Command, CommandArgumentContextAware

复合指令. 指令注册时候会通过反射构造指令解析器.

ConsoleCommandOwner

object ConsoleCommandOwner : CommandOwner

代表控制台所有者. 所有的 mirai-console 内建的指令都属于 ConsoleCommandOwner.

ConsoleCommandSender

object ConsoleCommandSender : AbstractCommandSender, SystemCommandSender

控制台指令执行者. 代表由控制台执行指令

FailureReason

@ExperimentalCommandDescriptors

sealed class FailureReason

FriendCommandSender

open class FriendCommandSender : AbstractUserCommandSender, CoroutineScope

代表一个好友执行指令, 但不一定是通过私聊方式, 也有可能是由插件在代码直接执行 (CommandManager.executeCommand)

FriendCommandSenderOnMessage

class FriendCommandSenderOnMessage : FriendCommandSender, CommandSenderOnMessage<FriendMessageEvent>

代表一个真实的好友主动在私聊消息执行指令

GroupAwareCommandSender

interface GroupAwareCommandSender : UserCommandSender

知道 Group 环境的 UserCommandSender

GroupTempCommandSender

open class GroupTempCommandSender : TempCommandSender, CoroutineScope

代表一个群员通过临时会话执行指令, 但不一定是通过私聊方式, 也有可能是由插件在代码直接执行 (CommandManager.executeCommand)

GroupTempCommandSenderOnMessage

class GroupTempCommandSenderOnMessage : TempCommandSenderOnMessage, CommandSenderOnMessage<GroupTempMessageEvent>

代表一个群员主动在临时会话发送消息执行指令

IllegalCommandArgumentException

open class IllegalCommandArgumentException @JvmOverloads constructor(message: String, cause: Throwable? = null) : IllegalArgumentException

在处理参数时遇到的正常错误. 如参数不符合规范, 参数值越界等.

MemberCommandSender

open class MemberCommandSender : AbstractUserCommandSender, GroupAwareCommandSender, CoroutineScope

代表一个群员执行指令, 但不一定是通过群内发消息方式, 也有可能是由插件在代码直接执行 (CommandManager.executeCommand)

MemberCommandSenderOnMessage

class MemberCommandSenderOnMessage : MemberCommandSender, CommandSenderOnMessage<GroupMessageEvent>

代表一个真实的群员主动在群内发送消息执行指令.

OtherClientCommandSender

open class OtherClientCommandSender : AbstractCommandSender, CoroutineScope

代表一个其他客户端通过私聊执行指令, 但不一定是通过私聊方式, 也有可能是由插件在代码直接执行 (CommandManager.executeCommand)

OtherClientCommandSenderOnMessage

class OtherClientCommandSenderOnMessage : OtherClientCommandSender, CommandSenderOnMessage<OtherClientMessageEvent>

代表一个其他客户端主动在私聊发送消息执行指令

OtherClientCommandSenderOnMessageSync

class OtherClientCommandSenderOnMessageSync : OtherClientCommandSender, CommandSenderOnMessage<MessageSyncEvent>

代表一个其他客户端主动在群内、好友聊天等发送消息执行指令

PluginCustomCommandSender

interface PluginCustomCommandSender : CommandSender, SystemCommandSender

一个来自插件自行实现的 CommandSender.

RawCommand

abstract class RawCommand(val owner: CommandOwner, val primaryName: String, val secondaryNames: String, val usage: String = "<no usages given>", val description: String = "<no descriptions given>", parentPermission: Permission = owner.parentPermission, val prefixOptional: Boolean = false) : Command

无参数解析, 只会接收原消息链的指令. Java 查看 JRawCommand.

SimpleCommand

abstract class SimpleCommand(owner: CommandOwner, primaryName: String, secondaryNames: String, description: String = "no description available", parentPermission: Permission = owner.parentPermission, overrideContext: CommandArgumentContext = EmptyCommandArgumentContext) : AbstractCommand, Command, CommandArgumentContextAware

简单的, 支持参数自动解析的指令.

StrangerCommandSender

open class StrangerCommandSender : AbstractUserCommandSender, CoroutineScope

代表一个陌生人通过私聊执行指令, 但不一定是通过私聊方式, 也有可能是由插件在代码直接执行 (CommandManager.executeCommand)

StrangerCommandSenderOnMessage

class StrangerCommandSenderOnMessage : StrangerCommandSender, CommandSenderOnMessage<StrangerMessageEvent>

代表一个陌生人主动在私聊发送消息执行指令

SystemCommandSender

interface SystemCommandSender : CommandSender

一个来自内部系统的命令执行者.

UnmatchedCommandSignature

@ExperimentalCommandDescriptors

class UnmatchedCommandSignature(val signature: CommandSignature, val failureReason: FailureReason)

UserCommandSender

interface UserCommandSender : CommandSender

代表一个用户执行指令

Functions

execute

@JvmName(name = "execute0")

@ExperimentalCommandDescriptors

inline suspend fun Command.execute(sender: CommandSender, vararg arguments: Message = emptyArray(), checkPermission: Boolean = true): CommandExecuteResult

@JvmName(name = "execute0")

@ExperimentalCommandDescriptors

inline suspend fun Command.execute(sender: CommandSender, arguments: String = "", checkPermission: Boolean = true): CommandExecuteResult

执行一个确切的指令

executeCommand

@JvmName(name = "execute0")

@ExperimentalCommandDescriptors

inline suspend fun CommandSender.executeCommand(message: String, checkPermission: Boolean = true): CommandExecuteResult

解析并执行一个指令

fold

inline fun <R> CommandSender.fold(ifIsSystem: SystemCommandSender.() -> R, ifIsUser: UserCommandSender.() -> R, otherwise: CommandSender.() -> R = { error("CommandSender ${this::class.qualifiedName} is not supported") }): R

折叠 CommandSender 的可能性.

foldContext

@ConsoleExperimentalApi