xHubBlocks

# 🧱 xHubBlocks V2 ### The Ultimate Lobby Practice Plugin **Infinite blocks. Auto-despawn. Database support.** !(https://img.shields.io/badge/Version-2.0.0-blue?style=for-the-badge) !(https://img.shields.io/badge/Minecraft-1.8.8%2B-green?style=for-the-badge) !(https://img.shields.io/badge/Storage-H2%20%7C%20MySQL-orange?style=for-the-badge) __UPDATE COMING SOON!__ --- ## 👋 Overview **xHubBlocks** is a lightweight but powerful plugin designed for Hubs and Lobbies. It gives your players an infinite stack of blocks to practice bridging, clutching, or building while waiting in the lobby. The best part? **The blocks disappear automatically** after a configurable time, keeping your lobby clean and lag-free. ### 🔥 What's New in V2? We have completely rewritten the core to include professional features: * **Persistent Data:** Blocks placed statistics are now saved forever. * **Database Support:** Built-in support for **H2** (local, no setup) and **MySQL** (for networks). * **Developer API:** Hook your own plugins into xHubBlocks. * **High Performance:** Powered by HikariCP for database connections. --- ## ✨ Features * **♾️ Infinite Items:** Players get a stack of blocks that never runs out. * **✨ Auto-Despawn:** Blocks vanish after X seconds with a satisfying particle effect. * **🔒 Secure:** Prevents players from dropping the block or moving it in their inventory. * **🎨 Fully Configurable:** Customize the material, name, lore, slot, and messages. * **📊 PlaceholderAPI:** Display stats on scoreboards or holograms. * **⚡ Legacy Support:** Works flawlessly from **1.8.8** up to the latest versions. --- ## 💾 Database & Storage xHubBlocks V2 supports two storage types defined in `config.yml`: 1. **H2 (Default):** Zero configuration required. Stores data in a local file. Perfect for single servers. 2. **MySQL:** Connect to an external database. Ideal for networks or if you want to display stats on a website. ```yaml storage: type: H2 # Or MYSQL mysql: host: "localhost" port: 3306 database: "xhubblocks" # ... ``` ## 🏀Images !(https://cdn.modrinth.com/data/cached_images/3972395f3d9668faad9007f5efc7a08253cde970_0.webp) !(https://cdn.modrinth.com/data/cached_images/6d47fe68dd224937901ca1748e3a8c9dbe87c37d.png) !(https://cdn.modrinth.com/data/cached_images/da50f9588ac8f7219c1eb34759146fd7b31506ca.png) --- ## 🚀 Commands & Permissions *The commands are editable.* | Command | Permission | Description | | :--- | :--- | :--- | | `/xhubblocks` | `xhubblocks.admin` | View plugin info and help. | | `/xhubblocks reload` | `xhubblocks.reload` | Reload the configuration file. | | `/blocks shop` | `editable` | Block store. | --- ## 📊 Placeholders Requires **PlaceholderAPI**. * `%xhubblocks_placed_player%` - Total blocks placed by the player (Saved in DB). * `%xhubblocks_placed_session%` - Blocks placed in the current session. * `%xhubblocks_placed_total%` - Total blocks placed by everyone on the server. --- ## 👨‍💻 Developer API Want to use xHubBlocks stats in your own plugin? It's easy. **1. Get the instance:** ```java if (Bukkit.getPluginManager().getPlugin("xHubBlocks") != null) { xHubBlocksAPI api = xHubBlocksAPI.getApi(); // Get stats int total = api.getPlayerTotalPlaced(player.getUniqueId()); } ``` **2. Maven/Gradle:** You can add the plugin as a dependency to your project. --- ## 📥 Installation 1. Download `xHubBlocks.jar`. 2. Drop it into your server's `plugins` folder. 3. Restart your server. 4. (Optional) Edit `config.yml` to change the block style or database settings. 5. Enjoy! !(https://cdn.modrinth.com/data/cached_images/108319d581434f2a2c3f01f2e6139bdba5b54200_0.webp) <br> <p align="center"> Created with ❤️ by <strong>xPlugins</strong> </p>