快速游玩

Fastplay - 游戏内AI助手

这是什么

Fastplay 是一个适用于 Minecraft 的游戏内 AI 助手模组。它不仅仅是一个聊天机器人——它可以真正“看到”你的游戏：

手持钻石剑并按下一个按键：它会告诉你这把剑来自哪个模组、其基础属性以及如何升级它。将鼠标悬停在物品栏中的物品上，它会利用完整的物品知识库解释其用途和合成配方，并直接在回复中以原生的 3x3 合成格图标呈现配方。卡关不知道怎么玩？它能在回答前自行搜索网络。

一切都发生在游戏内部——无需切换窗口，无需复制粘贴。

功能特点

智能物品识别
- 三种识别通道：手持物品（优先主手，副手作为后备）、你正在注视的方块/实体，以及在容器/配方界面中悬停的槽位
- 丰富的上下文注入：自动附加 NBT 摘要、来源模组和合成配方到物品上，使回答基于你的实际游戏状态
- 可视化配方：合成配方直接以 3x3 图标网格呈现在回复中——无需再数纯文本中的格子

强大的 AI 聊天
- 免费的内置 API：开箱即用，采用快速的 KIMI/Moonshot 模型（kimi-k2.7-code-highspeed），约 1 秒即可生成首个 token
- 网络搜索：当问题涉及最新版本、模组信息或游戏指南时，AI 会在回答前先搜索网络
- 图片显示：搜索结果中的图片可以被引用并渲染在回复中（直接图片链接会在聊天气泡中内联显示）
- 带记忆的多轮对话：保留近期聊天历史以支持自然的后续提问；回复通常以建议的后续问题结尾，你可以点击以深入探索
- 完全可自定义：系统提示词、采样温度、最大回复长度和历史记录大小均可调节

完整物品知识库
- 进入世界后自动在后台收集所有已注册的物品和配方（包括你安装的其他模组中的物品）——无卡顿
- 每个问题都会注入按相关性排序的知识条目，确保回答有依据而非凭空捏造
- 支持排除特定模组，并可将知识库导出为 JSON 文件（用于调试和进一步开发）

自由外观与操作
- 半透明悬浮窗口；拖动标题栏移动，Ctrl + 滚轮随时调整文字大小
- 窗口大小、不透明度、文字缩放和物品卡片高亮均可配置
- 完全双语界面（英文和中文）

面向模组开发者
Fastplay 提供了公开的扩展 API——其他模组无需修改 Fastplay 即可贡献知识：
- FastplayEvents.KnowledgeScan：向知识库注入自定义条目
- FastplayEvents.BuildItemContext / BuildSystemPrompt：扩展物品上下文和系统提示词
- IFastplayKnowledgeSource：注册为扩展点以批量提供知识数据

代码示例：
@SubscribeEvent
public static void onKnowledgeScan(FastplayEvents.KnowledgeScan event) {
    event.results().add(new ItemKnowledge(...));
}

开始使用

安装
1. 安装 NeoForge 26.2（适用于 Minecraft 26.2，Java 25）
2. 将 Fastplay 的 jar 文件丢入你的 mods 文件夹
3. 启动游戏并进入一个世界（首次进入时会显示使用须知）

按键绑定
- 鼠标侧键 5：打开/关闭 AI 助手窗口（可在设置中重新绑定）
- 鼠标侧键 4：询问当前物品——自动附加识别上下文（可在设置中重新绑定）

鼠标没有侧键？可在 设置 > 控制 > Fastplay AI 助手中将绑定改为任意按键。

首次使用
按下鼠标侧键 5 打开助手窗口——输入框会自动包含你当前手持物品的上下文。直接输入问题即可；切换话题时点击垃圾桶图标清空对话。

配置

在游戏中通过 模组列表 > Fastplay > 配置 打开完整设置界面，包含 6 个标签页：

- AI 端点：内置/自定义端点切换、URL、API 密钥、模型名称、超时时间
- 聊天：系统提示词、温度、最大回复长度、历史记录大小、物品上下文开关
- 物品识别：三通道识别开关、NBT / 合成配方 / 来源模组开关
- 知识库：自动收集开关、排除的模组、注入限制、JSON 导出
- 外观：窗口大小、不透明度、文字缩放、物品卡片
- 调试：调试日志记录

配置文件位于 config/fastplay-client.toml，并支持热重载。

使用你自己的 AI 端点

Fastplay 兼容任何 OpenAI 聊天补全端点（/v1/chat/completions）：
1. 打开 设置 > AI 端点
2. 将模式切换为自定义端点
3. 填写端点 URL（例如 https://api.deepseek.com/v1）、API 密钥和模型名称
4. 保存并开始聊天——模型列表可一键获取

提示：内置端点是免费的但有速率限制；如果遇到响应繁忙，可切换到自定义端点。

隐私与数据

- 你的问题、物品信息和聊天内容会被发送到配置的 AI 端点以生成回复（内置端点由 KIMI/Moonshot 提供支持）
- 请勿在聊天中输入密码、API 密钥、地址或其他敏感个人信息
- 所有网络请求均来自本模组配置的端点和图片链接
- 本项目无遥测或分析功能——所有配置和数据都保留在你的机器上

常见问题

问：“AI 服务繁忙（引擎过载/速率受限）”——该怎么办？
答：免费的内置端点在高峰时段可能会过载。稍等片刻重试，或切换到自定义端点。

问：回答不准确？
答：AI 回复由大型语言模型生成，仅供游戏内参考。请确保知识库已完成收集（进入世界后稍等片刻），对于涉及版本差异的问题，请启用网络搜索。

问：会拖慢我的游戏吗？
答：不会。知识库在后台线程收集，AI 请求异步运行——游戏绝不会阻塞。

问：会和模组 X 冲突吗？
答：Fastplay 是一个仅客户端模组，只监听按键绑定和物品上下文事件。它不修改任何游戏机制，因此不太可能冲突。如果遇到问题，请在 Issue 跟踪器中报告。

问：需要在服务器上安装吗？
答：不需要。Fastplay 是一个仅客户端模组——只在客户端安装即可。

兼容性

- Minecraft 26.2 / NeoForge 26.2（Java 25）
- 仅客户端模组；适用于单人游戏和多人游戏客户端
- 内置端点需要互联网连接；确保自定义端点可达

反馈与支持

发现 Bug 或有建议？可通过以下方式联系：
- Issues： 
- 主页 / 项目页面： 
- 作者：Suger

许可证

保留所有权利。未经作者许可，不得复制、修改或重新分发此模组。