FrozenTools

!(https://cdn.modrinth.com/data/cached_images/a61d23e1dcbab26afb7b9c864c13f83d6d8c7a26_0.webp)

# 🔧 FrozenTools

> Special admin tools with active-usage self-destruction timers. > Give your players powerful limited-use tools that automatically destroy themselves after real active use — not real time.

## ✨ What Makes FrozenTools Different?

Most timed tools use a real-time countdown — the tool expires whether the player uses it or not. FrozenTools tracks active usage time only. The timer pauses when the player is idle, switches slots, or logs off. Players only burn their time while actually using the tool.

## 🛠️ The Tools

### 🔵 Frozen Drill > Netherite Pickaxe · Efficiency V · Unbreaking III · Mending I

Mines a 3×3 area of blocks in a single break. The mining plane automatically adapts to the direction the player is facing — vertical, horizontal, or diagonal.

• Breaks up to 9 blocks at once
• Face-aware: mines the correct plane based on player look direction
• Configurable block blacklist (Bedrock, Barrier, Command Blocks, etc. are blocked by default)
• Particle effects on each break

### 🌲 Frozen Chopper > Netherite Axe · Efficiency V · Unbreaking III · Mending I · Silk Touch I

Chops an entire tree with a single block break using a BFS flood-fill algorithm. Supports every wood type in Minecraft.

• Breaks up to 500 logs in one swing
• Supports all wood types: Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Mangrove, Cherry, Pale Oak, Bamboo, Crimson, Warped — including all stripped variants
• Particle effects cascade across the entire felled tree

### 💧 Frozen Bucket > Bucket · 100 drain charges per fill

A two-stage bucket that collects and mass-drains liquids.

Stage 1 — Empty: Right-click a Water or Lava source to fill it (grants 100 charges).

Stage 2 — Filled: Right-click any block to drain a 3×3×3 cube (27 blocks) of the stored liquid in one action. Costs 1 charge per use.

• Charge count shown live in item lore: `Charges: 72 / 100 (Water)`
• Auto-resets to empty state at 0 charges
• Supports Water and Lava

### 🟤 Frozen Shovel > Netherite Shovel · Efficiency V · Unbreaking III · Mending I

Clears a 3×3 area of soft blocks in a single dig. Like the Drill, the digging plane adapts to the player's facing direction.

• Breaks up to 9 soft blocks at once
• Only targets soft blocks — won't accidentally dig through stone or ores
• Default allowed blocks: Sand, Gravel, Dirt, Grass, Podzol, Mycelium, Clay, Snow, Soul Sand, Soul Soil, Mud, Coarse Dirt and more
• Fully configurable allowed-blocks list

## ⏳ Self-Destruct System

Every tool has an active usage timer set at the time of giving. When it runs out, the tool destroys itself with a sound and message.

Key design — active time only: - Timer counts only while the player is actively breaking blocks or using the tool - Pauses automatically when idle, switching hotbar slots, swapping hands, or logging off - The remaining time is always visible in the item lore: `Self Destruct: 23h 59m` - Configurable 60-minute warning message when time is running low

This means a `1d` tool lasts one full day of active use, not one real-life day.

## ⚙️ Configuration

```yaml # Self-Destruct behaviour self-destruct: idle-pause-seconds: 3 # Seconds idle before timer pauses notify-expiry-warning: true # Warn the player when time is low warning-threshold-minutes: 60 # How early to warn (default: 1 hour left) play-expire-sound: true

# Disable tools in specific worlds worlds: blacklisted: - spawn - lobby - duels - afk

# Optional MySQL backup (NBT is primary storage) database: enabled: false host: localhost port: 3306 database: frozentools username: root password: "" ```

Each tool's material, gradient colours, enchantments, description line, and behaviour are all fully configurable in `config.yml`.

## 📋 Commands

| Command | Description | |---|---| | `/tools give ` | Give a tool to a player | | `/ft give ...` | Short alias | | `/frozentools give ...` | Full alias |

Duration format: `1d`, `12h`, `30m` or combined — `1d12h30m`

Examples: ``` /tools give DrFrozenXD drill 1d /tools give Steve treechopper 12h /tools give Alex bucket 2h30m /ft give Notch shovel 7d ```

The command works from console and can be dispatched by other plugins (e.g. as a crate reward via FrozenCrates).

## 🔑 Permissions

| Permission | Description | Default | |---|---|---| | `frozentools.admin` | Give tools via `/tools give` | `op` | | `frozentools.use` | Use all frozen tools | `true` | | `frozentools.use.drill` | Use the Frozen Drill | `true` | | `frozentools.use.treechopper` | Use the Frozen Chopper | `true` | | `frozentools.use.bucket` | Use the Frozen Bucket | `true` | | `frozentools.use.shovel` | Use the Frozen Shovel | `true` |

## 🌍 WorldGuard Su