VClickBlockCommand

# 🏗️ V-ClickBlockCommand (https://img.shields.io/badge/Minecraft-1.21.1+-3D85C6?style=flat-square&logo=minecraft&logoColor=white)](https://papermc.io) (https://img.shields.io/badge/Java-21-ED8B00?style=flat-square&logo=openjdk&logoColor=white)](https://openjdk.org) (https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](LICENSE) Transform any block into a powerful command executor! V-ClickBlockCommand lets server operators bind custom commands to in-game blocks with a simple click. --- ## ✨ Features - 🏗️ **Easy Block Registration** — Bind commands to any block with a simple click - ⬆️ **Multiple Commands** — Add unlimited commands to a single block - ⬇️ **Flexible Execution** — Run as console (`-c`) or player (`-p`) - ⚡ **Zero Lag** — Optimized for high-performance servers - 🎨 **Fully Configurable** — Cooldowns, messages, trigger actions & more - 🔒 **Secure Permissions** — Granular permission control for all operations - 🔄 **Hot Reload** — Reload configs without server restart --- ## 📦 Installation 1. Download `V-ClickBlockCommand.jar` 2. Drop into `plugins/` folder 3. Restart server 4. Edit `plugins/V-ClickBlockCommand/config.yml` to customize --- ## ⌨️ Commands | Command | Description | Permission | |---------|-------------|------------| | `/ClickBlockCommand create <name>` | Enter registration mode and click a block to bind | `vcbc.create` | | `/ClickBlockCommand addcmd <name> <-c\|-p> <command...>` | Add command to block (`-c`=console, `-p`=player) | `vcbc.addcmd` | | `/ClickBlockCommand removecmd <name> <cmd-id\|allcmd>` | Remove specific or all commands from block | `vcbc.removecmd` | | `/ClickBlockCommand delete <name>` | Delete block command entry entirely | `vcbc.delete` | | `/ClickBlockCommand list` | Show all registered block commands | `vcbc.list` | | `/ClickBlockCommand info <name>` | Show details for specific block command | `vcbc.info` | | `/ClickBlockCommand reload` | Reload configuration and block data | `vcbc.reload` | > **Aliases:** `/cbc` (shorthand for all commands) --- ## 🔒 Permissions | Permission | Description | Default | |------------|-------------|---------| | `vcbc.*` | Grants all plugin permissions | op | | `vcbc.create` | Create new block bindings | op | | `vcbc.addcmd` | Add commands to blocks | op | | `vcbc.removecmd` | Remove commands from blocks | op | | `vcbc.delete` | Delete block entries | op | | `vcbc.list` | List all block commands | op | | `vcbc.info` | View block details | op | | `vcbc.reload` | Reload plugin configs | op | --- ## ⚙️ Configuration ```yaml # ═══════════════════════════════════════════════════ # V-ClickBlockCommand Configuration # ═══════════════════════════════════════════════════ # ⏱️ Cooldown between block clicks (seconds) cooldown: 3 # 🖱️ Trigger action: RIGHT_CLICK, LEFT_CLICK, or BOTH trigger-action: RIGHT_CLICK # 🚫 Cancel default block interaction (true/false) cancel-interaction: true # 📊 Show cooldown on action bar cooldown-actionbar: true # 💬 Message prefix (supports & color codes) prefix: "&8 &r" # 📝 Messages (placeholders: {player}, {block}, {name}, {remaining}) messages: create-success: "&aBlock &b{name} &acreated successfully!" addcmd-success: "&aCommand added to &b{name}&a!" cooldown-wait: "&cWait &e{remaining} &cseconds before clicking again." no-permission: "&cYou don't have permission to use this command." reload-success: "&aConfiguration reloaded!" ``` --- ## 💾 Data Storage Block bindings are stored in `blocks.yml` inside the plugin folder. Data persists across server restarts and reloads. ---