!main01 !main02 !main03 !main04

⚒️ Crafting

◆ Vanilla recipes automatically produce your custom RefinedItems.

✨ Enchanting Support

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

🔥 Smithing Integration

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

◆ Commands & Permissions

◆ 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

# 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

# ===============================
# 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: # How much to add/subtract

operation: # ADD_NUMBER, ADD_SCALAR, MULTIPLY_SCALAR_1

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%

</details>