⚙️ Configuration (config.yml)

config.yml is the core configuration controlling global logic, penalties, and integrations.

📋 Full Config Template

# Global max level
max-level: 10

# Cooldown between operations (seconds)
upgrade-cooldown: 5

storage:
  # FILE (YAML) or SQLITE (Database)
  type: FILE

name-suffix:
  enabled: true
  # Format supports color codes and {level}
  format: " &e[+{level}]"

# Core Balance Logic
failure-penalty:
  enabled: true
  # Drops level if failing after this level
  level-drop-threshold: 5
  # Levels to drop per failure
  level-drop-amount: 1
  
  # Dangerous: Item destruction
  item-destruction:
    enabled: false
    destruction-threshold: 8 # Risk starts at +8
    destruction-chance: 0.3 # 30% risk

# Integration: AuraSkills
auraskills:
  exp-reward:
    enabled: true
    skill: forging      # Skill ID
    base-exp: 50.0
  skill-bonus:
    enabled: true
    skill: forging
    bonus-per-level: 0.001 # +0.1% per level
  stat-bonus:
    enabled: true
    # Luck adds to success rate
    luck-stat: luck
    # Wisdom reduces costs (Max 30%)
    wisdom-stat: wisdom
    wisdom-max-reduction: 0.30

# Integration: MMOItems Compat
mmoitems-upgrade-compat:
  enabled: false
  # TEMPLATE = Use MI UpgradeTemplate
  # PLUGIN = Use our upgrade-gains but sync level to MI
  stat-source: TEMPLATE

---

🔍 Core Parameters Analysis

1. Penalty Mechanism

• Drop threshold: If set to 5, levels 1-5 are safe. Failure at +5 onwards reduces level.
• Destruction: High-risk challenge. Recommended for use with Protection Scrolls.

2. AuraSkills Calculation

• Final Rate = Base Rate + (Skill Lv * Bonus) + (Luck * Bonus) + Scroll Bonus.
• Final Cost = Base Cost * (1 - Wisdom * Reduction Ratio).

---

[!CAUTION] Changing mmoitems-upgrade-compat affects how stats are calculated for all items. Proceed with care.