文档外挂脚本开发

导入与管理绕过脚本

在注入后的游戏内实时加载本地 .sc / .js 脚本文件,自定义绕过策略、作弊模块与 HUD。

本页目录

文件格式#

项目说明
扩展名.sc 或 .js,均作为 JavaScript 执行
运行时Java 8 Nashorn
大小单个文件不超过 1 MiB
写法使用 var 和普通 function;文档示例采用兼容的基础语法
文件内容纯文本脚本,不是改了扩展名的压缩包或 JAR

保存脚本时使用 UTF-8。脚本可直接调用外挂底层 API 接管模块开关与发包状态;切勿加载不可信来源脚本。

通过工作区导入#

  • 打开 ClickGUI → 工作区 → 脚本。
  • 在路径字段输入本地文件的完整路径,点击导入。
  • 在文件列表确认脚本已加载。
  • 如果脚本注册了模块,再选中对应脚本模块,点击开关模块。

脚本文件和脚本模块是不同条目。前者控制代码是否加载;后者控制已注册功能是否运行。选中模块后可打开设置,包括脚本注册的选项与快捷键。

通过聊天命令导入#

游戏聊天栏
.script import "C:\Scripts\hello.sc"

包含空格的路径可放在双引号内。导入会复制文件到当前游戏的脚本目录,然后尝试加载;已有同名脚本时不会覆盖。

文件保存在哪里#

脚本目录是当前游戏目录下的 Polaris/scripts。输入 .script folder 可以打开它。导入后修改外部原文件不会自动更新这份副本;编辑 scripts 里的文件后,在工作区重载,或输入 .script reload。

注入/启动初始化时会自动扫描该目录加载脚本。手动复制新文件后,重载可重新扫描。使用启动器的版本隔离时,不同版本可能有不同的 scripts 目录。

脚本信息#

文件开头的可选信息
//@author Your name
//@version 1.0
//@description What this script does

名称来自文件名,不含扩展名;author、version、description 来自文件头。未填写时使用默认信息。管理命令中的名称不区分大小写。

加载、卸载与重载#

动作效果
加载读取文件并执行顶层代码,然后调用 onLoad
卸载调用 onUnload,释放当前脚本引擎
重载一个文件先卸载,再重新读取并加载该文件
.script reload卸载全部脚本,重新扫描目录并加载

卸载清理需要在脚本自己的 onUnload 中完成,例如注销模块。加载成功不代表模块已启用;加载失败时查看聊天提示和日志中的文件名。