StreamSync TikTok LIVE Interactive & Stream Challenges [1.16 - 1.26.x]

Why StreamSync?
Most interactive streaming plugins require paid subscription services or external relay apps. StreamSync runs 100% natively on your server, establishing a direct, lightweight WebSocket connection to TikTok Live.
Whether you are doing "Every TikTok gift spawns a Warden", "Chat controls my game", or "Survive 30 minutes in Minecraft while viewers spawn traps", StreamSync provides everything out of the box with zero setup hassle.
Key Features Overview

• Direct TikTok LIVE WebSocket Client: Instant event delivery directly to your server. No subscription fees, no proxy software.
• Interactive Chat Commands: Viewers type triggers like !creeper, !tnt, !freeze, !heart, !slap directly in the TikTok chat.
• Gift Reactions: Configure custom rewards or traps for individual gifts (Rose, Panda, TikTok, Lion, etc.).
• Like Milestones & Follows: Automatically reward the streamer or trigger chaos whenever viewers hit like goals or follow the channel.
• Thread-Safe Queue Manager: Intelligent async event processing with queue rate-limiting to protect server TPS during viral stream spikes.
• In-Game Live Management: Create triggers, toggle settings, and modify active goals without ever touching YAML files or restarting the server.
• Multi-Streamer Support: Target specific streamer accounts or let the plugin automatically target the single online player.
• Modern Visuals: Clean cyan & white color palette (&#74ACF6 & &f) with full HEX RGB support.

Advanced Challenge System (Goals)
Turn your live streams into interactive survival challenges! StreamSync features a built-in goal engine designed specifically for stream challenges:

• 6 Challenge Modes:
  • SURVIVE: Streamer must survive for a set time (e.g. 24m, 30s, 1h). Viewers can add or remove time via events!
  • MINE_BLOCKS: Mine a target amount of blocks (e.g. 25 Iron Ore).
  • KILL_MOBS: Eliminate specific mobs (e.g. 10 Skeletons, 5 Creepers).
  • KILL_PLAYERS: Defeat enemy players or hunters.
  • GET_ITEM: Collect a required item into inventory (e.g. 1 Diamond, 1 Golden Apple).
  • RANDOM: Automatically selects and rotates through challenges continuously.
• Smart Block Matching: Automatically handles ore variants! Mining Deepslate Iron Ore counts towards an Iron Ore challenge.
• Dynamic Position Shift (newGoalNewPosition): When enabled, completing a challenge safely teleports the streamer to a fresh, distant safe coordinate (between 2,000 and 10,000 blocks away) to start the next challenge in unfamiliar territory!
• Die-Lose Penalty: Option to instantly fail challenges if the streamer dies to mobs, traps, or viewer attacks.
• BossBar & ActionBar Display: Real-time visual progress bar with smooth percentage calculation.

15+ Interactive Action Types
Customize any trigger, gift, or like event using our powerful action system:

• SPAWN_MOB — Spawn any mob with custom names, fire, glowing effects, and equipment.
• EFFECT — Grant potion effects (Blindness, Levitation, Darkness, Slowness, Speed, etc.).
• TRAP — Trap the streamer in temporary cages (Cobwebs, Obsidian, Ice, Slime blocks).
• HEART — Heal the player, deal damage, or modify maximum hearts.
• FREEZE — Completely immobilize the streamer's movement for a set duration.
• SLAP — Knock the player backward with light damage and sound.
• JUMPSCARE_SOUND — Play sudden loud ambient sounds (Elder Guardian curse, Creeper hiss).
• LAUNCH_UP — Launch the streamer into the sky.
• LIGHTNING — Strike dramatic lightning at the player's position.
• EXPLOSION — Trigger safe visual explosions or real destructive blasts.
• IGNITE — Set the streamer on fire for X seconds.
• SPIN — Dramatically rotate the streamer's camera angle.
• ANVIL_FALL — Drop an anvil from above the player.
• LOOK — Force the streamer to look directly up at the sky or down at the ground.
• ITEM_GIVE — Drop or insert items into the streamer's inventory.
• COMMAND — Run any custom server command with %player% placeholders.

PlaceholderAPI Integration
StreamSync seamlessly integrates with PlaceholderAPI so you can display live stream stats on your Scoreboard, Tablist, Chat, or Holograms:

• %streamsync_status% — Current live connection status (ONLINE / OFFLINE)
• %streamsync_tiktok_user% — Connected TikTok account name
• %streamsync_goal_type% — Active challenge type (e.g. SURVIVE)
• %streamsync_goal_target% — Target goal value or time
• %streamsync_goal_current% — Current progress counter
• %streamsync_goal_progress% — Formatted progress (e.g. 18/25)
• %streamsync_goal_percent% — Completion percentage (e.g. 72%)
• %streamsync_goal_time% — Remaining survival time (e.g. 23m 15s)
• %streamsync_streamers% — Names of registered active streamers
• %streamsync_queue_size% — Events waiting in the queue

⌨️ Commands & Permissions
All administrative commands require the streamsync.admin permission (default: OP):

• /ss connect <username> — Connect directly to a live TikTok stream
• /ss disconnect — Disconnect from the current stream
• /ss status — View connection state, active streamers, and queue health
• /ss streamer <add|remove|list> [player] — Manage players receiving stream events
• /ss settings actions <list|create|remove> — Create and delete interactive triggers in-game
• /ss settings config <key> [true|false] — Toggle features live (tiktok-enabled, likes-enabled, gifts-enabled, chat-show)
• /ss settings goal list — View current challenge rules and progress
• /ss settings goal start / stop — Start or cancel the active challenge
• /ss settings goal set <type> [target] [target-type] — Change challenge mode and targets
• /ss settings goal settings <key> <true|false> — Toggle challenge rules (die-lose, newGoalNewPosition, bossbar, actionbar, auto-restart)
• /ss settings goal time <add|remove> <time> — Add or remove time during a survival goal (e.g. 1m, 30s)
• /ss settings goal test <win|lose> — Simulate challenge victory or failure
• /ss test <gift|likes|chat|follow> [args] — Simulate TikTok events without being live
• /ss reload — Reload all configuration files
• /ss clear — Clear pending event queue

⚙️ Configuration Files
StreamSync generates 4 clean, fully-commented configuration files:

• config.yml — Core settings, event toggles, queue rate limits.
• actions.yml — Configured chat triggers, gifts, like milestones, and custom action parameters.
• goal.yml — Challenge parameters, BossBar/ActionBar styles, rewards, and teleport ranges.
• messages.yml — All in-game messages, chat formats, prefixes, and notifications (full HEX color support).

Quick Installation Guide

1. Download StreamSync-1.0.jar.
2. Place it into your server's plugins/ directory.
3. (Recommended) Install PlaceholderAPI for scoreboard integration.
4. Start or restart your Minecraft server.
5. Start your TikTok live stream on your phone or PC.
6. Type /ss connect <your_tiktok_username> in-game or console.
7. You are live and ready to play!