# \ud83c\udfae BubbleCommand v2.0<\/p>\n
\n
\n<\/p>\n
**The Ultimate Custom Command Plugin for Lazy Server Owners! \ud83d\ude80**<\/p>\n
*Create powerful custom commands in minutes with zero coding knowledge!*<\/p>\n<\/div>\n
—<\/p>\n
## \ud83d\udcd6 Overview<\/p>\n
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!<\/p>\n
### \u2728 Why BubbleCommand?<\/p>\n
– \ud83c\udfaf **Zero Coding Required** – Everything is done through a simple config file
\n– \ud83d\ude80 **Super Easy to Use** – Copy, paste, edit. Done!
\n– \ud83d\udcaa **Production Ready** – Battle-tested with comprehensive error handling
\n– \ud83d\udd25 **Feature Rich** – Cooldowns, multi-actions, permissions, placeholders, and more
\n– \ud83d\udcda **Well Documented** – Tons of examples included in the config
\n– \ud83d\udd27 **Highly Flexible** – Create any command you can imagine
\n– \u26a1 **Performance Optimized** – Minimal server impact
\n– \ud83c\udfa8 **Modern Design** – Beautiful messages with color codes and titles<\/p>\n
—<\/p>\n
## \ud83c\udf1f Features<\/p>\n
### Core Features
\n– \u2705 **Custom Commands** – Create unlimited custom commands
\n– \u2705 **Command Aliases** – Add multiple aliases to any command
\n– \u2705 **Multi-Action Support** – Execute multiple actions per command
\n– \u2705 **Permission System** – Control who can use each command
\n– \u2705 **Cooldown System** – Prevent command spam with per-command cooldowns
\n– \u2705 **Player-Only Option** – Restrict commands to players only
\n– \u2705 **Console Commands** – Run commands with console permissions
\n– \u2705 **Hot Reload** – Reload config without restarting the server<\/p>\n
### Action Types
\n– \ud83c\udfae **Console Commands** – Execute commands as console
\n– \ud83d\udc64 **Player Commands** – Execute commands as player
\n– \ud83d\udcac **Messages** – Send colored messages to players
\n– \ud83d\udce2 **Broadcasts** – Broadcast messages to all online players
\n– \ud83d\udd0a **Sounds** – Play sounds to players
\n– \ud83d\udcfa **Titles** – Display titles and subtitles
\n– \ud83d\udcf1 **Actionbar** – Show actionbar messages<\/p>\n
### Placeholders
\n– `%player%` – Player’s name
\n– `%displayname%` – Player’s display name
\n– `%uuid%` – Player’s UUID
\n– `%world%` – Player’s current world
\n– `%x%`, `%y%`, `%z%` – Player’s coordinates
\n– `%health%` – Player’s health
\n– `%food%` – Player’s food level
\n– `%level%` – Player’s level
\n– `%exp%` – Player’s experience
\n– `%gamemode%` – Player’s gamemode
\n– `%sender%` – Command sender’s name
\n– `%arg0%`, `%arg1%`, etc. – Command arguments
\n– `%args%` – All arguments joined<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
### Requirements
\n– Minecraft Server: 1.19+ (Spigot, Paper, Purpur, or any fork)
\n– Java: 17 or higher<\/p>\n
### Steps<\/p>\n
1. **Download** the latest `BubbleCommand-x.x.x.jar`<\/p>\n
2. **Place** the JAR file in your server’s `plugins` folder<\/p>\n
3. **Restart** your server<\/p>\n
4. **Configure** your custom commands in `plugins\/BubbleCommand\/config.yml`<\/p>\n
5. **Reload** with `\/bubblecommand reload` (or restart)<\/p>\n
That’s it! \ud83c\udf89<\/p>\n
—<\/p>\n
## \ud83d\ude80 Quick Start<\/p>\n
### For the SUPER Lazy (30 seconds setup)<\/p>\n
1. Open `plugins\/BubbleCommand\/config.yml`
\n2. Find the `heal:` command example
\n3. Remove the `#` at the start of each line to uncomment it
\n4. Run `\/bubblecommand reload` in-game
\n5. Use `\/heal` command!<\/p>\n
### For the Slightly Less Lazy (2 minutes setup)<\/p>\n
Copy this template and add it to your config:<\/p>\n
“`yaml
\ncustom-commands:
\n mycommand:
\n aliases: [mc]
\n description: “My awesome command”
\n permission: “bubblecommand.mycommand”
\n player-only: true
\n cooldown: 60
\n actions:
\n – “message: &aHello, %player%!”
\n – “sound: ENTITY_PLAYER_LEVELUP”
\n“`<\/p>\n
Then:
\n1. Change `mycommand` to whatever you want
\n2. Edit the message
\n3. Save and run `\/bubblecommand reload`
\n4. Use your command!<\/p>\n
—<\/p>\n
## \ud83d\udcda Documentation<\/p>\n
### Basic Command Structure<\/p>\n
“`yaml
\ncustom-commands:
\n commandname: # The command name (use lowercase)
\n aliases: [alias1, alias2] # Optional command aliases
\n description: “Description” # Command description
\n permission: “perm.node” # Optional permission
\n player-only: true # true = players only, false = anyone
\n cooldown: 60 # Cooldown in seconds (0 = no cooldown)
\n actions: # List of actions to execute
\n – “action1”
\n – “action2”
\n“`<\/p>\n
### Action Types Explained<\/p>\n
#### 1. Console Commands
\nRun commands with console permissions (bypasses permission checks):
\n“`yaml
\nactions:
\n – “console: give %player% diamond 64”
\n – “console: tp %player% 0 100 0”
\n“`<\/p>\n
#### 2. Player Commands
\nRun commands as the player (respects permissions):
\n“`yaml
\nactions:
\n – “player: warp spawn”
\n – “player: home”
\n“`<\/p>\n
#### 3. Messages
\nSend colored messages to the player:
\n“`yaml
\nactions:
\n – “message: &a&lSUCCESS! &7You did it!”
\n – “message: &cError: Invalid command!”
\n“`<\/p>\n
#### 4. Broadcasts
\nBroadcast to all online players:
\n“`yaml
\nactions:
\n – “broadcast: &6[Server] &e%player% &7just did something cool!”
\n“`<\/p>\n
#### 5. Sounds
\nPlay sounds to the player:
\n“`yaml
\nactions:
\n – “sound: ENTITY_PLAYER_LEVELUP”
\n – “sound: BLOCK_NOTE_BLOCK_PLING”
\n – “sound: UI_TOAST_CHALLENGE_COMPLETE”
\n“`<\/p>\n
#### 6. Titles
\nDisplay title and subtitle:
\n“`yaml
\nactions:
\n – “title: &6Welcome!|&eEnjoy your stay|10|70|20”
\n # Format: title|subtitle|fadeIn|stay|fadeOut (times in ticks)
\n“`<\/p>\n
#### 7. Actionbar
\nShow actionbar message:
\n“`yaml
\nactions:
\n – “actionbar: &eYou received a reward!”
\n“`<\/p>\n
### Real-World Examples<\/p>\n
#### Example 1: Heal Command
\n“`yaml
\nheal:
\n aliases: [h]
\n description: “Heal yourself to full health”
\n permission: “bubblecommand.heal”
\n player-only: true
\n cooldown: 60
\n actions:
\n – “console: effect give %player% minecraft:instant_health 1 10”
\n – “console: effect give %player% minecraft:saturation 1 10”
\n – “message: &a&lHEALED! &7You have been healed to full health!”
\n – “sound: ENTITY_PLAYER_LEVELUP”
\n“`<\/p>\n
#### Example 2: Starter Kit
\n“`yaml
\nstarterkit:
\n aliases: [kit, starter]
\n description: “Get a starter kit”
\n permission: “bubblecommand.kit.starter”
\n player-only: true
\n cooldown: 86400 # 24 hours
\n actions:
\n – “console: give %player% minecraft:iron_sword 1”
\n – “console: give %player% minecraft:iron_pickaxe 1”
\n – “console: give %player% minecraft:cooked_beef 32”
\n – “message: &e&lSTARTER KIT! &7You received your starter items!”
\n – “title: &6Welcome!|&eEnjoy your kit|10|40|10”
\n – “sound: ENTITY_PLAYER_LEVELUP”
\n“`<\/p>\n
#### Example 3: Report Command
\n“`yaml
\nreport:
\n aliases: []
\n description: “Report a player”
\n permission: “bubblecommand.report”
\n player-only: true
\n cooldown: 300 # 5 minutes
\n actions:
\n – “console: execute as @a[permission=bubblecommand.staff] run tellraw @s {“text”:”[REPORT] %player% reported: %args%”,”color”:”red”}”
\n – “message: &c&lREPORT SENT! &7Thank you for reporting.”
\n – “sound: BLOCK_NOTE_BLOCK_PLING”
\n“`<\/p>\n
#### Example 4: Broadcast Command
\n“`yaml
\nannounce:
\n aliases: [broadcast, bc]
\n description: “Broadcast a message”
\n permission: “bubblecommand.broadcast”
\n player-only: false
\n actions:
\n – “broadcast: &6&l[ANNOUNCEMENT] &e%args%”
\n – “sound: BLOCK_NOTE_BLOCK_PLING”
\n“`<\/p>\n
### Color Codes<\/p>\n
Use `&` for color codes in messages:<\/p>\n
| Code | Color | Code | Format |
\n|——|——-|——|——–|
\n| `&0` | Black | `&l` | **Bold** |
\n| `&1` | Dark Blue | `&m` | ~~Strikethrough~~ |
\n| `&2` | Dark Green | `&n` | Underline<\/u> |
\n| `&3` | Dark Aqua | `&o` | *Italic* |
\n| `&4` | Dark Red | `&r` | Reset |
\n| `&5` | Dark Purple | | |
\n| `&6` | Gold | | |
\n| `&7` | Gray | | |
\n| `&8` | Dark Gray | | |
\n| `&9` | Blue | | |
\n| `&a` | Green | | |
\n| `&b` | Aqua | | |
\n| `&c` | Red | | |
\n| `&d` | Light Purple | | |
\n| `&e` | Yellow | | |
\n| `&f` | White | | |<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands & Permissions<\/p>\n
### Main Commands<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/bubblecommand` | Show plugin information | – |
\n| `\/bubblecommand reload` | Reload configuration | `bubblecommand.admin` |
\n| `\/bcommand` | Alias for bubblecommand | – |
\n| `\/bc` | Alias for bubblecommand | – |<\/p>\n
### Permissions<\/p>\n
| Permission | Description | Default |
\n|————|————-|———|
\n| `bubblecommand.*` | All permissions | op |
\n| `bubblecommand.admin` | Admin commands (reload) | op |
\n| `bubblecommand.use` | Basic command usage | true |<\/p>\n
Custom commands use their own permissions as defined in config.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### General Settings<\/p>\n
“`yaml
\nsettings:
\n debug: false # Enable debug messages in console
\n default-permission: “” # Default permission for all commands
\n save-data: true # Save player data (cooldowns)
\n cooldown-message: “&cYou must wait %time% seconds before using this command again!”
\n no-permission-message: “&cYou don’t have permission to use this command!”
\n player-only-message: “&cThis command can only be used by players!”
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udd27 Advanced Features<\/p>\n
### Multiple Actions
\nExecute multiple actions in sequence:
\n“`yaml
\nactions:
\n – “message: &eStarting teleport…”
\n – “sound: BLOCK_NOTE_BLOCK_PLING”
\n – “console: tp %player% 0 100 0”
\n – “message: &aTeleported!”
\n“`<\/p>\n
### Command Arguments
\nUse arguments in your commands:
\n“`yaml
\ngivemoney:
\n actions:
\n – “console: eco give %arg0% %arg1%”
\n – “message: &aGave &e$%arg1% &ato &e%arg0%”
\n# Usage: \/givemoney PlayerName 1000
\n“`<\/p>\n
### Conditional Execution
\nUse player placeholders for dynamic commands:
\n“`yaml
\nhometp:
\n actions:
\n – “player: home %arg0%”
\n – “message: &aTeleporting to %arg0%’s home…”
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udcca Performance<\/p>\n
BubbleCommand is designed for production environments:<\/p>\n
– \u2705 **Async cooldown saves** – No server lag
\n– \u2705 **Concurrent hashmap** – Thread-safe cooldowns
\n– \u2705 **Minimal memory footprint** – Only stores active cooldowns
\n– \u2705 **Efficient command registration** – Smart dynamic registration
\n– \u2705 **Optimized placeholder replacement** – Fast text processing<\/p>\n
—<\/p>\n
## \ud83d\udc1b Troubleshooting<\/p>\n
### Common Issues<\/p>\n
**Q: My command doesn’t work!**
\n– Make sure you removed the `#` to uncomment the command
\n– Check for proper YAML indentation (use spaces, not tabs)
\n– Verify the command name doesn’t conflict with existing commands
\n– Run `\/bubblecommand reload` after making changes<\/p>\n
**Q: Cooldown isn’t working!**
\n– Ensure `save-data: true` in settings
\n– Check file permissions on `data.yml`
\n– Cooldown only applies to players, not console<\/p>\n
**Q: Colors aren’t showing!**
\n– Use `&` not `\u00a7` for color codes
\n– Make sure the text is in quotes if it contains special characters<\/p>\n
**Q: Command says “Unknown command”!**
\n– Run `\/bubblecommand reload` after editing config
\n– Check console for errors during reload
\n– Verify YAML syntax is correct (use online YAML validator)<\/p>\n
—<\/p>\n
## \ud83d\udcdd Tips & Tricks<\/p>\n
### Best Practices<\/p>\n
1. **Test commands** before giving them to players
\n2. **Use cooldowns** to prevent spam
\n3. **Add permissions** to control access
\n4. **Use descriptive names** for easy management
\n5. **Comment your config** to remember what commands do
\n6. **Backup your config** before major changes<\/p>\n
### Pro Tips<\/p>\n
– Use `console:` for commands that need admin permissions
\n– Chain multiple actions for complex commands
\n– Use sounds for better user feedback
\n– Combine titles with messages for important notifications
\n– Use placeholders to make commands dynamic
\n– Set appropriate cooldowns based on command power<\/p>\n
—<\/p>\n
## \ud83d\udcdc License<\/p>\n
BubbleCommand is licensed under the MIT License.<\/p>\n
—<\/p>\n
**Made with \u2764\ufe0f for the Minecraft community**<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
A powerful and easy-to-use custom command creation plugin for server.<\/p>\n","protected":false},"featured_media":35301,"template":"","meta":{"_minecraft_slug":"bubblecommand","_minecraft_project_id":"WlRi06Jw","_minecraft_author":"ethan08921","_minecraft_license":"MIT","_minecraft_downloads":112,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bubblecommand.zip","_minecraft_size_bytes":65796,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T19:30:27.015667Z","_minecraft_date_created":"2025-12-17T23:24:27.152220Z","_minecraft_date_modified":"2026-04-17T10:30:43.106437Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bubblecommand","_minecraft_icon_attachment_id":35301,"_minecraft_imported_at":"2026-06-01T17:05:34+00:00","_minecraft_import_hash":"6cf77762db77a2f2756ee38b7f95e0ff","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,91,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-35300","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n