【亲测免费】 Minecraft 命令解析器 Brigadier 完全指南

项目介绍

Brigadier 是一个专为 Minecraft: Java Edition 设计和开发的命令解析器及调度器，现已遵循 MIT 许可证开放源代码，供其他项目自由使用。它提供了一个强大的框架，用于构建复杂且灵活的游戏内命令系统，同时也适合于任何需要高级命令处理的应用场景。

项目快速启动

要将 Brigadier 引入您的 Java 项目中，您可以通过 Maven 或 Gradle 来添加依赖。以下是如何在您的构建配置文件中实现这一点的示例：

Maven

在您的 pom.xml 文件中加入以下依赖（请替换 (the latest version) 为您查找的最新版本号）:

<dependencies>
    <dependency>
        <groupId>com.mojang</groupId>
        <artifactId>brigadier</artifactId>
        <version>(the latest version)</version>
    </dependency>
</dependencies>

<!-- 添加 Minecraft 库作为远程仓库 -->
<repositories>
    <repository>
        <id>minecraft-libraries</id>
        <name>Minecraft Libraries</name>
        <url>https://libraries.minecraft.net/</url>
    </repository>
</repositories>

Gradle

如果您是使用 Gradle，可以在 build.gradle 的 dependencies 部分添加如下代码（同样记得替换版本号）:

repositories {
    maven { url "https://libraries.minecraft.net/" }
}

dependencies {
    implementation 'com.mojang:brigadier:(the latest version)'
}

应用案例和最佳实践

创建一个简单的命令示例来展示如何使用 Brigadier：

假设我们要创建一个命令 /foo，它可以有两种形式：/foo 和 /foo <bar>，其中 <bar> 是一个整数参数。以下是实现这一命令结构的代码片段：

import com.mojang.brigadier.CommandDispatcher;
import com.mojang.brigadier.arguments.IntegerArgumentType;
import com.mojang.brigadier.tree.LiteralCommandNode;

public void registerCommands(CommandDispatcher<CommandSourceStack> dispatcher) {
    dispatcher.register(
        LiteralCommandNode.builder("foo")
            .then(
                ArgumentCommandNode.builder("bar", IntegerArgumentType.integer())
                    .executes(context -> {
                        int bar = context.getArgument("bar", Integer.class);
                        System.out.println("Bar is " + bar);
                        return 1;
                    })
            )
            // 直接执行的命令，没有参数
            .executes(context -> {
                System.out.println("Called foo with no arguments");
                return 1;
            })
    );
}

这段代码展示了如何通过构建命令树来定义命令及其参数，并绑定了执行逻辑。

典型生态项目

尽管Brigadier最初设计用于Minecraft，但其灵活性使其成为多个游戏和应用中的优选命令管理工具。除了在游戏修改（Mod）社区中的广泛使用外，开发者也常将其应用于自定义服务器控制台、模拟游戏、以及需要定制命令接口的任何Java应用程序中。由于它的开源性质，虽然目前没有特定的“生态项目”列表公开提供，但在开源社区中不乏通过Brigadier进行二次开发或集成的例子，尤其是那些围绕游戏开发和服务器管理的项目。

由于Brigadier的设计理念强调模块化和易用性，许多开发者能够轻松地在其基础上搭建复杂的命令管理系统，从而丰富了各自项目的交互方式。

请注意，对于具体的实际应用案例和生态项目的深入探索，建议直接参与相关的论坛、GitHub讨论或者查阅Minecraft Mod开发社区，以获取最新的实例和灵感。