OrjusHummer

HummerExcavator Plugin

HummerExcavator is a powerful Paper/Spigot plugin for Minecraft 1.21+ that adds custom mining enchantments: Excavator and Magnet. It features a robust system for managing custom items, localized configuration, and grindstone integration.

Features

1. Custom Enchantments

Excavator (Levels 1-5)*: * Mines a defined area of blocks around the target block. Level 1*: 3x3x1 Level 2*: 3x3x2 Level 3*: 5x5x1 Level 4*: 5x5x2 Level 5*: 5x5x3 Grindstone Safety*: Excavator cannot be removed by the Grindstone. It will persist on the tool. Magnet*: * Automatically teleports mined blocks directly into the player's inventory. * Works seamlessly with Excavator area mining. Grindstone Removal*: Can be removed via the Grindstone (unlike Excavator).

2. Item Management System

* Save custom tools with their enchantments, names, and lore to a SQLite database. * Give saved items to players via command. * List and delete saved items.

3. Fully Configurable

Message Localization*: All chat messages are configurable in config.yml. Lore Customization*: Define exactly how enchantments look in the item lore (Names, Descriptions, Colors). Colors*: Supports modern hex colors and legacy ampersand codes (e.g., &7, &a).

Commands & Permissions

Core Commands

| Command | Description | Permission | |Str|Str|Str| | /hm givebook <player> <type> <level> | Give an enchantment book (excavator/magnet). | excavator.give | | /hm save <name> | Save the item currently in your main hand. | excavator.admin | | /hm give <name> <player> | Give a previously saved item to a player. | excavator.admin | | /hm delete <name> | Delete a saved item from the database. | excavator.admin | | /hm list | List all saved items. | excavator.admin | | /hm reload | Reload the config.yml file. | excavator.admin |

Permissions

* excavator.use: Allows using the enchantments (default: true). * excavator.give: Allows giving books (default: op). * excavator.admin: Admin access to item management and reload (default: op).

Installation

1. Download the HummerExcavator.jar. 2. Place it in your server's plugins folder. 3. Restart the server. 4. (Optional) Edit plugins/HummerExcavator/config.yml to customize messages.

Configuration (Default English)

<details> <summary>Spoiler</summary>

yaml messages: prefix: "&e[Hummer] " no_permission: "&cYou do not have permission." # ... (and more) enchantments: excavator: name: "&7Excavator" levels: 1: - "&8Area: &a3x3x1" # ... magnet: name: "&7Magnet" description: - "&8All drops go to &ainventory"

</details>