Modernizes Brigadier's command-building API, enhancing multiplatform support and allowing source type mapping for seamless command creation without platform dependency. Features improved API closely mirroring Brigadier.
Portions of this project have been inspired by https://github.com/Mojang/brigadier copyrighted by Microsoft Corporation under the terms of the MIT license.
KBrig is a modern Kotlin rewrite of Brigadier's command building API with a focus on multiplatform support.
It does not replace Brigadier's dispatching logic, so it is still necessary to register and execute commands via the standard Brigadier CommandDispatcher.
A signficant advantage of KBrig is the ability to map the source type of commands.
This allows you to write commands without depending on any specific platform (like Velocity, Paper or Sponge).
With this approach, you can avoid relying on a generic source type.
To convert a KBrig command node to a Brigadier command node, use the .toBrigadier() extension function from kbrig-brigadier.
The API for building commands is almost identical to standard Brigadier with a few improvements, so you should feel right at home.
<version> with the latest version:dependencies {
implementation("org.anvilpowered:kbrig-core:<version>")
}
Kotlin:
interface MyCommandSource {
fun sendMessage(text: Component)
}
fun createPingCommand(): LiteralCommandNode<MyCommandSource> {
return ArgumentBuilder.literal<MyCommandSource>("ping")
.executesSingleSuccess { it.source.sendMessage(Component.text("Pong!")) }
.build()
}
Java:
interface MyCommandSource {
void sendMessage(String message);
}
public static LiteralCommandNode<MyCommandSource> createPingCommand() {
return ArgumentBuilder.literal<MyCommandSource>("ping")
.executes(context -> {
context.getSource().sendMessage("Pong!");
return Command.SINGLE_SUCCESS;
}).build();
}
<version> with the latest version:dependencies {
implementation("org.anvilpowered:kbrig-brigadier:<version>")
}
Kotlin:
class BridgeSource(private val velocityCommandSource: CommandSource) : MyCommandSource {
override fun sendMessage(message: Component) = velocityCommandSource.sendMessage(message)
}
val commandNode = createPingCommand()
.mapSource<_, CommandSource> { BridgeSource(it) }
.toBrigadier()
proxyServer.commandManager.register(BrigadierCommand(commandNode))
Java:
class BridgeSource implements MyCommandSource {
private final CommandSource velocityCommandSource;
BridgeSource(CommandSource velocityCommandSource) {
this.velocityCommandSource = velocityCommandSource;
}
public void sendMessage(Component message) {
velocityCommandSource.sendMessage(message);
}
}
LiteralCommandNode<CommandSource> mappedSourceNode =
BrigadierConverter.toBrigadier(
SourceConverter.mapSource(CustomCommand.createPing(), BridgeSource::)
);
proxyServer.getCommandManager().register( (mappedSourceNode));
Surfaced from shared tags and platforms — no rankings paid for.