BubbleCommand

The Ultimate Custom Command Plugin for the best Servers!

Create powerful custom commands in minutes with zero coding knowledge!

Overview

BubbleCommand is a powerful yet incredibly simple Spigot/Paper/Purpur plugin that lets you create custom commands using just a config file. Perfect for server owners who want to add custom functionality without writing a single line of code!

✨ Why BubbleCommand?

- Zero Coding Required - Everything is done through a simple config file
- Super Easy to Use - Copy, paste, edit. Done!
- Production Ready - Battle-tested with comprehensive error handling
- Feature Rich - Cooldowns, multi-actions, permissions, placeholders, and more
- Highly Flexible - Create any command you can imagine
- ⚡ Performance Optimized - Minimal server impact
- Modern Design - Beautiful messages with color codes and titles


Features

Core Features
- ✅ Custom Commands - Create unlimited custom commands
- ✅ Command Aliases - Add multiple aliases to any command
- ✅ Multi- Action Support - Execute multiple actions per command
- ✅ Permission System - Control who can use each command
- ✅ Cooldown System - Prevent command spam with per-command cooldowns
- ✅ Player- Only Option - Restrict commands to players only
- ✅ Console Commands - Run commands with console permissions
- ✅ Hot Reload - Reload config without restarting the server

Action Types
- Console Commands - Execute commands as console
- Player Commands - Execute commands as player
- Messages - Send colored messages to players
- Broadcasts - Broadcast messages to all online players
- Sounds - Play sounds to players
- Titles - Display titles and subtitles
- Actionbar - Show actionbar messages

Placeholders
- `%player%` - Player's name
- `%displayname%` - Player's display name
- `%uuid%` - Player's UUID
- `%world%` - Player's current world
- `%x%`, `%y%`, `%z%` - Player's coordinates
- `%health%` - Player's health
- `%food%` - Player's food level
- `%level%` - Player's level
- `%exp%` - Player's experience
- `%gamemode%` - Player's gamemode
- `%sender%` - Command sender's name
- `%arg0%`, `%arg1%`, etc. - Command arguments
- `%args%` - All arguments joined

---

Installation

Requirements:
- Minecraft Server: 1.19+ (Spigot, Paper, Purpur, or any fork)
- Java: 17 or higher

Steps:

1. Download the latest `BubbleCommand-2.0.0.jar`
2. Place the JAR file in your server's `plugins` folder
3. Restart your server
4. Configure your custom commands in `plugins/BubbleCommand/config.yml`
5. Reload with `/bubblecommand reload` (or restart)

That's it!


Quick Start

For the SUPER Lazy (30 seconds setup)

1. Open `plugins/BubbleCommand/config.yml`
2. Find the `heal:` command example
3. Remove the `#` at the start of each line to uncomment it
4. Run `/bubblecommand reload` in-game
5. Use `/heal` command!

For the Slightly Less Lazy (2 minutes setup)

Copy this template and add it to your config:

yaml
custom-commands:
mycommand:
aliases: [mc]
description: "My awesome command"
permission: "bubblecommand.mycommand"
player-only: true
cooldown: 60
actions:
- "message: &aHello, %player%!"
- "sound: ENTITY_PLAYER_LEVELUP"

Then:
1. Change `mycommand` to whatever you want
2. Edit the message
3. Save and run `/bubblecommand reload`
4. Use your command!

Performance

BubbleCommand is designed for production environments:

- ✅ Async cooldown saves - No server lag
- ✅ Concurrent hashmap - Thread-safe cooldowns
- ✅ Minimal memory footprint - Only stores active cooldowns
- ✅ Efficient command registration - Smart dynamic registration
- ✅ Optimized placeholder replacement - Fast text processing