Files
bettergi-scripts-list/repo/js/AAA-Auto-Story-Loader
LX666-666 d909d2450a 自动剧情加载器 (#1637)
从自动委托中分分离出来的
2025-08-18 22:29:00 +08:00
..
2025-08-18 22:29:00 +08:00
2025-08-18 22:29:00 +08:00
2025-08-18 22:29:00 +08:00
2025-08-18 22:29:00 +08:00
2025-08-18 22:29:00 +08:00

自动剧情加载器 - 使用说明

项目宗旨

自动剧情加载器是专为委托开发者设计的脚本调试与编辑工具,旨在提升委托开发效率,简化测试流程。

重要声明

  1. 本项目不会将任何非委托任务流程脚本上传至脚本仓库
  2. 禁止任何人用于商业用途,禁止在任何场合展示或宣传自动任务效果
  3. 不提倡上传任何任务流程脚本到公开平台
  4. 工具仅提供技术框架,不包含任何自动游戏剧情内容
  5. 请勿在任何官方平台米游社、B站、微博等讨论本工具
  6. 严禁在官方直播、动态或社区提及本工具相关内容

免责声明:

  1. 使用风险:

    1. 本脚本为开源学习项目,仅为游戏委托开发提供技术支持,禁止用于商业用途或违反游戏条款的行为。
  2. 责任限制:

    1. 本脚本按“现状”提供,不承诺兼容性、安全性或功能完整性。
    2. 用户应自行承担使用风险,并严格遵守《原神》用户协议。因使用本脚本导致的损失,开发者概不负责。

使用即表示您已阅读并同意上述条款。


使用方法及配置

  1. 将脚本添加至调度器。
  2. 右键点击脚本以修改 JS 自定义配置。
  3. 在设置中选择"刷新剧情列表"
  4. 工具将扫描所有可用剧情脚本
  5. 从更新后的列表中选择要执行的剧情

安全规范

社区公约

"我们理解大家对工具的热情,但脚本属于敏感领域。请务必:

  • 不在任何官方平台讨论技术细节
  • 不在直播、视频中展示工具效果
  • 不与官方产生任何形式冲突

保持低调才能让工具持续可用!"

开发者社区

如急需自动剧情脚本,请加入开发者社群:
▨ QQ群[开发者群号]加作者QQ获取
▨ 作者QQ3302871403
▨ 小提示:群内还有提瓦特全战斗宝箱
                 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 及所有子流程文件打包发给审核即可。祝制作顺利!