mirror of
https://github.com/babalae/bettergi-scripts-list.git
synced 2026-03-20 04:10:00 +08:00
自动剧情加载器 - 使用说明
项目宗旨
自动剧情加载器是专为委托开发者设计的脚本调试与编辑工具,旨在提升委托开发效率,简化测试流程。
重要声明:
- 本项目不会将任何非委托任务流程脚本上传至脚本仓库
- 禁止任何人用于商业用途,禁止在任何场合展示或宣传自动任务效果
- 不提倡上传任何任务流程脚本到公开平台
- 工具仅提供技术框架,不包含任何自动游戏剧情内容
- 请勿在任何官方平台(米游社、B站、微博等)讨论本工具
- 严禁在官方直播、动态或社区提及本工具相关内容
免责声明:
-
使用风险:
- 本脚本为开源学习项目,仅为游戏委托开发提供技术支持,禁止用于商业用途或违反游戏条款的行为。
-
责任限制:
- 本脚本按“现状”提供,不承诺兼容性、安全性或功能完整性。
- 用户应自行承担使用风险,并严格遵守《原神》用户协议。因使用本脚本导致的损失,开发者概不负责。
使用即表示您已阅读并同意上述条款。
使用方法及配置
- 将脚本添加至调度器。
- 右键点击脚本以修改 JS 自定义配置。
- 在设置中选择"刷新剧情列表"
- 工具将扫描所有可用剧情脚本
- 从更新后的列表中选择要执行的剧情
安全规范
社区公约
"我们理解大家对工具的热情,但脚本属于敏感领域。请务必:
- 不在任何官方平台讨论技术细节
- 不在直播、视频中展示工具效果
- 不与官方产生任何形式冲突
保持低调才能让工具持续可用!"
开发者社区
如急需自动剧情脚本,请加入开发者社群:
▨ QQ群:[开发者群号](加作者QQ获取)
▨ 作者QQ:3302871403
▨ 小提示:群内还有提瓦特全战斗宝箱
5.8部分解谜宝箱
部分已下架的资源
再次强调:
- 禁止任何人用于商业用途,禁止在任何场合展示或宣传自动任务效果
- 不要将任何非委托任务流程脚本上传至脚本仓库
让我们共同维护良好的社区环境!让大家都BetterGI用!
以下为开发指南
1 制作前检查
2 了解委托信息
- 名称:在任务界面看到的完整委托标题
- 地点:地图右上角名称
3 创建流程文件
路径规则 \process{委托名称}{委托地点}\process.json
- 使用 UTF-8 无 BOM 编码保存。
- 所有子流程(如
取餐.json)放在同一目录,方便相对路径引用。
4 流程文件格式总览
4.1 基本结构
[
{
"type": "<步骤类型>",
"data": <任意类型>,
"note": "控制台日志,可选",
"run": "<子流程文件名,可选,仅分支步骤>"
}
]
4.2 支持的步骤类型
| type | 作用 | data 示例 | 备注 |
|---|---|---|---|
| 委托描述检测 | 按 J 打开任务界面并匹配委托详情 | "取得制作好的餐品" |
支持 run 跳转子流程 |
| 地址检测 | 检测玩家坐标与给定坐标差距 ≤15 | [-667, 2285] |
支持 run 跳转子流程 |
| 地图追踪 | 执行地图寻路脚本 | "tracking1.json" |
相对路径 |
| 键鼠脚本 | 执行键鼠脚本 | "script1.json" |
相对路径 |
| 对话 | 自动对话并优先选择指定选项 | 见下方详解 | |
| 按键 | 按一次键盘按键 | "F" 或 {"action":"press","key":"E"} |
复杂按键操作对象,包含 action (动作,如"down"、"up"、"press")和 key (按键值) |
| tp | 强制传送到坐标 | [100,200,true] |
已不常用 |
| 等待 | 自定义等待 | 3000(毫秒) |
默认 5000 ms |
| 自动任务 | 开启/关闭 AutoSkip、AutoPick | 见下方详解 | |
| 等待返回主界面 | 判断返回主界面 | — | 无 data |
| 追踪委托 | 追踪NPC头顶图标 | data可以直接写npc的名字(字符串类型),也可以写成一个列表,name是npc的名字,iconType追踪的标,Bigmap大地图的委托图标,Question问号图标,Task任务图标(默认) | 好用 |
5 对话步骤详解
{
"type": "对话",
"data": {
"skipCount": 5,
"priorityOptions": ["同意", "接受委托", "我来帮忙"],
"npcWhiteList": ["派蒙", "凯亚", "安柏"]
},
"note": "优先选“同意”等选项,且只与白名单 NPC 交互"
}
"skipCount"跳过的前置无选项的对话次数,"priorityOptions"对话中可选的内容,npcWhiteList可以对话的npc
6 自动任务步骤详解
功能特点
- 动态启用/禁用自动任务
- 支持任务配置参数
- 统一的任务管理接口
使用方法
1. 启用自动拾取(默认配置)
{
"type": "自动任务",
"data": {
"action": "enable",
"taskType": "AutoPick"
},
"note": "启用自动拾取"
}
2. 启用自动拾取(自定义配置)
{
"type": "自动任务",
"data": {
"action": "enable",
"taskType": "AutoPick",
"config": {
"forceInteraction": false
}
},
"note": "启用自动拾取,禁用急速拾取模式"
}
3. 启用自动剧情
{
"type": "自动任务",
"data": {
"action": "enable",
"taskType": "AutoSkip"
},
"note": "开启自动剧情"
}
4. 取消所有自动任务
{
"type": "自动任务",
"data": {
"action": "disable"
},
"note": "取消所有自动任务"
}
参数详细说明
action (必需)
- 类型: string
- 可选值: "enable" | "disable"
- "enable": 启用自动任务
- "disable": 取消所有自动任务
taskType (启用时必需)
- 类型: string
- 可选值: "AutoSkip" | "AutoPick"
- "AutoSkip": 自动剧情
- "AutoPick": 自动拾取
config (可选)
- 类型: object
- 用于配置任务的具体参数
- 对于 AutoPick 任务:
forceInteraction: boolean - 是否启用急速拾取模式
支持的任务类型
| 任务类型 | 说明 | 支持的配置 |
|---|---|---|
| AutoSkip | 自动剧情 | 无特殊配置 |
| AutoPick | 自动拾取 | forceInteraction: 急速拾取模式开关 |
7 分支(条件跳转)机制
仅 委托描述检测 与 地址检测 支持 run 字段:
- 条件匹配 → 执行
run指向的子流程,子流程使用process.json同样的写法 - 条件不匹配 → 跳过本步骤继续往下执行
示例:
[
{
"type": "委托描述检测",
"data": "取得制作好的餐品",
"note": "分支名字正确的情况",
"run": "取餐.json"
},
{
"type": "地址检测",
"data": [-667, 2285],
"note": "距离目标 ≤15",
"run": "让纳西妲进尘歌壶.json"
}
]
8 完整示例
下面是一份可直接使用的 process.json 模板,含新功能:
[
{
"type": "自动任务",
"data": { "action": "enable", "taskType": "AutoPick", "config": { "forceInteraction": false } },
"note": "启用自动拾取(非急速)"
},
{
"type": "地图追踪",
"data": "tracking1.json",
"note": "前往目标 NPC"
},
{
"type": "等待",
"data": 2000,
"note": "等待传送动画"
},
{
"type": "对话",
"data": {
"skipCount": 3,
"priorityOptions": ["确定", "好的"],
"npcWhiteList": ["鲁道夫"]
},
"note": "与鲁道夫对话"
},
{
"type": "自动任务",
"data": { "action": "disable" },
"note": "清理自动任务"
}
]
完成后把
process.json及所有子流程文件打包发给审核即可。祝制作顺利!