Refined Items

⚒️ Crafting

◆ Vanilla recipes automatically produce your custom RefinedItems.

Spoiler

✨ Enchanting Support

◆ Custom items retain their fancy formatting, lore, and attributes even after enchanting!

Spoiler

🔥 Smithing Integration

◆ Upgrade Diamond to Netherite while preserving all custom enchants, durability, and attributes!

Spoiler

---

◆ Commands & Permissions

---

Command	Description	Permission
/ri reload	Reloads all configuration files and instantly refreshes items for all online players	refineditems.admin

---

◆ Installation

---

1. Download RefinedItems.jar
2. Place it in your server's plugins folder
3. Restart the server
4. Edit plugins/RefinedItems/items.yml to configure your items
5. Run /ri reload to apply changes!

---

◆ Configuration:

---

Config.yml

Spoiler

# RefinedItems Main Configuration
# Custom items are located in items.yml

# Set to true to enable debug messages in console
debug: false

# Formatting Configuration
durability-format: "&#9CA3AFDurability: &#F5C16C%current%&#9CA3AF/&#F5C16C%max%"

enchantment-formatting:
  title-symbol: "&#9CA3AF❖"
  title-text: "&#E5E7EBEnchantments:"

  bullet: "&#93C5FD◆"

  normal-level-color: "&#93C5FD"
  max-level-color: "&#F5C16C"

Items.yml

• Only one item is shown as an example
• The actual items.yml includes all vanilla items

Spoiler

# ===============================
# RefinedItems - items.yml
# ===============================
# Each item here replaces the vanilla version when crafted or given.
# All values are fully customizable.

# ===============================
# ENCHANTMENTS CONFIGURATION
# ===============================
# The 'enchantments:' section defines DEFAULT enchantments
# applied ONLY when the item is first created.
# Format:
#   enchantments:
#     ENCHANTMENT_NAME: LEVEL

# ===============================
# ATTRIBUTES CONFIGURATION
# ===============================
# The 'attributes:' section defines the item's base attribute modifiers.
# These are applied when the item is created and affect player stats.
# Format:
# attributes:
#   ATTRIBUTE_NAME:          # Replace 'ATTRIBUTE_NAME' with: GENERIC_ATTACK_DAMAGE/GENERIC_MAX_HEALTH etc.
#     amount: <value>        # How much to add/subtract
#     operation: <type>      # ADD_NUMBER, ADD_SCALAR, MULTIPLY_SCALAR_1
#     slot: <equipment slot> # HAND, HEAD, CHEST, LEGS, FEET

# ═══════════════════════════════════════════════════════════════════════════
#                              WOODEN TIER
# ═══════════════════════════════════════════════════════════════════════════

wooden_sword:
  # The vanilla Minecraft material this item is based on
  material: WOODEN_SWORD
  # Supports color codes and HEX colors (&#RRGGBB)
  # Display name of the item
  name: "&#7A594CWooden Sword"
  lore:
    - ""
    - "&#666666A basic starter weapon."
    - ""
    - "%enchantments%"   # %enchantments% is a dynamic placeholder. Shows ALL CURRENT enchantments on the item. Can be edited in config.yml.
    - "&#555555━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
    - ""
    - "%durability%"   # %durability% is a dynamic placeholder. Updates automatically as the item is used or repaired. Can be edited in config.yml.
    - ""
    - "&#555555━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
  flags:
    - HIDE_ATTRIBUTES   # Hides attack damage, armor values, etc.
    - HIDE_ENCHANTS   # Hides vanilla enchantment text. Enchantments can be STILL shown via %enchantments%