diff --git a/repo/js/AutoFriendshipFight/README.md b/repo/js/AutoFriendshipFight/README.md index 6cd0bab9..3b95aa61 100644 --- a/repo/js/AutoFriendshipFight/README.md +++ b/repo/js/AutoFriendshipFight/README.md @@ -1,91 +1,185 @@ -# 自动战斗好感 +## 自动战斗好感度 -## 功能简介 +> 自动化刷取角色好感度的脚本，支持盗宝团和愚人众两种敌人类型。通过自动触发和完成突发任务来获得好感度经验。 + +### 目录 +- [功能简介](#功能简介) +- [敌人类型](#敌人类型) +- [快速开始](#快速开始) +- [运行流程](#运行流程) +- [常见问题](#常见问题) +- [文件结构](#文件结构) +- [注意事项](#注意事项) +- [更新日志](#更新日志) + +### 功能简介 自动化刷取角色好感度的脚本，支持盗宝团和愚人众两种敌人类型。通过自动触发和完成突发任务来获得好感度经验。 -## 敌人类型支持 -### 盗宝团好感 -- **触发任务**: - - 岛上无贼 - 消灭鬼鬼祟祟的盗宝团 -- **特殊功能**: 支持清理原住民（丘丘人） -- **战斗坐标**: 稻妻地区指定位置 -### 愚人众好感 -- **触发任务**: - - 丘丘人今晚的伙食 - 打倒所有丘丘人 - - 买卖不成正义存 - 打倒愚人众与镀金旅团 - - 禁止危险运输！ - 打倒所有盗宝团 -- **战斗坐标**: 须弥地区专门位置 +- **日限制**: 每日最多获得10次好感度奖励，50次任务触发，在别的地方触发过好感任务会扣减相应次数。 +- **循环上限**: 单次运行最多50次循环，自动检测好感任务触发，不再触发时自动结束。 +- **平均时长**: 每次循环约1分钟，效率高时可以达到40秒单次循环。 +- **成功率**: 配置正确的情况下接近98%，有概率丢失第一次好感任务。 -## 使用前准备 +### 敌人类型 -### 1. BetterGI配置 +#### 盗宝团 +| 属性 | 详情 | +|------|------| +| **触发任务** | 岛上无贼 - 消灭鬼鬼祟祟的盗宝团 | +| **活动地区** | 稻妻地区 | +| **敌人强度** | ⭐⭐⭐ (中等) | +| **特殊功能** | （可选）支持清理原住民（丘丘人） | + +#### 愚人众&丘丘人&盗宝团 +| 属性 | 详情 | +|------|------| +| **触发任务** | 买卖不成正义存 - 打倒愚人众与镀金旅团
禁止危险运输！ - 打倒所有盗宝团
丘丘人今晚的伙食 - 打倒所有丘丘人 | +| **活动地区** | 须弥地区 | +| **敌人强度** | ⭐⭐⭐⭐ (较高) | + +### 快速开始 +#### 环境准备 +✅ 安装 BetterGI，版本大于 0.44.7 +✅ 订阅脚本并添加至调度器 + +#### 调度器配置 - **地图追踪行走配置**: - ✅ 勾选"只在传送点时回复" - ✅ 勾选"允许在JsScript使用" - ✅ 勾选"覆盖JS中的自动战斗配置" - **战斗配置** - - **战斗策略**: 根据队伍选择合适的战斗策略文件 + - **战斗策略**: 根据队伍选择或者制定合适的战斗策略文件 - **练度要求**: 建议较高练度，纯好感队可能无法击败敌人 - **重要设置**: ❌ 关闭"自动检测战斗结束" (如果勾选清理丘丘人，则需要打开) +- **推荐队伍配置** + > 基于社区测试的高效角色推荐，其他效率高的角色欢迎通过 pull request 添加到本文档，需附带理由和演示视频。 -- **队伍推荐** -- 至少1-2个主力输出角色，针对性的定制战斗策略 -- 建议携带治疗角色保证生存，失败会丢失好感任务次数，并且会显著增加任务时间 -- 避免使用纯好感队伍（练度不足） +| 角色 | 优先级 | 特点 | 注意事项 | +|------|--------|------|----------| +| **那维莱特** | ⭐⭐⭐⭐⭐ | 群友测试效率最高 | 输出稳定，适合自动战斗 | +| **茜特菈莉** | ⭐⭐⭐⭐ | 带盾，后台冰冻结敌人 | 提供生存保障 | +| **枫原万叶** | ⭐⭐⭐⭐ | 拾取材料，扩散伤害 | 增加收益效率 | +| **芙宁娜** | ⭐⭐⭐ | 后台输出 | 生存压力较大 | +| **钟离** | ⭐⭐⭐ | 提供护盾 | 战斗策略中E技能应左右释放 | +#### **脚本设置** +> 通过调度器脚本右键-修改JS自定义配置 -## 脚本设置 + - 敌人类型: 选择"盗宝团"或"愚人众" + - 运行次数: 10次或者50次 + - 目标是好感选择10次 + - 目标是锄地摩拉选择50次 + - 目标是掉落物暂时不支持 + - 队伍名称: + - 填入您的战斗队伍名称 + - 不填默认当前队伍 + - OCR超时: + - OCR检测超时时间（默认10秒） + - 过短可能识别失败导致结束任务 + - 过长则会长时间检测导致等待时间过长 + - 推荐保持默认值 + - 战斗超时: + - 单次战斗超时时间（默认120秒） + - 战斗超时会直接取消任务，因此不建议过短 + - 脚本会自动检测任务结束，识别精度很高 -### 基础设置 -- **敌人类型**: 选择"盗宝团"或"愚人众" -- **运行次数**: 设置刷取次数（默认10次） - - 运行次数的上限是50次，前10次可以获取好感 -- **队伍名称**: 指定使用的队伍配置 -- **OCR超时**: OCR检测超时时间（默认10秒）， - - 过短可能会识别失败导致结束任务； - - 过长则会长时间检测导致罚站时间过长； - - 推荐保持默认值。 -- **战斗超时**: 单次战斗超时时间（默认120秒） - - 战斗超时会直接取消任务，因此不建议过短 - - 脚本会自动检测任务结束，识别精度非常高，不用担心因为超时太长罚站 +#### 一键运行 +配置完成后，直接运行脚本即可开始自动刷取好感度。 -### 高级设置 + +#### 高级设置 - **清理原住民**: 仅盗宝团模式有效，清理丘丘人 - **卡时间模式**: 支持按日期周期运行 -## 运行流程 +### 运行流程 1. **队伍切换**: 自动切换到指定队伍 2. **准备阶段**: - - 盗宝团: 可选清理丘丘人 → 前往触发点 + - 盗宝团: (可选) 清理丘丘人 → 前往触发点 - 愚人众: 直接前往触发点 3. **任务检测**: 使用OCR检测突发任务触发 4. **战斗执行**: 自动导航到战斗点并开始战斗 5. **结果判定**: 检测战斗结果并记录 -6. **循环执行**: 重复上述流程直到完成设定次数 +6. **循环执行**: 重复上述流程直到完成设定次数或者检测到任务未触发 -## 注意事项 -### ⚠️ 重要提醒 +### 常见问题 + +#### 重要提醒 - 脚本运行时请勿手动操作游戏 -- 请按照指引操作 -### 🔧 故障排除 -- **战斗策略没有生效**: 勾选"覆盖JS中的自动战斗配置"，并在战斗配置设置相应的战斗策略 -- **战斗失败**: 检查队伍配置和战斗策略，提升角色练度 -- **超时结束**: 增加战斗超时时间 -- **OCR超时，但实际触发了任务**: 尝试提高OCR超时时间，否则提出issue -- **路径错误**: 确保相关路径文件存在于assets/AutoPath目录 -- **其他错误**：在github上提出issue +#### 常见问题解答 -### 📊 效率优化 -- 使用高练度队伍可提高战斗效率 -- 选择合适的敌人类型以匹配队伍配置 +##### Q: 为什么战斗策略没有生效或战斗失败率较高？ +**A**: 检查以下几点： +- 是否正确设置了战斗策略 +- 战斗策略是否适合当前队伍 +- 队伍练度是否足够 +- 是否正确勾选了"覆盖JS中的自动战斗配置" -## 文件依赖 + +##### Q: OCR超时但是任务已经触发？ +**A**: +- 尝试提高 OCR 超时时间 +- 如果观察到触发任务时，左侧没有任务文字，则游戏中关闭任务专注模式 + +##### Q: 如何选择合适的敌人类型？ +**A**: +- **盗宝团**: 适合中等练度队伍，敌人相对较弱 +- **愚人众**: 需要高练度队伍，怪物强度相对较高 + +##### Q: 脚本运行中断怎么办？ +**A**: +- 检查是否有手动操作游戏 +- 查看日志确定中断原因 +- 重新运行脚本 +- 若仍然未恢复，提交 issue + +##### Q: 脚本卡在某个步骤不动怎么办？ +**A**: +- 确认是否卡在了复活界面 +- 重启脚本并检查 BetterGI 状态 +- 若仍然未恢复，提交 issue + +##### Q: 如何选择盗宝团还是愚人众？ +**A**: +- **新手推荐**: 选择盗宝团，敌人较弱，容错率高 +- **高练度队伍**: 选择愚人众，效率更高 +- **好感度优先**: 两者都可以，选择队伍更适合的类型 + +##### Q: 战斗策略如何配置？ +**A**: +- 查阅 BetterGI 文档 + +##### Q: 为什么任务触发失败？ +**A**: +- 检查是否已达到每日任务触发上限 +- 尝试手动触发 + +##### Q: 队伍切换失败怎么办？ +**A**: +- 确认队伍名称填写正确（建议四字中文） + +##### Q: 脚本运行速度慢怎么办？ +**A**: +- 降低OCR超时时间（但不要过短） +- 优化战斗策略，减少不必要的等待 +- 确保BetterGI版本为最新 +- 检查计算机性能和网络状况 +- 提高计算机配置 + +##### Q: 如何备份和恢复配置？ +**A**: +- 配置保存在调度器配置文件中 +- 可以手动备份该文件，当然建议直接备份 `User` 文件夹 +- 重装后将备份文件复制回原位置即可恢复 + +> 💡 如遇其他问题，请在 GitHub 上提出 issue + +### 文件结构 - `main.js`: 主要脚本逻辑 - `settings.json`: 配置文件 @@ -97,10 +191,55 @@ - `愚人众-触发点.json`: 愚人众触发点路径 - `愚人众-战斗点.json`: 愚人众战斗点路径 +### 注意事项 -## 更新日志 +#### 使用须知 +- **仅供学习交流**: 本脚本仅用于技术研究和学习交流 +- **风险自担**: 使用自动化脚本存在一定风险，请谨慎使用 +- **适度使用**: 建议合理安排游戏时间，避免过度依赖自动化 -- **1.3**: 新增愚人众支持，优化敌人类型切换 -- **1.2**: 战斗触发检测，异步检测战斗结束 -- **1.1**: 盗宝团重登功能优化，卡时间支持 -- **1.0**: 基础盗宝团好感度刷取功能 \ No newline at end of file +#### 安全建议 +- **备份存档**: 使用前建议备份游戏存档数据 +- **监督运行**: 运行期间建议保持关注，及时处理异常情况 +- **版本更新**: 及时更新 BetterGI 和脚本到最新版本 +- **社区反馈**: 遇到问题及时向社区反馈，帮助改进脚本 + +### 更新日志 + +| 版本 | 更新内容 | +|------|----------| +| **v1.3** | 新增愚人众支持，优化敌人类型切换 | +| **v1.2** | 战斗触发检测，异步检测战斗结束 | +| **v1.1** | 盗宝团重登功能优化，卡时间支持 | +| **v1.0** | 基础盗宝团好感度刷取功能 | + +--- + +### 贡献指南 +欢迎提交 Pull Request 来改进此脚本！请遵循以下指南： + +#### 代码贡献 +- **功能改进**: 新增功能、性能优化、bug修复 +- **文档完善**: 改进README、添加注释、使用指南 +- **测试验证**: 提供测试用例、兼容性验证 + +#### 提交规范 +- 清晰的提交信息描述 +- 详细的PR说明和测试结果 +- 遵循现有代码风格 +- 避免在同一个提交中格式化代码 + +### 问题反馈 +遇到问题请在 GitHub 上提出 issue，包含以下信息： +- 详细的错误描述和复现步骤 +- 相关日志截图或错误信息 +- 使用的BetterGI版本和游戏环境 +- 脚本配置参数 + +### 社区支持 +- 📖 **文档**: 查看完整文档和教程 +- 🐛 **报告问题**: 通过Issues报告bug和建议 +- 🤝 **贡献代码**: 通过Pull Request贡献代码 + +> 💝 **感谢所有为此项目做出贡献的开发者和测试者！** +> 🌟 **如果这个脚本对您有帮助，请给项目点个星标支持！** \ No newline at end of file