HoleFiller

HoleFiller Plugin

HoleFiller is a lightweight and powerful Minecraft Paper plugin designed to help players easily fill areas, caves, and holes in survival mode without replacing existing blocks. Instead of tedious manual placement, players can select two points and let the plugin do the work!

✨ Features

- Multi-Language Support: Players must have the required blocks in their inventory. Blocks are consumed upon placement. (Completely free in Creative Mode). - Multi-Language Support: Use a Clock to right-click and left-click to define your area. Visual flame particles will display a 3D bounding box outlining your selection in real-time. - Multi-Language Support: The plugin only replaces air, water, lava, and grass. It will Multi-Language Support overwrite solid blocks or buildings that are already placed. - Multi-Language Support: Opens a visual menu (`/fillarea`) allowing players to choose whether they want to generate a Multi-Language Support, a Multi-Language Support, a Multi-Language Support, or a Multi-Language Support. They then click the block they want to use from their own inventory. - Multi-Language Support: Blocks are placed progressively over time (e.g., 500 blocks per tick) to prevent server crashes or lag spikes on massive selections. - Multi-Language Support: Made a mistake? Use `/fillundo` to instantly revert your last action and get your blocks refunded! The plugin has anti-duplication checks to ensure players cannot exploit the refund system. - Multi-Language Support: Connected textures like Fences, Glass Panes, and Walls automatically connect to adjacent blocks. Block orientation (like Stairs or Logs) automatically aligns with the player's rotation when executing the command. - Multi-Language Support: Fully translatable configurations, natively supporting English, French, Spanish, and German.

🛠️ Commands

* `/fillarea` - Opens the interactive GUI to select the shape and material for the filled area. (Requires an active selection). * `/fillundo` - Reverts your last fill action and refunds the blocks safely to your inventory. * `/filllang <en|fr|es|de>` - Admin command to change the plugin's active language directly in-game without restarting. * `/fillconfig <setting> <value>` - Admin command to change `config.yml` variables in-game dynamically (e.g., `/fillconfig max_blocks 100000`). Supported options are `max_blocks`, `blocks_per_tick`, and `OnlyForOp`.

🔑 Permissions

* `holefiller.use` - Allows a player to use the selection clock, `/fillarea`, and `/fillundo`. * `holefiller.admin` - Allows an admin to use `/filllang` and `/fillconfig`.

*(Note: If `OnlyForOp` is set to `true` in the config, permissions are bypassed and only Server Operators can use the plugin).*

⚙️ Configuration (`config.yml`)

The `config.yml` file is automatically generated and contains the following parameters: * `lang`: Sets the default language of the plugin. Native options: `en`, `fr`, `es`, `de`. (Default: `en`). * `OnlyForOp`: If set to `true`, only server Operators (OPs) can use the selection tools and commands, regardless of standard permission nodes. (Default: `true`). * `max_blocks`: The maximum number of blocks a player can modify in a single operation. Prevents players from selecting the entire map by accident. (Default: `50000`). * `blocks_per_tick`: The number of blocks placed per server tick (1/20th of a second) during a fill operation. Lower this value if your server experiences lag during large fills. (Default: `500`).

📖 How to Use

1. Hold a Right-Click in your main hand. 2. Right-Click a block to set Position 1. 3. Right-Click a block to set Position 2. (A fiery outline box will appear around your selection). 4. Type `/fillarea` to open the GUI. 5. Click on the gray glass to choose your desired shape (Cube, Sphere, Hollow Cube, Hollow Sphere). 6. Click on the block in your *player inventory* (bottom section of the GUI) that you want to use to fill the area. 7. The plugin will calculate the required blocks, consume them from your inventory, and begin filling progressively! 8. If you made a mistake, type `/fillundo` immediately to revert the terrain and get your blocks back.