Fabric Wiki

Brigadier 支持命令异常，这些异常可用于结束命令，例如参数未正确解析或命令未能执行，以及更丰富的错误细节。

Brigadier 的所有异常都基于 CommandSyntaxException。Brigadier 提供的两种主要的异常类型分为动态（Dynamic）和一般（Simple），你需要用 create() 抛出它。这些异常还允许您使用 createWithContext(ImmutableStringReader) 指定出现异常的上下文，它将生成错误消息以指向输入的代码中出错的位置。

下面是一个抛硬币的代码，用于显示使用中的异常示例。

对于1.18及以下：

dispatcher.register(literal("coinflip")
    .executes(ctx -> {
        Random random = Random.create();
 
        if(random.nextBoolean()) { // If heads succeed.
            ctx.getSource().sendMessage(Text.translatable("coin.flip.heads"))
            return Command.SINGLE_SUCCESS;
        }
 
        throw new SimpleCommandExceptionType(new TranslatableText("coin.flip.tails")).create(); // Oh no tails, you lose.
    }));

你不需要局限于一种类型的异常，Brigadier 还提供了动态异常，能为上下文提供额外的参数。

DynamicCommandExceptionType used_name = new DynamicCommandExceptionType(name -> {
    return new LiteralText("The name: " + (String) name + " has been used");
});

1.19及以上：

静态

dispatcher.register(literal("coinflip")
    .executes(ctx -> {
        Random random = Random.create();
 
        if(random.nextBoolean()) { // If heads succeed.
            ctx.getSource().sendMessage(Text.translatable("coin.flip.heads"))
            return Command.SINGLE_SUCCESS;
        }
 
        throw new SimpleCommandExceptionType(Text.translatable("coin.flip.tails")).create(); // Oh no tails, you lose.
    }));

动态

DynamicCommandExceptionType used_name = new DynamicCommandExceptionType(name -> {
    return Text.literal("The name: " + (String) name + " has been used");
});

还有更多的动态异常类型，每种类型都考虑了不同数量的参数（Dynamic2CommandExceptionType、Dynamic3CommandExcessionType、Dynamic4CommandExcitionType、Dynamic NCommandExclusionType）。你应该记住，动态异常将 Object 对象作为参数，因此你可能必须强制转换参数以供使用。