AmethystItems

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 Hoe | Infinite elytra boost — never consumed on use | | Amethyst Hoe | Places lava without emptying | | Amethyst Hoe | Places water without emptying | | Amethyst Hoe | Fells entire connected trees in one swing (up to 512 logs) | | Amethyst Hoe | Breaks a 3×3 area of blocks per swing | | Amethyst Hoe | Digs a 3×3 area per swing | | Amethyst Hoe | Part of the armor set | | Amethyst Hoe | Part of the armor set | | Amethyst Hoe | Part of the armor set | | Amethyst Hoe | Part of the armor set | | Amethyst Hoe | Harvests and auto-replants mature crops in a configurable radius |

Wearing the Speed grants permanent Speed and Speed.

---

Expiry System

- The timer starts on anywhere, 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

```yaml 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

---