# MineAds 监控插件
我们在 MineAds 提供此插件，以帮助 Minecraft 服务器所有者将他们的服务器与我们的分析平台集成。它会自动跟踪服务器活动，例如玩家加入、离开、聊天和命令，然后将这些数据发送给我们进行分析。
## 我们如何使用它
作为服务器分析平台，我们从注册其网络的服务器处收集数据。我们使用这些信息为服务器所有者提供详细的分析，帮助他们了解玩家行为，优化他们的服务器并改善其社区的体验。这些数据还有助于我们增强平台的见解。
## 设置说明
1. 下载与您的服务器类型（Bukkit/Spigot/Paper、BungeeCord 或 Velocity）匹配的插件 JAR 文件。
2. 将 JAR 文件放置在服务器的 plugins 文件夹中。
3. 重启服务器以生成配置文件。
4. 在 plugins/MineAdsMonitor 文件夹中打开 `config.yml` 文件。
5. 添加您从 MineAds 仪表板获得的唯一插件密钥（以“pluginkey_”开头）。
6. 设置一个服务器 ID，例如“survival-main”，以识别此服务器。
7. 保存文件并再次重启服务器。
## 配置文件选项
该插件使用简单的 YAML 格式来配置其设置。以下是每个选项的作用：
- **pluginKey**: 您从 MineAds 获得的特殊密钥，将您的服务器与他们的系统关联。您可以在他们的网站上获得此密钥。
- **serverId**: 您服务器的名称，例如“creative-hub”或“pvp-arena”，只使用字母、数字和连字符。
- **enabledEvents**: 选择要跟踪的玩家活动类型。默认情况下，它跟踪所有内容：购买、聊天、命令、加入和离开。
- **disableChatContent**: 如果您不想发送玩家在聊天中键入的实际文字（仅发送他们聊天过）请打开此选项。
- **defaultMaxCommandArgs**: 记录命令部分的数量。例如，默认情况下，“/warp home” 将保存 1 部分（仅“warp”）。
- **commandArgLimits**: 为特定命令设置不同的限制，例如允许为“/warp”命令提供更多详细信息。
- **debug**: 打开此选项以在服务器控制台中查看额外的消息以进行故障排除。
## 命令
该插件包含服务器管理员命令（您需要“mineadsmonitor.admin”权限）：
- **/mineadsmonitor help**: 显示所有可用命令。
- **/mineadsmonitor version**: 告诉您正在运行的插件版本。
- **/mineadsmonitor reload**: 在不重启服务器的情况下重新加载配置文件。
- **/mineadsmonitor initial/expiry/renewal/chargeback/refund** [details]: 手动记录与购买相关的事件（例如，当某人购买或失去一个等级时）。
## 性能和延迟预防
为了保持服务器的平稳运行，该插件的设计非常轻量级：
- 它在后台收集数据，而不会降低游戏速度。
- 代替立即发送数据，它将事件组合在一起，每 10 秒发送一次。
- 所有网络请求都在单独的线程上发生，因此它们永远不会中断服务器的主要操作。
- 在发送之前压缩数据以使用更少的带宽。
- 如果存在连接问题，它将以智能延迟自动重试，以避免过度消耗您的服务器资源。