Github | Discord

# DuraBlock - Custom Block Durability Plugin **DuraBlock** is a Minecraft plugin, inspired by the Metin Stones from Metin2, that allows server owners to create custom blocks with configurable durabilities. Players can race to break these blocks and earn rewards! ## 🌟 Features * **Custom Blocks with Durability:** Set how many times a block needs to be hit before breaking. * **Holograms:** Display custom holograms above blocks, both when active and inactive. * **Permission Support:** Specify permissions required to break each block. * **Sound and Broadcast Events:** Play a sound and broadcast a message when a block is broken. * **Reward System:** Give rewards with customizable chances when a block is broken. * **Automatic Block Restoration:** Blocks automatically reappear after a configurable interval. * **Custom Textures Support:** You can add custom blocks from plugins like ItemsAdder, Nexo and Oraxen. * **MiniMessage Support:** DuraBlock supports MiniMessage for rich text formatting in config and language files.

## 📦 Requirements * Java 17 or higher * Minecraft 1.19 or higher * PaperMC or a fork (e.g., Purpur) * [DecentHolograms Plugin](https://modrinth.com/plugin/decentholograms) ## 🛠️ Installation 1. Download the latest release of DuraBlock. 2. Place the `.jar` file in your server's `plugins` folder. 3. Restart the server to generate the default configuration. 4. Edit the `config.yml` to customize your blocks. 5. Reload the plugin `/durablock reload` to apply changes. ## 🌍 Language Support * The plugin supports two languages by default: * **en\_us** (English) * **tr\_tr** (Turkish) * You can create your own language file by creating a `lang.yml` file in the `languages` directory. ## 📝 Default Configuration

Click to view config.yml

```yaml language: en_us prefix: "<#874CCC>DuraBlock » " blocks: test-block: durability: 20 # Time in seconds before the block gets restored after being broken restore-interval: 30 # Vertical offset for the hologram above the block (in blocks)# y-level: 2 # Permission required to break this block permission: durablock.break.test-block # Text lines displayed in the hologram when the block is active/enabled # Refer to the DecentHolograms wiki for formatting and color options: # https://wiki.decentholograms.eu/general/format-and-colors/ enabled-hologram-lines: - "<#6DE1D2>Test Block" - "<#FF0000>Durability: {durability}" # Text lines displayed in the hologram when the block is disabled disabled-hologram-lines: - "Disabled for now." - "Will be activated in: <#FFA725>{restore}" - "Broken by: <#FFA725>{last_player}" # List of commands executed with a certain probability when the block's durability is above 0 rewards: - command: "give {player} diamond 1" chance: 0.1 # %10 chance - command: "give {player} emerald 2" chance: 0.3 # %30 chance # Actions to perform when the block is broken on-break: sound: enabled: true # https://minecraft.wiki/w/Sounds.json/Java_Edition_values for sound list sound-type: "minecraft:entity.player.levelup" # Whether the sound should play for everyone or only the player who broke it play-to-everyone: true broadcast: enabled: true # Message broadcast to all players when the block is broken message: "{player} broke the test-block" # Commands executed when the block is broken commands: - "give {player} diamond 16" # Warning: Adjusting these values may impact server performance or cause unexpected behavior. # Only change them if you understand the potential consequences. # Interval for updating hologram (in seconds) hologram-update-interval: 1 # Interval for checking if blocks needs to be enabled (in seconds) block-restore-interval: 1 ```

## 🚀 Usage * Create custom blocks by adding them to the `config.yml` file. * Customize block durability, holograms, sounds, and rewards. * Use permissions to control who can break specific blocks. ## 📜 Commands and Permissions | Command | Description | | -------------------------------- | --------------------------------------------------- | | `/durablock reload` | Reloads the configuration | | `/durablock add ` | Adds a new custom block of the specified type | | `/durablock list` | Lists all configured custom blocks | | `/durablock remove ` | Removes a specific custom block by ID | | `/durablock restore ` | Manually restores a block by ID | | `/durablock info` | Displays information about the plugin | | Permission | Description | | ------------------------------ | ---------------------------------------- | | `durablock.commands.main` | Allows using /durablock command | | `durablock.notify.update` | Allows receiving update notifications | ## 💡 Placeholders ### Hologram Placeholders * `{last_player}` - Displays the name of the player who last broke the block. * `{restore}` - Displays the remaining time (in seconds) until the block is restored. * `{durability}` - Shows the current durability of the block. ### Command Placeholders * `{player}` - Represents the name of the player who broke the block. ## 💡 Examples To create a new block named "diamond-block" with 50 durability and a 20-second restore time, add this to your `config.yml`: ```yaml blocks: diamond-block: durability: 50 restore-interval: 20 permission: durablock.break.diamond-block enabled-hologram-lines: - "Diamond Block - {durability} hits left" disabled-hologram-lines: - "Regenerating in: {restore} seconds" rewards: - command: "give {player} diamond 1" chance: 0.1 # %10 chance on-break: sound: enabled: true sound-type: "minecraft:entity.player.levelup" play-to-everyone: true broadcast: enabled: true message: "{player} broke the diamond block and earned 16 diamonds!" commands: - "give {player} diamond 16" ``` ## 💬 Support If you encounter any issues or have feature suggestions, feel free to open an issue on GitHub or join my [Discord Server](https://discord.gg/p3PbC4afzV). ## 📝 License This project is licensed under the MIT License - see the [LICENSE.md](https://raw.githubusercontent.com/hakanyurtoglu/DuraBlock/refs/heads/master/LICENSE) file for details. Enjoy making your server more dynamic with DuraBlock!

DuraBlock

Compatibility

Minecraft: Java Edition

Platforms

Links

Creators

Details