zdiscord开源项目使用与部署教程

zdiscord开源项目使用与部署教程

zdiscord A Discord bot that runs in FiveM for the purpose of whitelisting, moderation and utilties using discord.js 项目地址: https://gitcode.com/gh_mirrors/zd/zdiscord

1. 项目介绍

zdiscord 是一个运行在 FiveM 上的 Discord 机器人，主要用于玩家白名单管理、游戏内玩家管理和提供实用工具。它使用 discord.js 库开发，目标是提供一个易于设置和扩展的资源，使工作人员能够轻松地在游戏中支持和管理玩家，而无需启动 FiveM。该项目还支持 QBCore 框架的大部分功能，但并非必须使用。

2. 项目快速启动

以下是快速启动 zdiscord 项目的步骤：

首先，确保你的 FiveM 服务器满足以下要求：

• FiveM 艺术品版本 4890 或更高
• 将 cfx-server-data 添加到你的资源中

步骤 1: 获取机器人应用程序

如果你还没有 Discord 机器人应用程序，请按照以下指南进行操作。确保在机器人页面上启用两个意图（Intents），否则机器人将无法工作。

步骤 2: 添加机器人到服务器

复制以下链接，将 YOUR-BOT-ID 替换为你的机器人 ID，然后按照邀请过程将机器人添加到你的 Discord 服务器。

https://discord.com/api/oauth2/authorize?client_id=YOUR-BOT-ID&permissions=116928&scope=bot applications.commands

如果机器人已经在你服务器中，你可能需要再次运行上述链接以确保机器人可以获得所需的命令范围。

步骤 3: 配置服务器

1. 将 zdiscord 资源复制到你的 FiveM 资源目录中，确保文件名为 zdiscord。

2. 在 server.cfg 文件中，添加以下内容：

   ensure zdiscord
   add_ace resource.zdiscord command allow
   add_ace group.zdiscordstaff zdiscord.staffchat allow
   

3. 调整 config.js 中的变量以符合你的需求。

步骤 4: 启动服务器

完成以上步骤后，启动你的 FiveM 服务器。

3. 应用案例和最佳实践

• 白名单管理：使用 zdiscord 机器人，你可以轻松地将玩家添加到白名单中，无需在游戏内进行操作。
• 玩家管理：机器人提供了踢出、封禁、检查等 moderation 工具，方便管理玩家。
• 实用工具：提供各种实用工具，如屏幕截图命令等。

最佳实践包括：

• 定制命令：根据需要轻松扩展和定制命令。
• 权限系统：自动 Ace 权限授予系统，简化权限管理。

4. 典型生态项目

zdiscord 作为 FiveM 和 Discord 之间的桥梁，可以与多个开源项目结合使用，例如：

• FiveM 资源：提供各种 FiveM 资源来增强游戏体验。
• Discord.js 库：用于开发与 Discord 交互的机器人。
• QBCore 框架：为 FiveM 服务器提供核心功能的框架。

通过这些项目的组合，可以构建一个功能丰富且高度可定制的在线游戏社区。

zdiscord A Discord bot that runs in FiveM for the purpose of whitelisting, moderation and utilties using discord.js 项目地址: https://gitcode.com/gh_mirrors/zd/zdiscord