CraftAlerts

---

For issues or suggestions, please raise them in the HBL Nexus discord HERE

---

Server-wide alerts when players craft rare or configured items. Fully customizable with a rarity colour system.

How It Works

When a player crafts an item that's on the alert list, every player on the server sees a message:

The item name is coloured by its rarity tier.

Rarity Tiers

• Common - Grey
• Uncommon - Green
• Rare - Blue
• Very Rare - Purple
• Legendary - Orange/Gold
• Mythic - Cyan Blue

Commands

All commands are under /craftalerts:

• /craftalerts add {item_id} {rarity} - Add an item to the alert list
• /craftalerts addheld {rarity} - Add the item you're currently holding
• /craftalerts remove {item_id} - Remove an item from the list
• /craftalerts removeheld - Remove the item you're currently holding
• /craftalerts list - Show all tracked items with their rarity colours
• /craftalerts reload - Reload the config from file

Permissions

• CraftAlerts.manage - Required for add, addheld, remove, and list
• CraftAlerts.reload - Required for reload

Configuration

The plugin generates a CraftAlerts/config.json on first run. You can edit it manually or use the in-game commands. Changes made via commands are saved automatically.

{
  "alertItems": [
    {
      "itemId": "Weapon_Shortbow_Onyxium",
      "rarity": "Mythic"
    }
  ]
}

this is the only default item as an example.

Add as many items as you like, including custom items from other mods. The rarity field accepts: Common, Uncommon, Rare, Very_Rare, Legendary, Mythic.

Custom Item Support

CraftAlerts works with any item that has a crafting recipe, including items added by other plugins and mods. Use /craftalerts addheld while holding a custom item to add it instantly, or use /craftalerts add {item_id} with the item's ID.

---

Requirements:

A server using release/2026.03.26-89796e57b