SoulFire

高级 Minecraft 机器人工具。部署自动化机器人用于服务器测试、自动化和开发。

本仓库仅包含 CLI 和服务器实现。官方 GUI 客户端位于另一个仓库。

[!WARNING] 此工具仅应用于您拥有或明确获得测试权限的服务器。确保您的托管提供商允许自动化机器人测试。如果您未经授权使用该软件，您（或您的法定监护人）将承担责任；SoulFire 的开发者不对您自己的行为负责。

✨ 您正在为您的服务器寻找一个高级管理面板吗？

EnderDash 允许您通过安装一个插件（功能齐全）使用高级仪表盘来管理您现有的 Minecraft 服务器。执行命令（支持标签补全）、读取日志、管理文件、邀请您的整个团队、管理玩家、Ocelot（AI 助手）、与您的现有基础设施/面板兼容等等。

查看：https://enderdash.com

🚀 功能

GUI（多种主题）& CLI
每个会话均可配置选项，如机器人数量、加入延迟等
加载和保存配置文件以便快速访问
支持在线和离线模式服务器
支持几乎所有 Minecraft 版本
使用 Microsoft（支持凭据和设备代码）和 Offline 账户，适用于 Java Edition 和 Bedrock Edition
使用 HTTP、SOCKS4 和 SOCKS5 代理
多个内置插件，如 AutoRespawn、AutoJump、ClientSettings 等
控制台命令支持
A* 寻路（对角移动、跑酷、挖掘方块、放置方块）

🖥 安装

[!TIP] 想在安装前查看 SoulFire 的外观吗？请查看官方演示页面。

要安装 SoulFire，请参阅安装指南。

🍿 版本支持

您可以在文档中找到最新的受支持版本列表。

⌨ 命令

要查看所有可用命令的列表，请查看文档或在 GUI 或 CLI 中运行 help。

📻 插件

您可以在文档中阅读有关 SoulFire 插件的信息。

🗃 导入账户和代理

您可以在账户文档中阅读如何导入账户，并在代理文档中阅读如何导入代理。

🤿 寻找代理？

有许多网站提供免费代理，但请注意，其中许多不可靠或不安全。

我们推荐的代理提供商是 LegionProxy 和 Proxy-Seller，它们是 SoulFire 的赞助商。

如需查看推荐提供商的完整列表，请访问我们的 Get Proxies 页面。

💻 命令行用法

如果您想使用 SoulFire 的 CLI，请参阅 CLI 模式指南。

🧵 演示

SoulFire 内置了 GUI，便于使用。请在演示页面上亲自尝试 SoulFire 演示。

https://github.com/user-attachments/assets/6244d54c-a1e5-4467-a705-c929b9de2b57

✨ 夜间构建

您可以通过 nightly.link 下载 SoulFire 的最新开发版本

🔧 从源码构建

Install Java 25+
Download the latest source code from GitHub
Run ./gradlew build in the project directory
Get the jar file from client-launcher/build/libs or dedicated-launcher/build/libs

👨‍💻 开发者 API

SoulFire 提供了一个开发者 API，允许您使用插件 API 和混入（mixins）创建自己的插件。该软件可能会定期出现破坏性变更，因此您必须固定使用某个版本的 SoulFire，或定期更新您的插件。

要了解有关 Developer API 的更多信息，请查看官方 plugin example。

SoulFire 还包含 TypeScript 和 Python SDK，用于通过 gRPC-Web 进行连接、流式传输机器人事件、发布当前每个机器人的操作，以及配置本地专用服务器。

🌈 社区

欢迎加入我们的 Discord 社区服务器：

本项目正在积极开发中，因此如果您有任何功能请求或问题，请在此 GitHub 上提交。也欢迎提交 PR。

🏅 赞助商

提供

Windows 上的免费代码签名由 SignPath.io 提供，证书由 SignPath Foundation