🔧 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

# 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 <player> <tool> <duration>	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 Support

FrozenTools fully respects WorldGuard protected regions. Tools will not break blocks in regions where the player doesn't have build permission.

---

🖥️ Compatibility

	Supported
Paper	✅ 1.21 – 1.21.x
Folia	✅ 1.21 – 1.21.x
Java	✅ Java 21+
WorldGuard	✅ Optional soft-depend

---

🧑‍💻 Author

Made with ❤️ by DrFrozenXD — part of the FrozenStudio plugin suite.

Also check out: FrozenVault · FrozenBounty · FrozenCrates · FrozenTab · FrozenSell · FrozenSpawn · FrozenTeams