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
Amethyst Hoe	Harvests and auto-replants mature crops in a configurable radius

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.

---

Amethyst Hoe

Right-clicking a supported crop harvests all mature crops in a square radius around the clicked block and immediately replants them at age 0.

• Supported crops: Wheat, Carrots, Potatoes, Beetroots, Nether Wart
• Nether Wart is only replanted if Soul Sand is present below
• Radius is configurable via hoe_radius in config.yml (default: 1 = 3×3)
• Timer starts on first use (default: 24h)

---

Shop

Players can browse and purchase items via /amethystshop. The shop plays sounds on open, successful purchase, and failed purchase.

---

Commands

/amethyst give <player> <item>
/amethyst reload

• give — gives the specified item (use * for all items at once)
• reload — reloads config.yml and updates timer lore for all online players immediately

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
  hoe: 24

hoe_radius: 1   # harvest radius in blocks (1 = 3×3, 2 = 5×5, etc.)

shop:
  prices:
    hoe: 700
    # ... (other prices)

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

---

Requirements

• PaperMC 1.21.1
• Java 21

---