🎉 StreamingDrops 是一款 Minecraft 的 Twitch 集成插件，它提供了多种功能，包括 Twitch 观众可以通过观看直播获得 Minecraft 掉落奖励（类似于 Twitch 游戏掉宝）。此外，插件还能在服务器上显示正在直播的主播，主播可以直接在 Minecraft 中查看 Twitch 聊天内容，或者在 Twitch 聊天中使用 Minecraft 内容相关的指令。Twitch 奖励（频道积分）的集成也支持积极或消极的操作。

🎮 主要特性

• 可以设置 Twitch 掉落奖励（物品、金钱、箱子、等级等等）。
• 支持添加多个主播。
• 无需 Streamkeys 或 oAuth-Keys。
• 可以更改掉落几率。
• 当主播上线时，自动广播消息和 Discord 公告。
• 通过 PlaceholderAPI 实现主播 Livetag。
• 支持离线掉落。
• 支持 Mod/Forge 服务器。

⚙️ 要求

• Java 11+
• HTTPS 端口已开放
• "StreamingModule"（Twitch 机器人）必须是您的 Twitch 频道的版主
• 某些服务器会阻止传出消息/请求。这会通过带有 HTTP(S) 错误代码的 "/online" 命令的错误消息来表达。请在此处检查端口是否已相应释放。

🛠️ 安装

1. 停止服务器。
2. 将 jar 文件拖放到 "plugins" 文件夹中。
3. 可选：下载 PlaceholderAPI 插件。
4. 可选：将 PlaceholderAPI jar 文件拖放到 "plugins" 文件夹中。
5. 启动服务器。

启动服务器后，将创建一个新的 "StreamingDrops" 文件夹，其中包含所有配置文件。从现在开始，可以进行所有个人设置并使用该插件。不要忘记重新加载配置 ("/sd reload") 或重新启动服务器。

⚙️ 设置

为了正确设置 StreamingDrops，以下几点很重要：

1. 在 "settings.yml" 文件中，必须在 "AllowedStreamer" 选项下输入流名称。此处必须使用 Twitch 频道名称。也可以通过使用命令 "/sd streamer add [Twitch channel]" 在游戏中/在控制台中完成此操作。如果您不想在配置文件的较低部分自己添加主播特定部分，我建议通过命令执行此操作。

2. 设置主播后，必须设置允许掉落的世界。为此，请在文件 "Settings.yml" 中使用选项 "AllowdWorlds"。

3. 设置您的掉落。第一次测试不需要设置掉落，因为默认配置中已经有 3 个示例掉落。如果您想自定义这些掉落，则命令列在 "settings.yml" 文件中的 "GeneralDrops" 下。可以在控制台中以这种方式输入所有命令。因此，也支持其他插件。完成配置后，请使用命令 "/sd reload"。如果调整了值 "Interval"，则命令 "/sd reload force" 很重要。或者，可以重新启动服务器。

4. 现在主播/玩家进入 Minecraft 服务器。如果 Twitch 频道的名称与 Minecraft 中的名称不完全相同，则必须输入命令 "/twitch [twitch channel name / username]" 一次（例如：“/twitch MorelaidOnAir”）。这将 Minecraft 帐户与 Twitch 帐户链接起来。

5. 在您的 Twitch 聊天中使用 "/mod StreamingModule" 将机器人添加到您的版主。这是获取您频道 Twitch 观看者所必需的。

6. 主播现在在 Twitch 上上线并加入 Minecraft 服务器。Minecraft 玩家登录 Twitch 并观看直播。每隔 X 分钟（X = "Settings.yml" 中的 "Interval" 值，以分钟为单位），随机掉落将分配给观看者。如果您想测试掉落而不等待自动间隔，主播可以执行命令 "/drops test"。这将向主播的观看者发送随机掉落。间隔将继续正常运行。

7. 请注意，新观看者不会立即被识别（需要 2-6 分钟）。

⌨️ 命令和权限

通用命令

• /streamingdrops reload - streamingdrops.reload
• /streamingdrops streamer add [name] - streamingdrops.streamer.add
• /streamingdrops streamer remove [name] - streamingdrops.streamer.remove
• /streamingdrops drop test - streamingdrops.drop.test
• /streamingdrops drops [name] - streamingdrops.drops
• /streamingdrops twitch [name] - 无需权限
• /streamingdrops online - streamingdrops.online
• /streamingdrops report - streamingdrops.report

配置文件示例

settings.yml

Settings:
  Prefix: '&8[&5StreamingDrops&8] '
  Interval: 3
  AllowedStreamer:
  - MorelaidOnAir
  AllowedWorlds:
  - world
  - world_nether
  AutomaticBroadcast:
    Enabled: true
    Interval: 15
    Message: '&7The streamer &5%streamingdrops_streamer% &7is now live and playing &5Minecraft&7.
      Watch his stream to get a drop!'
  DiscordIntegration:
    Enabled: false
    WebhookUrl: 'YOUR_WEBHOOK_URL'
    Message: '&7The streamer &5%streamingdrops_streamer% &7is now live and playing &5Minecraft&7.
      Watch his stream to get a drop!'
  NoStreamerOnline: '&cNo streamer is currently online.'
  StreamerIsOffline: '&cThe streamer is currently offline.'
  InvalidUsage: '&cInvalid usage. Please use: &7/sd &8[&5help&8/&5reload&8/&5addstreamer&8/&5removestreamer&8/&5testdrop&8]'
  NotAllowedWorld: '&cYou are not in a allowed world.'
  StreamerAdded: '&7You have added &5%streamingdrops_streamer% &7to the allowed streamers.'
  StreamerRemoved: '&7You have removed &5%streamingdrops_streamer% &7from the allowed streamers.'
  StreamerList: '&7List of all allowed streamers: &5%streamingdrops_allowedstreamer%'
  NoDropsAvailable: '&cNo drops are currently available.'
  OnlyStreamer: '&cOnly the streamer can use this command.'
  NoStreamerFound: '&cNo streamer found with the name &5%args_1%&c.'
  DropReceived: '&7You have received a drop from &5%streamingdrops_streamer%&7.'
  TwitchNameSet: '&7Your twitch name has been set to &5%args_1%&7.'
  TwitchNameAlreadySet: '&cYour twitch name is already set.'
  TwitchNameNotValid: '&cYour twitch name is not valid.'
  OnlineCheckEnabled: true
  OnlineCheckInterval: 1
  OnlineCheckMessage: '&a%streamingdrops_online% Player are watching %streamingdrops_streamer%'
  Metrics: true
GeneralDrops:
  '1':
    Chance: 30
    Commands:
    - give %player% diamond 1
    Message: '&7You have received a diamond from &5%streamingdrops_streamer%&7.'
  '2':
    Chance: 50
    Commands:
    - eco give %player% 100
    Message: '&7You have received 100$ from &5%streamingdrops_streamer%&7.'
  '3':
    Chance: 20
    Commands:
    - crate give %player% common 1
    Message: '&7You have received a crate from &5%streamingdrops_streamer%&7.'
Streamer:
  MorelaidOnAir:
    DropAmplifier: 1
    Whitelist: false
    DropOnlyIfOnline: true

🙋 支持 / Bug / 建议

• Discord: https://discord.gg/5zuC36R
• Spigot: 讨论 / 私信

对于请求、评论或出现的错误，我很乐意提供帮助。为了能够快速提供帮助，如果查询期间已经填写了以下信息，我将不胜感激：

1. 执行 "/sd report"
2. 从您的插件文件夹 (".../plugins/StreamingDrops/Report.zip") 发送您的文件 "report.zip"
3. 简要描述您的问题

请求可以用德语或英语提出。