name: "✨ 功能建议 / Feature Request"
description: "提出玩法、平衡、视觉或易用性改进 / Suggest gameplay, balance, visual, or usability improvements"
title: "[Feature] "
labels: ["enhancement"]
body:
  - type: markdown
    attributes:
      value: |
        ## 提交前检查 / Before submitting
        请先说明需要解决的玩家问题，再描述建议方案。这有助于判断它是否适合现有成长体系。

        Start with the player need or problem, then describe your proposal so it can be evaluated against the existing progression systems.

  - type: checkboxes
    id: preflight
    attributes:
      label: "提交前确认 / Pre-flight checklist"
      options:
        - label: "我已搜索现有 Issue，没有找到相同建议。 / I searched existing issues for the same request."
          required: true
        - label: "这项建议属于 Soul Harvest，而不是 Terraria 或 tModLoader 本体。 / This request belongs to Soul Harvest, not Terraria or tModLoader."
          required: true

  - type: markdown
    attributes:
      value: |
        ## 建议范围 / Proposal scope
        请选择建议性质与受影响系统。

  - type: dropdown
    id: request_type
    attributes:
      label: "建议类型 / Request type"
      options:
        - "新玩法或新能力 / New gameplay or ability"
        - "平衡调整 / Balance change"
        - "视觉或音效 / Visual or audio"
        - "界面或操作体验 / UI or controls"
        - "教程、本地化或无障碍 / Guide, localization, or accessibility"
        - "兼容性改进 / Compatibility improvement"
        - "其他 / Other"
    validations:
      required: true

  - type: dropdown
    id: affected_area
    attributes:
      label: "涉及系统 / Affected systems"
      multiple: true
      options:
        - "收魂镰通用系统 / Harvest Sickle common systems"
        - "亡骨 / Bone Wraith"
        - "血契 / Blood Covenant"
        - "炼狱 / Infernal"
        - "霜魂 / Frost Soul"
        - "灵魂 / Soul"
        - "虚空 / Void"
        - "最终死神形态 / Final Death form"
        - "死亡领域与死亡项链 / Death Domain and Death Necklace"
        - "死神祭坛与成长界面 / Death Altar and progression UI"
        - "灵魂、灵魂精华与魂印 / Souls, Soul Essence, and Soul Seals"
        - "长袍与翅膀 / Robes and wings"
        - "多人、服务端或兼容性 / Multiplayer, server, or compatibility"
        - "教程、本地化或无障碍 / Guide, localization, or accessibility"
    validations:
      required: true

  - type: markdown
    attributes:
      value: |
        ## 玩家需求与方案 / Player need and solution
        请结合实际游玩场景说明，而不仅是给出最终数值。

  - type: textarea
    id: problem
    attributes:
      label: "想解决的问题 / Problem or player need"
      description: "目前哪里不清晰、不方便、不平衡或缺少反馈？ / What is unclear, inconvenient, unbalanced, or missing feedback?"
      placeholder: "当玩家……时，目前会……，因此…… / When the player ..., the current behavior ..., which causes ..."
    validations:
      required: true

  - type: textarea
    id: proposed_solution
    attributes:
      label: "建议方案 / Proposed solution"
      description: "描述玩家操作、触发条件、效果、反馈与失败状态。 / Describe inputs, conditions, effects, feedback, and failure states."
    validations:
      required: true

  - type: textarea
    id: gameplay_example
    attributes:
      label: "实际游玩示例 / Gameplay example"
      description: "用一个具体战斗、成长或多人场景说明方案如何运作。 / Show how the proposal works in a concrete combat, progression, or multiplayer scenario."

  - type: markdown
    attributes:
      value: |
        ## 成长与技术影响 / Progression and technical impact
        如不适用可填写“不适用 / N/A”。

  - type: textarea
    id: balance
    attributes:
      label: "成长与平衡细节 / Progression and balance details"
      description: "包括解锁阶段、世界进度、等级上限、费用、伤害、冷却或范围。 / Include unlock stage, world gate, level cap, cost, damage, cooldown, or radius."

  - type: textarea
    id: multiplayer_save
    attributes:
      label: "多人及存档影响 / Multiplayer and save impact"
      description: "需要同步哪些状态？旧人物如何处理？ / What state must be synchronized? How should existing characters be handled?"

  - type: textarea
    id: alternatives
    attributes:
      label: "备选方案 / Alternatives considered"
      description: "还考虑过哪些做法，为什么更推荐当前方案？ / What alternatives did you consider, and why do you prefer this proposal?"

  - type: textarea
    id: references
    attributes:
      label: "草图、参考或补充信息 / Mockups, references, or additional context"
      description: "可拖入截图、示意图或录像，并说明希望参考的是机制、布局还是氛围。 / Attach images, diagrams, or video and explain what should be referenced."

  - type: checkboxes
    id: final_confirmation
    attributes:
      label: "最终确认 / Final confirmation"
      options:
        - label: "我理解提交建议不代表该功能一定会被采用或按原方案实现。 / I understand that submitting a request does not guarantee implementation as proposed."
          required: true

