Imperat - The Blazing Fast Command Framework ⚡

The most performant, feature-rich command framework for Java applications

📚 Documentation • 💬 Discord • 🚀 Get Started • ✨ Features • 📊 Benchmarks

Imperat isn't just another command framework—it's the ultimate solution for developers who demand both blazing performance and rich features.
Built by Mqzen, Imperat delivers sub-microsecond command execution while maintaining an elegant, intuitive API.

Imperat provides the optimum performance for command execution and suggestion providing.
We have proven this through running benchmarks using JMH:

_{Benchmarked on complex command trees with 10+ depth levels and multiple branches}

💡 What does this mean? On a busy Minecraft server with many players, Imperat adds only 0.47ms overhead per 1000 commands, while Other framework like Cloud adds 12.2ms—that's the difference between smooth gameplay and noticeable lag!

<dependency>
    <groupId>studio.mevera</groupId>
    <artifactId>imperat-core</artifactId>
    <version>%LATEST_VERSION%</version>
</dependency>

<!-- Add your platform module (e.g., for Bukkit) -->
<dependency>
    <groupId>studio.mevera</groupId>
    <artifactId>imperat-bukkit</artifactId>
    <version>%LATEST_VERSION%</version>
</dependency>

dependencies {
    implementation("studio.mevera:imperat-core:%LATEST_VERSION%")
    // Add your platform module (e.g., for Bukkit)
    implementation("studio.mevera:imperat-bukkit:%LATEST_VERSION%")
}

dependencies {
    implementation 'studio.mevera:imperat-core:%LATEST_VERSION%'
    // Add your platform module (e.g., for Bukkit)
    implementation 'studio.mevera:imperat-bukkit:%LATEST_VERSION%'
}

public class YourPlugin extends JavaPlugin {
    private BukkitImperat imperat;

    @Override
    public void onEnable() {
        // Create Imperat instance with builder pattern
        this.imperat = BukkitImperat.builder(this)
            .applyBrigadier(true)  // Enhanced suggestions on 1.13+
            .build();
        
        // Register your commands
        imperat.registerCommand(new GameModeCommand());
    }
}

@Command({"gamemode", "gm"})
@Permission("server.gamemode")
@Description("Change player gamemode")
public class GameModeCommand {

    @Usage
    public void mainUsage(
            Player source,
            @Named("mode") GameMode gameMode,
            @Default("me") @Named("target") Player target
    ) {
        // Handle: /gamemode <mode> [target]
        target.setGameMode(gameMode);
        
        source.sendMessage("§aGamemode updated to " + gameMode.name());
        if (target != source) {
            target.sendMessage("§aYour gamemode was updated by " + source.getName());
        }
    }
    
    // Independent root aliases.
    @Command("gmc")
    @Permission("server.gamemode.creative")
    public void creative(Player source, @Default("me") Player target) {
        mainUsage(source, GameMode.CREATIVE, target);
    }
    
    @Command("gms")
    @Permission("server.gamemode.survival")
    public void survival(Player source, @Default("me") Player target) {
        mainUsage(source, GameMode.SURVIVAL, target);
    }
}

That's it! You've just created a fully-functional command with:

• ✅ Multiple aliases (/gamemode, /gm)
• ✅ Multiple shortcuts/root-aliases (/gmc, /gms)
• ✅ Tab completion for GameMode and online players
• ✅ Optional parameters with smart defaults
• ✅ Permission checking

@Command({"rank", "group"})
@Permission("server.rank")
@Description("Complete rank management system")
public class RankCommand {
    
    @Dependency
    private RankManager rankManager;
    
    @Usage
    public void help(CommandSource source, CommandHelp help) {
        help.display(source);  // Auto-generated help menu
    }
    
    @SubCommand("create")
    @Permission("server.rank.create")
    public void createRank(
            CommandSource source,
            @Named("name") String rankName,
            @Optional @Default("0") @Named("weight") int weight
    ) {
        Rank rank = rankManager.createRank(rankName, weight);
        source.reply("§aCreated rank: " + rank.getColoredName());
    }
    
    @SubCommand("delete")
    @Permission("server.rank.delete")
    public void deleteRank(
            CommandSource source,
            @Named("rank") Rank rank,  // Custom parameter type!
            @Switch("confirm") boolean confirm
    ) {
        if (!confirm) {
            source.error("§cAdd --confirm to delete this rank");
            return;
        }
        
        rankManager.deleteRank(rank);
        source.reply("§aDeleted rank: " + rank.getName());
    }
    
    @SubCommand("give")
    @Permission("server.rank.give")
    @Cooldown(value = 5, unit = TimeUnit.SECONDS)
    public void giveRank(
            CommandSource source,
            @Named("player") Player target,
            @Named("rank") Rank rank,
            @Optional @Named("duration") Duration duration
    ) {
        rankManager.setPlayerRank(target, rank, duration);
        source.reply("§aGave " + rank.getColoredName() + " §ato " + target.getName());
    }
}

• Sub-microsecond execution: 470ns median latency
• Linear O(n) scaling: Consistent performance even with deep command trees
• Minimal allocations: Optimized memory usage

• Annotations: Clean, declarative command structure
• Builder API: Dynamic command generation
• Mixed approach: Use both patterns in the same project

• Custom types: Register your own parameter types
• Validation: Built-in @Range, @Values, and custom validators
• Greedy parameters: @Greedy for multi-word inputs
• Flags & switches: --flag value and --switch support

• Hierarchical permissions: Command, subcommand, and parameter-level
• Auto Permission Assignment: Generate permission nodes automatically
• Custom permission checks: Implement complex permission logic

• Pre-processors: Validate, log, or modify before execution
• Post-processors: Handle results, logging, or cleanup
• Exception resolvers: Centralized error handling

We welcome contributions! Whether it's bug reports, feature requests, or pull requests.

Imperat is licensed under the MIT License.