子指令

CommandSpec Builder 支援分層指令結構，就像這樣：

• /mail（父指令）

  • /mail send（子指令）

  • /mail read（子指令）

所有的子命令都有着单独的 CommandSpec ，并且可以像一个正常的命令一样去创建。

import org.spongepowered.api.text.Text;
import org.spongepowered.api.command.spec.CommandSpec;

// /mail read
CommandSpec readCmd = CommandSpec.builder()
    .permission("myplugin.mail.read")
    .description(Text.of("Read your inbox"))
    .executor(...)
    .build();

// /mail send
CommandSpec sendCmd = CommandSpec.builder()
    .permission("myplugin.mail.send")
    .description(Text.of("Send a mail"))
    .arguments(...)
    .executor(...)
    .build();

和正常的命令不同，子命令并不使用直接注册的方式，而是作为父命令的 CommandSpec Builder 的 CommandSpec.Builder#child(CommandCallable, String…) 的方法参数传入。当然，它们可以使用多个不同的别名，第一个别名将用于主名称，并且会在帮助中显示。

import org.spongepowered.api.Sponge;

CommandSpec mailCommandSpec = CommandSpec.builder()
    .permission("myplugin.mail")
    .description(Text.of("Send and receive mails"))
    .child(readCmd, "read", "r", "inbox")
    .child(sendCmd, "send", "s", "write")
    .build();

Sponge.getCommandManager().register(plugin, mailCommandSpec, "mail", "email");

備註

如果父命令指定了一个 CommandExecutor ，那么会在找不到子命令的所有别名时，交由这个 CommandExecutor 处理。当然，这么一个 CommandExecutor 并不是必须的。