BubbleCommand

# 🎮 BubbleCommand v2.0 <div align="center"> !(https://img.shields.io/badge/version-2.0.0-blue.svg) !(https://img.shields.io/badge/minecraft-1.19+-green.svg) !(https://img.shields.io/badge/license-MIT-yellow.svg) **The Ultimate Custom Command Plugin for Lazy Server Owners! 🚀** *Create powerful custom commands in minutes with zero coding knowledge!* </div> --- ## 📖 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 - 📚 **Well Documented** - Tons of examples included in the config - 🔧 **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-x.x.x.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: 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! --- ## 📚 Documentation ### Basic Command Structure ```yaml custom-commands: commandname: # The command name (use lowercase) aliases: # Optional command aliases description: "Description" # Command description permission: "perm.node" # Optional permission player-only: true # true = players only, false = anyone cooldown: 60 # Cooldown in seconds (0 = no cooldown) actions: # List of actions to execute - "action1" - "action2" ``` ### Action Types Explained #### 1. Console Commands Run commands with console permissions (bypasses permission checks): ```yaml actions: - "console: give %player% diamond 64" - "console: tp %player% 0 100 0" ``` #### 2. Player Commands Run commands as the player (respects permissions): ```yaml actions: - "player: warp spawn" - "player: home" ``` #### 3. Messages Send colored messages to the player: ```yaml actions: - "message: &a&lSUCCESS! &7You did it!" - "message: &cError: Invalid command!" ``` #### 4. Broadcasts Broadcast to all online players: ```yaml actions: - "broadcast: