Items Folder

Purpose

Documentation for Path of Exile unique items and notable equipment.

Template

Required: templates/item-template.md

Naming Convention

Format: [item-name].md (kebab-case)

For items starting with "The":

• Include "the" in filename: the-brass-dome.md

Examples:

• the-brass-dome.md
• shavronne-wrappings.md
• headhunter.md
• ashes-of-the-stars.md

Required Frontmatter

template: "templates/item-template.md"
document_type: "item"
title: "[Item Name]"
status: "draft|review|published|outdated"
author: "[Your Name]"
created: "YYYY-MM-DD"
updated: "YYYY-MM-DD"
tags: ["tag1", "tag2"]
league: "3.25"
patch: "3.25.1"

# Item-specific fields
item_type: "helmet|body-armour|gloves|boots|weapon|accessory|jewel|flask"
rarity: "unique|rare"
required_level: 68

Content Guidelines

What to Include

• Item base type and implicit mods
• Unique modifiers and ranges
• Drop sources or acquisition methods
• Common use cases and builds
• Price range/availability
• Interactions with other items/mechanics
• Legacy versions (if applicable)

Tags

Use tags for item type, mechanics, and build archetypes:

tags: ["unique", "body-armour", "armour", "physical", "item"]

Relationships

Common relationship types:

• used_by - Builds that use this item
• synergizes_with - Works well with other items/skills
• alternative_to - Similar items for same slot
• required_by - Builds that require this item

Example:

relationships:
  used_by:
    - path: "builds/marauder/rf-juggernaut.md"
      title: "RF Juggernaut"
  synergizes_with:
    - path: "mechanics/skills/righteous-fire.md"
      title: "Righteous Fire"

Quality Checklist

• [ ] Used templates/item-template.md
• [ ] Followed naming convention (include "the" if applicable)
• [ ] Included all required frontmatter
• [ ] Set correct item_type and rarity
• [ ] Specified required_level if applicable
• [ ] Used absolute paths for relationships
• [ ] Added descriptive tags