Bots & Automation 入门指南

本指南将帮助您在 ServerPrism 上设置您的 Bots & Automation 服务器。您将学习如何部署服务器、配置您选择的机器人，并使其在您的平台上运行。

开始之前

在订购之前，请确定您想要运行的机器人。每个机器人都需要与其交互的平台（例如 Twitch、Discord、游戏服务器）提供特定的令牌或 API 密钥。请提前获取这些密钥。

在 ServerPrism 上订购

1. 选择套餐：从 ServerPrism 订购页面选择 Bots & Automation 游戏。我们建议基本机器人至少选择 2 GB RAM，对于更复杂的设置或多个实例，则选择 8 GB RAM。
2. 选择区域：选择离您的目标受众或您自己最近的数据中心位置，以获得最佳性能。
3. 选择您的机器人：在订单配置页面上，从可用选项中选择您想要的机器人运行时（例如 PhantomBot、SogeBot、JTS3ServerMod）。这将为您安装核心文件。
4. 部署：完成您的订单。您的服务器将自动开始部署。

首次启动

部署后，您的服务器将首次启动。首次启动会下载您所选机器人所需的任何剩余依赖项。您可以在 ServerPrism 面板的控制台 (Console) 选项卡中监控进度。当控制台输出显示机器人已成功启动时（通常通过显示“Bot started”或“Listening for commands.”等消息），服务器就准备好了。

连接/邀请玩家

机器人通常不像游戏服务器那样有直接的“连接”。相反，它们使用您提供的凭据连接到平台（如 Twitch 或 Discord）。配置完成后，机器人将在该平台内运行。对于管理游戏服务器的机器人（如 Big Brother Bot B3 或 JTS3ServerMod），机器人会连接到游戏服务器的 RCON 或查询端口。

配置基础知识

根据机器人的不同，您的机器人配置通过文件或环境变量完成。

PhantomBot

1. 访问文件：使用 ServerPrism 面板的文件管理器 (File Manager) 或 SFTP 导航到服务器的 phantombot 目录。
2. 编辑 botlogin.txt：此文件包含您的 Twitch 频道、机器人用户名和 OAuth 令牌。按照文件中的说明输入您的凭据。
3. 编辑 config.ini：在此处调整通用机器人设置，如命令前缀、语言和模块配置。
4. 重启：保存更改后，从 ServerPrism 面板的控制台 (Console) 或电源 (Power) 选项卡重启服务器以使更改生效。

SogeBot

SogeBot 主要使用环境变量进行初始设置。

1. 启动变量：转到 ServerPrism 面板中的启动 (Startup) 选项卡。
2. 设置 TWITCH_USERNAME 和 TWITCH_OAUTH：在此处输入您的 Twitch 机器人用户名和 OAuth 令牌。您可能还需要为目标 Twitch 频道设置 CHANNEL。
3. 其他设置：查阅 SogeBot 文档以获取其他可用的环境变量进行高级配置。
4. 重启：从 ServerPrism 面板重启服务器以应用更改。

JTS3ServerMod

1. 访问文件：使用 ServerPrism 面板的文件管理器 (File Manager) 或 SFTP。
2. 导航：转到 config/server1/。
3. 编辑 JTS3ServerMod_server.cfg：这是主要的配置文件。编辑您的 TeamSpeak 3 服务器查询地址、端口、用户名、密码和特定模块配置等设置。
4. 保存并重启：保存文件并从 ServerPrism 面板重启服务器。

Big Brother Bot (B3)

1. 访问文件：使用 ServerPrism 面板的文件管理器 (File Manager) 或 SFTP。
2. 导航：转到 b3/conf/。
3. 编辑 b3.xml：这是主要的配置文件。您需要配置数据库连接（SQLite 通常是默认且足够的）、游戏服务器详细信息（IP、端口、RCON 密码）和管理设置。
4. 编辑 plugins.xml：在此处启用或禁用特定的 B3 插件。
5. 保存并重启：保存所有更改并从 ServerPrism 面板重启服务器。

常见问题

• 机器人未连接到平台：仔细检查您的 API 密钥、OAuth 令牌和用户名是否有拼写错误。确保它们在平台上具有正确的权限（例如，Twitch 机器人的管理员状态）。
• 机器人未启动：检查控制台 (Console) 选项卡中的错误消息。缺少依赖项、不正确的文件路径或无效的配置语法是常见原因。如果您对配置文件进行了更改，请逐一恢复它们以隔离问题。
• 命令不起作用：验证机器人是否成功连接以及命令前缀是否正确。对于游戏服务器机器人，请确保游戏服务器的 RCON 密码和 IP 在机器人的设置中配置正确。
• 资源使用率过高：如果您的机器人消耗过多的 RAM 或 CPU，请检查其配置。某些模块或功能可能占用大量资源。如有必要，请通过客户仪表板升级您的 ServerPrism 套餐。

后续步骤

一旦您的机器人运行起来，请探索其全部功能：

• 模块/插件管理：大多数机器人允许您启用、禁用或配置额外的模块或插件以扩展功能。
• 自定义命令：了解如何添加特定于您的社区或游戏服务器的自定义命令。
• 运行时切换：如果您想尝试不同的机器人，可以直接从 ServerPrism 面板的启动 (Startup) 选项卡切换服务器的运行时，而无需重新订购服务器。
• 社区支持：许多机器人都有活跃的社区或文档，您可以参考它们进行高级设置。如果您遇到持续性问题，请在 https://serverprism.com/tickets 提交支持工单，提供您的服务器 ID 和任何相关的控制台日志。