EmulatorJS
该扩展允许你直接在 SillyTavern 对话中游玩复古主机游戏。
安装
前提条件:
- 最新发布版本的 SillyTavern。
- 从网上下载的 ROM 文件。你可以在这里找到它们。
安装方法:
- 使用 SillyTavern 的扩展下载器进行安装。
- 或使用此链接:
https://github.com/SillyTavern/SillyTavern-EmulatorJS
用法
- 打开“EmulatorJS”扩展菜单。
- 点击“Add ROM file”。ROM 会保存到你的浏览器存储中,不会存储在服务器上。
- 选择要添加的游戏文件。输入名称和 core(如果未自动检测到)。如果 core 需要 BIOS 文件,请一并添加。
- 点击列表中的“Play”按钮,或通过魔法棒菜单启动。
- 启动游戏后,你可以在模拟器界面中自定义按键和其他设置。
- 如果需要休息,可以使用存档/读档功能。
查看 EmulatorJS 文档以了解可用 core 的列表及其要求:Cores。
评论模式
借助多模态模型的能力,你的 AI 角色可以观看你的游戏画面,并给出风趣的角色化评论。
要求
- 支持 ImageCapture 的浏览器。已在桌面版 Chrome 上测试通过。Firefox 需要通过配置启用该功能。Safari 无法使用。
- 建议使用开启图片内联模式的聊天补全 API。查阅 API 文档以确认所选模型是否支持多模态提示词。
- 如果图片内联已禁用,请确保启用了 Image Captioning 扩展,然后选择“Multimodal”描述来源。
如何启用评论
- 确保你在 EmulatorJS 扩展设置中设置了评论提供的间隔。该设置定义了使用你当前游戏画面的截图来向角色请求评论的频率。值为 0 表示不提供任何评论。
- 选择一个角色对话并启动游戏。为获得最佳效果,请确保 ROM 文件命名正确,这样 AI 能获得更多背景上下文。
- 像平常一样开始游戏。视觉模型会被定期调用,根据它“看到”的最新截图来撰写评论。
设置
- 描述模板(Caption template) - 用于描述游戏内截图的提示词。支持
{{game}}和{{core}}附加宏。 - 评论模板(Comment template) - 用于根据生成的描述撰写评论的提示词。支持
{{game}}、{{core}}、{{caption}}附加宏。对于图片内联模式,{{caption}}会被替换为see included image。 - 强制描述(Force captions) - 即使图片内联受支持且已启用,也会强制使用多模态描述。
为什么我看不到任何评论?
在以下情况下,评论会暂时暂停(跳过该间隔步骤):
- 模拟器已暂停(通过暂停按钮,而非游戏内暂停)。
- 浏览器窗口失去焦点。
- 用户输入区不为空。这是为了让你能安静地输入回复。
- 当前正在进行另一次回复生成。
- 正在朗读 TTS 语音。评论会被推迟(最多 30 秒)直到其结束,但不会被跳过。
- 当前正打开着角色卡或群组。从欢迎界面启动游戏时,评论模式会被禁用。
其他常见问题:
- 确保你在启动游戏前已设置评论间隔。
- 确保你已设置多模态 API 密钥,并且 ST 服务器控制台中没有报错。
仍然不工作?请将你的浏览器调试控制台日志发送给我们(按 F12)。
致谢
- EmulatorJS 引擎(GPLv3):https://github.com/EmulatorJS/EmulatorJS