插件安装指南
欢迎来到 MoFox 插件的世界！在这里，你可以找到各种有趣的插件来扩展 MoFox Bot 的功能。
插件获取途径
官方 Kook 社区（推荐）
我们在 Kook 平台设有官方社区服务器，你可以在这里获取最新的插件和支持：
- 服务器名称：墨狐狐的训练基地
- 邀请链接：https://kook.vip/RQoR4v
- 插件发布频道：进入服务器后，前往「插件发布专区」→「插件发布」频道
在插件发布频道，你可以：
- 📦 下载插件文件：直接下载
.mfp插件包或压缩包 - 🔗 获取仓库链接：通过 Git 仓库地址自行克隆
- 💬 交流讨论：与插件作者和其他用户交流使用心得
- 📢 获取更新通知：第一时间了解插件更新动态
安装插件
重要提示
在安装任何插件之前，请务必仔细阅读插件的说明文档（通常为 README.md 文件/帖子说明）！这将帮助你了解：
- 插件的具体功能和使用方法
- 必要的配置步骤
- 依赖项要求
- 注意事项和已知问题
安装插件的过程非常简单，我们提供多种方式：
方式一：下载插件包（推荐）
- 加入 Kook 社区：点击 邀请链接 加入官方服务器
- 找到插件发布频道：进入「插件发布专区」→「插件发布」
- 下载插件文件：在频道中找到你需要的插件，下载对应的
.mfp文件或压缩包 - 安装插件：
- 将下载的文件放入 MoFox Bot 的
plugins目录 - 如果是压缩包，需要先解压
- 如果是
.mfp文件，可以直接放置（Bot 会自动识别）
- 将下载的文件放入 MoFox Bot 的
- 配置插件：根据插件说明文档进行配置
方式二：通过 Git Clone
如果插件提供了 Git 仓库地址，你也可以通过 git clone 的方式安装：
- 获取仓库地址：在 Kook 插件发布频道或插件说明中查找 Git 仓库地址
- 进入插件目录：bash
cd /path/to/MoFox-Bot/plugins - 克隆仓库：bash
git clone <插件的 Git 仓库地址> - 安装依赖（如果需要）：bash
cd <插件目录> uv pip install -r requirements.txt # 如果有的话注意
大部分情况下Neo-MoFox会自动安装插件依赖，但如果插件说明里提到了额外的 Python 包，还是建议手动安装一下，避免运行时出问题。
- 配置插件：根据插件说明文档进行配置
重启 Bot
无论是通过哪种方式安装，为了让新插件生效，你都需要重启 Neo-MoFox。
验证安装
重启后，如何确认插件是否成功加载了呢？很简单，去查看日志！
在 Neo-MoFox 的 logs 文件夹中，找到最新的日志文件，打开它。如果你看到类似下面这样的日志，就说明插件已经成功加载了：
log
[21:58:25] plugin_manager | INFO | ✅ 插件 'xxxxxx' 的组件注册完成
[21:58:25] plugin_manager | INFO | ✅ 插件加载成功: xxxxx vX.X.X恭喜你，现在你已经成功安装了一个新的插件！快去体验一下它带来的新功能吧！
常见问题
如何找到特定的插件？
在 Kook 服务器的「插件发布」频道中，你可以：
- 使用 Kook 的搜索功能搜索插件名称
- 浏览频道消息，查看最新发布的插件
- 在「语言专区」或其他频道询问是否有满足你需求的插件
插件下载后无法加载怎么办？
- 检查文件位置：确保插件文件放在正确的
plugins目录下 - 检查文件完整性：确认下载的文件没有损坏
- 查看日志：检查
logs目录下的日志文件，查找错误信息 - 检查依赖：确认是否安装了插件所需的 Python 依赖包
- 寻求帮助：在 Kook 社区的相关频道询问，或联系插件作者
如何更新已安装的插件？
- 通过 Git 安装的插件：在插件目录下执行
git pull - 通过文件下载的插件：重新下载最新版本，覆盖旧文件
- 记得重启 Bot：更新后需要重启 Bot 以使更改生效
参与插件开发
如果你对 MoFox 的插件开发感兴趣，想要为社区贡献自己的一份力量，我们非常欢迎！
我们为你准备了详细的插件开发文档，希望能帮助你快速上手。
贡献者
minecraft1024a
