Frozen/Amethyst Tools

🔧 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

FrozenTools

📖About FrozenTools