TikTokLIVE - TikTokLIVE

💡TikTokLive 简介

TikTokLive 是一款免费的 Minecraft 插件，旨在将 TikTok 直播中的打赏、关注等事件与您的游戏服务器连接起来。它由社区愿望驱动而生，目前处于 Beta 测试阶段，欢迎您一同参与完善。

---

🎮核心功能

• 连接 TikTok 直播：通过 TikFinity 服务，将直播事件（如礼物、关注）同步到 Minecraft。
• 自定义动作：为不同事件配置游戏内响应，如执行命令、发送消息、播放音效、传送玩家或生成生物。
• 玩家选择系统：可指定单个玩家、首个加入的玩家或所有在线玩家来接收事件动作。
• 反垃圾信息：内置机制防止短时间内大量事件触发造成的刷屏。
• 双连接模式：支持通过插件作者的 Web 服务器中转数据，也支持启用传统的 Socket 直连模式（需自行配置端口转发）。

---

🔧安装与配置指南

第一步：安装插件

• 下载插件文件。
• 将 .jar 文件放入您服务器的 plugins 文件夹。
• 启动或重启服务器。
• 在服务器控制台输入 /plugins，确认 TikTokLive 插件已成功加载。

第二步：配置插件与 TikFinity

• 在服务器的 plugins/TikTokLive 目录下找到并编辑 config.yml 文件，根据您的需求调整设置。
• 访问 TikFinity 网站并注册/登录。
• 在 TikFinity 网站左侧栏点击 “Actions & Events”。
• 在 Minecraft 游戏内或控制台中，由 OP 权限玩家或控制台执行命令 /tiktoklive generate。
• 复制命令返回的链接。
• 在 TikFinity 网站点击 “Create new Action”，任意命名，然后启用 “Trigger Webhook” 选项。
• 将第 5 步复制的链接粘贴到 Webhook 地址框中，并保存该 Action。
• 您现在可以在 TikFinity 中定义各种事件（如收到特定礼物），并将其关联到您在 config.yml 中配置的 Minecraft 动作。

重要提示

• Beta 阶段：插件可能存在漏洞，发现问题请至 Discord 反馈。
• 数据安全说明：默认使用插件作者的 Web 服务器中转数据。如果您担心数据安全，可在 config.yml 中启用 Socket.Legacy 模式进行直连，但这需要您在路由器上开放配置的端口。
• 事件名称设置：由于 TikFinity/TikTok 的接口问题，为确保事件准确触发，强烈建议将您在 TikFinity 中创建的 Action 名称，设置为 config.yml 里对应的 GiftID 或您自定义的动作名称。

---

⭐命令与权限

• /tiktoklive reload

- 功能：重载插件配置文件并重启 Socket 连接。

- 权限：`tiktoklive.reload`

• /tiktoklive generate

- 功能：生成用于连接 TikFinity 的基础 URL。

- 权限：`tiktoklive.generate`

• /tiktoklive addselected <玩家名>

- 功能：将指定玩家添加到“选中玩家”列表。

- 权限：`tiktoklive.add.selected`

• /tiktoklive removeselected <玩家名>

- 功能：将指定玩家从“选中玩家”列表中移除。

- 权限：`tiktoklive.remove.selected`

• /tiktoklive help

- 功能：打开帮助菜单。

- 权限：`tiktoklive.help`

---

❓配置文件详解

config.yml 主要设置

• Enabled：启用或禁用插件。
• Player / AllOnline / FirstWhichJoins / OrName：用于选择接收事件动作的玩家。
• Socket：Socket 连接设置。

- `Legacy`：启用传统直连模式（需公网 IP 与端口转发）。

- `RefreshInTicks`：检查新事件的频率（游戏刻）。

- `IP` / `Port` / `Password`：Socket 连接的 IP、端口和密码。

• Actions：事件动作配置核心。

- 键名（如 `6525, 6661`）：监听的 TikTok 礼物 ID 或您在 TikFinity 中设置的 Action 名称。

- 子项：定义触发事件后执行的动作。

- `Command`：执行的命令（支持多种占位符）。

- `PerformAsConsole`：是否以控制台身份执行命令。

- `Message`：发送给玩家的聊天信息。

- `Actionbar`：发送给玩家的动作栏信息。

- `Sound`：播放给玩家的音效。

- `TeleportPlayer`：传送玩家至新坐标。

- `SpawnMob`：在玩家附近生成生物。

• AntiSpam：反垃圾设置，可限制单位时间内的事件触发频率。
• bStats：是否向开发者发送匿名使用统计。

giftlist.yml

• 此文件包含了已知的 TikTok 礼物 ID、名称及其对应的钻石价值。
• 您可以参照文件内的教程格式，自行添加新的礼物信息。

---

✨开发计划 (Coming Soon)

• 更易用的图形化界面 (GUI) 设置。
• 代码优化与编辑。
• 漏洞修复。
• 实现您的愿望！欢迎在 Discord 中提出想法。

---

🔧支持与反馈

• 如遇任何问题或有功能建议，请加入 Discord 社区：

- 主要支持服务器：https://discord.gg/8QWmU4ebCC

- 功能建议与交流：https://discord.gg/mf9JNrzh

• 请注意：请勿在插件下载页的评论区内报告漏洞，该区域用于收集功能愿望。