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)

```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>