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

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