\u2699\ufe0f Core Systems<\/p>\n
1. Twitch Account Linking
\nPlayers can link their Minecraft account to their Twitch account using a simple in-game command. This is the foundation for tracking watch time and rewards.<\/p>\n
– **Command**: `\/linktwitch 2. Streamer Configuration – **Configuration**: Set the `twitch_channel` and `twitch_link` in `config.yml`. 3. Live Announcements – **Configuration**: Enable or disable this feature and customize the message in `config.yml`. 4. Watch Time Tracking System – **Logic**: An asynchronous task runs every second to check the streamer’s live status and update the watch time for online, linked players. 5. Reward Interval Logic – **Configuration**: Set the `reward_interval` (in seconds), `reward_type` (`points` or `item`), and the `reward` itself in `config.yml`. 6. Offline Reward Handling – **Logic**: A `PlayerJoinEvent` listener checks for unclaimed rewards and generates a redeem code. 7. Redeem Code System - **Storage**: Codes are stored in `redeemcodes.yml` with their `reward_type`, `reward`, and `uses_left`. 8. Streamer Reward Code Generation - **Command**: `\/twitchreward generate` 9. Twitch Points System - **Storage**: Player point balances are stored in `twitchpoints.yml`. 10. Watch Time Tracking (via Twitch IRC) - **How it works**: Part 1: Setting up the Twitch Extension<\/p>\n 1. **Create a new Twitch Extension**: 2. **Get your Extension Credentials**: 3. **Generate and Upload the Frontend Files**: ---<\/p>\n Part 2: Setting up the Minecraft Plugin<\/p>\n 1. **Install the Plugin**: 2. **Configure the Plugin**: ---<\/p>\n Part 3: Final Steps<\/p>\n 1. **Activate the Extension**: 2. **Test the System**: You have now successfully set up the complete TwitchRewards999 system!<\/p>\n ---<\/p>\n \ud83d\udcac Commands<\/p>\n | Command | Description | Permission | TwitchRewards999 is a comprehensive plugin for Minecraft designed to bridge the gap between your Twitch stream and your Minecraft server. It rewards players for their watch time, fostering a more engaging and interactive community.<\/p>\n","protected":false},"featured_media":160935,"template":"","meta":{"_minecraft_slug":"twitchrewards999","_minecraft_project_id":"V24XxMn8","_minecraft_author":"Erik9994857","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":44,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"twitchrewards999.zip","_minecraft_size_bytes":18362136,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:30:48.342620Z","_minecraft_date_created":"2025-11-18T00:18:59.082614Z","_minecraft_date_modified":"2025-11-12T00:26:42.957712Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/twitchrewards999","_minecraft_icon_attachment_id":160935,"_minecraft_imported_at":"2026-06-09T15:09:31+00:00","_minecraft_import_hash":"a97460389f011dc472f3ea28c4f25ef5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,867,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-160934","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Storage**: Linked accounts are stored in `usernames.yml` in the format `twitch_username: minecraft_uuid`.<\/p>\n
\nServer administrators can easily configure the main Twitch channel to be tracked. The plugin will monitor this channel for live status updates.<\/p>\n
\n– **API Integration**: Requires a Twitch Client ID and Secret to be added to the `config.yml` for Twitch API communication.<\/p>\n
\nWhen the configured streamer goes live, a customizable announcement is broadcast to all players on the server, encouraging them to join the stream.<\/p>\n
\n– **Example Message**: `\u00a7d[Live] %streamer% is now streaming! Watch at: %streamlink%`<\/p>\n
\nThe plugin tracks the watch time of all linked players who are online on the Minecraft server while the streamer is live.<\/p>\n
\n– **Storage**: Watch time data is stored in `time.yml` for each player, including `seconds_watched` and `unclaimed_rewards`.<\/p>\n
\nRewards are automatically granted to players based on a configurable time interval.<\/p>\n
\n– **Example**: If `reward_interval` is 600, a player will receive a reward for every 10 minutes of watch time.<\/p>\n
\nIf a player earns a reward while they are offline, the plugin stores it as an “unclaimed reward”. When the player logs back in, they are notified and given a unique code to redeem their rewards.<\/p>\n
\n– **Notification**: The player receives a message like: `\u00a7eYou\u2019ve earned rewards for watching %streamer%! Use \/twitchredeem to claim them.`<\/p>\n
\nA flexible system for redeeming rewards using unique codes. Codes can be generated automatically for offline rewards or manually by streamers\/admins.<\/p>\n
\n- **Expiration**: Codes are automatically removed when their `uses_left` reaches 0.<\/p>\n
\nStreamers and administrators can generate custom reward codes to share with their audience during a stream.<\/p>\n
\n- **Configuration**: The reward type, value, and number of uses for generated codes can be configured in `config.yml`.<\/p>\n
\nAn in-plugin currency system that allows players to accumulate \"Twitch Points\" as rewards.<\/p>\n
\n- **Command**: Players can check their balance with `\/twitchpoints`.<\/p>\n
\nTo provide an accurate watch time tracking system, TwitchRewards999 now integrates directly with Twitch IRC. This system tracks players who are actively participating in the stream's chat.<\/p>\n
\n 1. The Minecraft plugin connects to the streamer's Twitch chat via Twitch IRC.
\n 2. It tracks users who join or leave the chat, and those who send messages.
\n 3. Only players who are identified as active chatters will have their watch time tracked.
\n- **Setup**:
\n 1. Configure your Twitch Client ID, Client Secret, and OAuth Token in the plugin's `config.yml`.<\/p>\n
\n - Go to the Twitch Developer Console.
\n - Click on \"Extensions\" in the left-hand menu.
\n - Click \"Create an Extension\".
\n - Give your extension a name (e.g., \"MyRewardsExtension\") and select \"Panel\" as the extension type.
\n - Click \"Create Extension\".<\/p>\n
\n - In your extension's dashboard, you will see your **Client ID**.
\n - Click on the \"Settings\" tab. Your **Extension Secret** is here.<\/p>\n
\n - Start your Minecraft server with the TwitchRewards999 plugin installed. This will automatically generate the `extension_frontend` folder containing `panel.html` and `viewer.js` in the same directory as your plugin's configuration folder (e.g., `plugins\/TwitchRewards999\/extension_frontend`).
\n - Go to the \"Asset Hosting\" tab in your extension's dashboard.
\n - Drag and drop the contents of the newly generated `extension_frontend` folder (`panel.html` and `viewer.js`) into the upload area.
\n - Set the \"Panel Viewer Path\" to `panel.html`.
\n - Click \"Save Changes\".<\/p>\n
\n - Place the `TwitchRewards999-1.0.0.jar` file (from the `target` directory) into your Spigot server's `plugins` folder.
\n - Start your Minecraft server. This will generate the plugin's configuration files.<\/p>\n
\n - Open the `plugins\/TwitchRewards999\/config.yml` file.
\n - Set the `twitch_channel` to your Twitch username (the channel you want to track).
\n - Set the `twitch_link` to your Twitch channel URL.
\n - Fill in your `twitch_client_id` and `twitch_client_secret` (the same ones from your Twitch Extension).
\n - **Obtain a Twitch OAuth Token:**
\n - Go to a Twitch Chat OAuth Password Generator (e.g., https:\/\/twitchapps.com\/tmi\/).
\n - Authorize the application to get your OAuth token. It will start with `oauth:`.
\n - Copy the full token.
\n - Set the `twitch_oauth_token` in `config.yml` to the OAuth token you just obtained.
\n - Customize the rest of the settings (rewards, messages, etc.) to your liking.
\n - Save the `config.yml` file and restart your server or run `\/twitchreload`.<\/p>\n
\n - Go back to your Twitch Extension's dashboard.
\n - Go to the \"Version Status\" tab and follow the steps to move your extension to \"Hosted Test\" and then to \"Released\".
\n - Once released, you can install the extension on your own channel by going to your Creator Dashboard -> Extensions -> My Extensions.<\/p>\n
\n - Start streaming on Twitch with the extension active.
\n - Have a player link their Twitch account in-game with `\/linktwitch
\n - Watch the stream for the configured `reward_interval`.
\n - You should see rewards being granted in-game.
\n - Check the server console for any errors.<\/p>\n
\n| ----------------------------- | ------------------------------------------------- | ------------------- |
\n| `\/linktwitch
\n| `\/twitchpoints` | Shows your current Twitch Points balance. | (everyone) |
\n| `\/twitchreward generate` | Generates a reward code for the streamer to share.| `twitchreward.admin`|
\n| `\/twitchredeem ` | Redeem a stored or shared reward code. | (everyone) |
\n| `\/twitchreload` | Reloads the plugin's configuration and data. | `twitchreward.admin`|
\n| `\/twitchtime