AmethystItems

A lightweight PaperMC plugin that adds a set of powerful, admin-distributed items with built-in expiry timers. Each item is visually distinct and tracked individually — it expires and disappears wherever it is (inventory, chest, shulker box, or on the ground) once the timer runs out.

---

Items

Item	Effect
Amethyst Rocket	Infinite elytra boost — never consumed on use
Amethyst Lava Bucket	Places lava without emptying
Amethyst Water Bucket	Places water without emptying
Amethyst Axe	Fells entire connected trees in one swing (up to 512 logs)
Amethyst Pickaxe	Breaks a 3×3 area of blocks per swing
Amethyst Shovel	Digs a 3×3 area per swing
Amethyst Helmet	Part of the armor set
Amethyst Chestplate	Part of the armor set
Amethyst Leggings	Part of the armor set
Amethyst Boots	Part of the armor set

Wearing the full armor set grants permanent Night Vision and Speed.

---

Expiry System

• The timer starts on first use, not when the item is given.
• Remaining time is displayed directly on the item as a lore line, refreshed every minute.
• Expired items are removed from anywhere — player inventory, chests, shulker boxes, ender chest, or on the ground.
• Default durations are fully configurable in config.yml.

---

Command

/amethyst give <player> <item>

Use * as the item name to give all items at once.

Permission: amethyst.give — OP only by default.

---

Configuration

unbreakable: false   # true = tools and armor become unbreakable

colors:
  name: light_purple   # item name color
  timer: yellow        # timer line color

expire_hours:
  rocket: 1
  lava_bucket: 1
  water_bucket: 1
  axe: 24
  pickaxe: 24
  shovel: 24
  helmet: 12
  chestplate: 12
  leggings: 12
  boots: 12

Set any expire_hours value to -1 to disable expiry for that item.

---

Requirements

• PaperMC 1.21.1
• Java 21