Skip to main content

⚙️ 配置详情 (config.yml)

config.yml 是 MMOItemsUpgrade 的核心配置文件，控制着插件的全局逻辑、失败惩罚机制以及多插件集成选项。

📋 全量配置总览​

您可以参考以下带有深度中文注释的配置样板进行调整：

# 语言设置 (zh_CN=简体中文, zh_TW=繁体中文, en_US=英文)
language: zh_CN

# 全局最高强化等级限制 (也会受品质和特定物品上限影响)
max-level: 10

# 强化冷却时间 (秒)，防止玩家通过高频点击刷屏或产生异常
upgrade-cooldown: 5

# 玩家数据存储方式
storage:
  # 可选: FILE (本地 YAML 文件) 或 SQLITE (轻量数据库)
  type: FILE

# 物品改名后缀配置
name-suffix:
  # 是否在物品原名后显示强化等级
  enabled: true
  # 显示格式 ({level} 会被替换为等级)，支持 & 颜色代码
  format: " &e[+{level}]"

# 强化失败惩罚机制 (核心平衡点)
failure-penalty:
  enabled: true
  
  # 等级回退阈值：达到此等级后，强化失败会掉级
  level-drop-threshold: 5 # 即 +5 升 +6 失败会退回 +4
  
  # 每次失败回退的等级数
  level-drop-amount: 1
  
  # 装备损毁配置 (极其危险，请谨慎开启)
  item-destruction:
    enabled: false        # 是否开启失败碎装
    destruction-threshold: 8 # +8 及以上强化失败时几率碎装
    destruction-chance: 0.3 # 30% 的碎装概率 (0.0 - 1.0)

# 失败时的视觉反馈 (屏幕大标题)
failure-feedback:
  title:
    enabled: true
    title: "&c&l强化失败!"
    subtitle: "&7胜败乃兵家常事，请大侠重新来过"
    fade-in: 10
    stay: 40
    fade-out: 10

# 音效反馈配置 (支持原版音效名和资源包自定义 Key)
feedback-sounds:
  success:
    enabled: true
    name: "ENTITY_PLAYER_LEVELUP"
  failure:
    enabled: true
    name: "ENTITY_VILLAGER_NO"
  level-drop:
    enabled: true
    name: "BLOCK_ANVIL_LAND"
  item-destroyed:
    enabled: true
    name: "ENTITY_ITEM_BREAK"

# AuraSkills 技能系统深度集成
auraskills:
  # 强化成功后给予技能经验
  exp-reward:
    enabled: true
    skill: forging      # 对应的技能 ID (如锻造 forging, 挖矿 mining)
    base-exp: 50.0      # 基础获得经验
    exp-per-level: 10.0 # 每提升一级额外增加的经验值
  
  # 技能等级对成功率的加成
  skill-bonus:
    enabled: true
    skill: forging
    bonus-per-level: 0.001 # 每级增加 0.1% 成功率
    max-bonus: 0.15        # 最高加成上限 (15%)
  
  # 玩家属性对强化的影响
  stat-bonus:
    enabled: true
    # 幸运 (Luck) 影响成功率
    luck-stat: luck
    luck-bonus-per-point: 0.002 # 每点幸运值增加 0.2% 成功率
    luck-max-bonus: 0.10        # 最高幸运加成 (10%)
    
    # 智慧 (Wisdom) 影响强化成本
    wisdom-stat: wisdom
    wisdom-cost-reduction: 0.005 # 每点智慧减少 0.5% 的金币/材料消耗
    wisdom-max-reduction: 0.30   # 最高消耗减免 (30%)

# MMOItems 原生兼容性增强 (实验性功能)
mmoitems-upgrade-compat:
  enabled: false
  # 是否优先使用物品自身的最高等级限制 (即 MMOItems 物品配置中的 max 字段)
  use-item-max-level: true
  # 属性来源设置:
  # TEMPLATE - 使用 MMOItems 的 UpgradeTemplate 应用属性 (需在 MI 中配好模板)
  # PLUGIN   - 使用本插件的 upgrade-gains 配置应用属性，但会将等级同步给 MI
  stat-source: TEMPLATE

🔍 核心参数深度解析​

1. 失败惩罚机制 (Penalty)​

这是调节服务器经济和装备价值的关键。

  • 回退阈值 (Threshold)：如果设为 5，意味着 1-5 级强化失败只是材料消失等级不变，一旦达到 5 级（即尝试升 6），失败就会降低等级。
  • 碎装判定：开启后，高等级强化将变成真正的“心跳挑战”。建议配合保护卷轴使用。

2. AuraSkills 集成逻辑​

  • 成功率算法：最终几率 = 基础几率 + (技能等级 * 每级奖励) + (幸运值 * 每点奖励) + 卷轴加成。
  • 消耗算法：最终消耗 = 基础成本 * (1 - 智慧值 * 减免比例)。这能极大增加特定加点玩家的生存优势。

3. 数据存储 (Storage)​

  • 如果您的服务器玩家极多，建议切换为 SQLITE 模式以获得更稳定的 IO 表现。默认 FILE 模式则更方便手动修改。

[!CAUTION] 修改 mmoitems-upgrade-compat 选项会对现有装备的属性计算方式产生重大影响，请在正式环境开启前备份数据。