常见问题(FAQ)
安装与启动
问:安装后齿轮图标不显示?
答: 请按以下步骤排查:
- 确认 Tampermonkey 中脚本开关为 启用 状态
- 刷新游戏页面(
F5或Ctrl+R) - 确认已进入战斗(不是在车库界面)
- 打开浏览器控制台(
F12),检查是否有红色报错
如果仍然不显示,请在技术群中反馈并提供控制台截图。
问:提示“未截获任何玩家数据”怎么办?
答: 这是正常现象,请确认:
- ✅ 已进入战斗(不是在车库或大厅)
- ✅ 已在战斗中等待 3-5 秒,让游戏完全加载
- ✅ 没有被浏览器插件拦截
如果进入战斗后仍然提示,点击面板上的「扫描」按钮手动触发解析。
问:快捷键 B 没反应?
答: 可能原因:
- 输入框激活中:如果你正在聊天输入框或搜索框中打字,快捷键会被忽略
- 快捷键被其他插件占用:尝试修改快捷键
- 打开调试器面板 → 点击「设置」标签页
- 点击「更换按键」→ 按下新按键
使用问题
问:添加的参数显示“参数已失效”(红色警告)?
答: 这表示调试器在当前游戏代码中找不到这个参数,可能原因:
| 原因 | 解决方法 |
|---|---|
| 游戏刚更新 | 点击「扫描」按钮重新解析 |
| 参数名输入错误 | 删除后重新搜索添加 |
| 游戏模式限制 | 某些参数只存在于特定模式(如团队战) |
如果确认参数名正确但仍然失效,请在群内反馈。
问:修改了值但游戏没变化?
答: 请检查:
- 锁头图标是否为锁定状态 🔒(灰色锁 = 未启用)
- 输入框内容格式是否正确
- 数字:直接写
100 - 字符串:
"hello"(需要引号) - 布尔值:
true/false - 对象:
{"key": "value"}
- 数字:直接写
- 当前预设是否已启用(顶部开关为绿色)
问:可视化编辑器打开后是空的?
答: 可视化编辑器需要先有运行数据才能工作:
- 确保该参数已被游戏触发过(原值按钮有内容)
- 进入战斗,等待该变量被赋值
- 刷新页面后重新打开
内核探针
问:内核探针显示“未找到载具”?
答: 请确认:
- ✅ 已进入战斗(不是在车库)
- ✅ 坦克已生成(倒计时结束)
- ✅ 游戏版本为最新(内核探针对旧版可能不兼容)
如果仍然不行,尝试刷新页面重新进入战斗。
问:修改坐标后坦克瞬间弹回原位?
答: 这是服务器的位置校验机制,可能原因:
| 原因 | 解决方法 |
|---|---|
| 速度未清零 | 内核探针会自动清空速度,如果无效请手动点击「速度归零」 |
| 坐标超出地图范围 | 尝试输入合法坐标(-500 到 500 之间) |
| 服务器强校验 | 某些模式/地图无法修改 |
问:四元数是什么?不会改怎么办?
答: 四元数用于表示 3D 旋转,格式为 (w, x, y, z),正常值范围为 -1 到 1。
不熟悉的话建议不要修改旋转值,错误的输入可能导致坦克方向错乱。坐标修改(XYZ)更简单、更安全。
插件系统(1.9.1+)
问:如何安装插件?
答:
- 点击调试器面板中的 「插件管理中心」
- 点击右上角的 图标(导入插件)
- 选择
.js插件文件 - 插件会自动加载并显示在列表中
问:插件无法加载?
答: 请检查:
- 插件文件格式是否正确(必须是
.js文件) - 插件代码中是否包含完整的
registerPlugin调用 - 浏览器控制台中是否有报错
可以在技术群中寻求帮助。
问:插件列表中的插件可以删除吗?
答: 可以。点击插件右侧的 即可卸载。卸载后插件代码会从本地存储中删除,需要重新导入才能使用。
配置与保存
问:我的配置会丢失吗?
答: 调试器的配置保存在浏览器的 localStorage 和 GM_setValue 中,不会因刷新页面而丢失。
可能丢失的情况:
| 情况 | 结果 |
|---|---|
| 清除浏览器数据 | ❌ 配置会丢失 |
| 更换浏览器 | ❌ 配置不会同步 |
| 重装系统 | ❌ 配置会丢失 |
建议: 重要配置请使用 「导出预设」 功能保存到本地。
问:如何备份配置?
答:
- 打开调试器 → 点击预设名称(如「默认设定」)
- 点击「导出预设」
- 选择「复制到剪贴板」或「保存为文件」
恢复时点击「导入预设」即可。
错误与调试
问:控制台出现红色报错怎么办?
答: 报错信息通常包含关键线索:
| 报错关键词 | 可能原因 |
|---|---|
Cannot read property | 参数未正确 Hook |
NetworkError | 脚本扫描网络问题 |
out of memory | 历史记录过多,清空重试 |
处理步骤:
- 截图报错信息(展开完整堆栈)
- 刷新页面重试
- 如果问题持续,在技术群反馈
问:如何查看详细的运行日志?
答: 打开浏览器控制台(F12 → Console),可以看到调试器的详细日志:
[TankiDebug] Hooking: BattleUsers.uids -> _obf_xxx
[Plugin:xxx] 插件已加载这些日志有助于定位问题。
其他
问:调试器会被官方检测吗?
答: 调试器运行在客户端,与官方服务器无直接交互。但任何第三方工具都有风险,请自行评估。
建议:
- 不要在正式对战中使用内核探针的修改功能
- 不要使用调试器进行不公平游戏
- 本工具仅用于技术研究与学习
问:为什么有些功能只在核心群版才有?
答: 1.9.0+ 版本包含的内核探针功能可以读写游戏对象属性,属于高敏感功能。为防止滥用和官方追责,这些版本仅限核心群成员内部交流,不对外公开。
问:我能把调试器分享给朋友吗?
答:
- 1.8.x(公开版):可以分享,但建议附上项目说明
- 1.9.0+(核心版):严禁外传,包括私聊、网盘、公开平台。详见群公告保密协议。
问:如何反馈问题或建议?
答: 请在技术群中反馈,并尽量提供:
- 调试器版本号(例如 1.9.1)
- 浏览器名称及版本
- 问题复现步骤
- 控制台截图/报错信息
