高级近战框架

《星露谷物语》武器附魔与自定义特殊攻击框架 MOD 使用指南

【核心介绍】
为内容包提供标准化接口，支持为「剑」「棍棒」「匕首」等武器类型添加自定义附魔与可编程特殊攻击，无需修改游戏源码即可扩展战斗系统。

【安装指南】

1. 必须先安装「SMAPI」（下载地址），否则本MOD无法运行；
2. 下载本MOD主文件（版本 1.6），解压后将整个文件夹放入游戏根目录 `/mods` 文件夹；
3. 首次启动游戏时，自动在 `/mods/AdvancedWeaponFramework/config.json` 生成配置文件，如需修改触发方式（如改为按住左Shift键激活），请编辑该文件；
4. 单独启用本MOD不会产生任何效果，必须配合使用兼容的内容包（见

【使用此框架的模组】
列表）。

【功能详情】
✅ 已优化：

• 支持为任意原版武器添加标准附魔（详见官方附魔列表文档）；
• 内置四种自定义附魔类型：「治疗」「伤害」「掉落」「金币」，行为逻辑清晰、参数可配置；
• 支持创建多帧自定义特殊攻击，含方向控制、无敌帧、闪电/爆炸特效、位移、投射物生成、音效播放等功能；
• 默认替换对应武器类型的原版特殊攻击，亦可通过 `config.json` 切换为修饰键触发模式。
  ❌ 未修改：
• 不改变游戏基础战斗判定、伤害计算或动画系统；
• 不自带武器或附魔内容，仅为内容包开发者提供运行框架。
  ✨ 额外调整：
• 兼容「Mod Updater」自动更新；
• 提供示例内容包（含「银河剑」「熔岩太刀」「银河锤」「风之尖塔」四把武器及对应攻击），开箱即用验证功能。

【使用要求】

• 必须安装 「SMAPI」（v4.0+）；
• 游戏版本需为 星露谷物语 v1.6+；
• 推荐使用 .NET 6 运行时（SMAPI 安装包已内置，无需单独安装）。

【兼容性说明】

• 兼容范围：所有遵循本框架规范开发的第三方内容包；
• 不兼容模组：无直接冲突，但不兼容擅自覆盖同一武器特殊攻击逻辑的其他战斗类MOD（如手动修改 `Weapon.cs` 或劫持攻击事件的非标准MOD）；
• 兼容补丁：暂未推出专用兼容补丁，建议避免与同类底层战斗扩展MOD共存。

【注意事项】

• 示例内容包中的「银河锤」神之雷霆特效可能在低配设备出现轻微卡顿，属视觉表现范畴，不影响战斗判定；
• 自定义附魔的「治疗」效果默认基于命中/暴击/击杀触发，若内容包未明确定义触发条件，则按默认逻辑执行；
• 修改 `config.json` 后需重启游戏生效，热重载不支持配置变更；
• 所有自定义攻击均继承原版武器基础属性（攻速、伤害倍率等），不可单独调整。

【更新日志】
2024 年 4 月 12 日 新增对 v1.6 游戏版本的完整适配，优化多投射物并发性能；
2024 年 3 月 5 日 1.6 版本由 MindMeltMax 维护发布，修复部分配置项加载异常问题；
2023 年 11 月 18 日 初始公开版发布，开放基础附魔与单帧攻击支持。