Picture

Twitch

StreamerBot

Table of contents

  1. Description
  2. Import Code
  3. Installation
  4. Settings
    1. General Settings
    2. Cost Increase Settings
    3. Reset Settings
  5. Changelog

Description

Let your viewers become champion of the hill and earn a VIP badge by redeeming a channelpoint reward. But be aware! There can only be one champion at a time, so after another user redeems the reward, they’ll steal the title and VIP badge from the former champion.

The description of the reward will automatically update and have the current champion listed. You also have the option to automatically increase the cost upon each use.

Picture


Import Code

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

Installation

  1. Copy the import code from above and import the content

    Import Actions

  2. Create a channel point reward inside StreamerBot and not within Twitch itself. This will make sure that the reward is editable by StreamerBot.

    Go into Platforms -> Twitch -> Channel Point Rewards and add a new one. Give it any name you like. The description will automatically get updated after redemption, so you can just fill it with “There currently is no champion of the hill”. If the reward is not greyed out and the settings are editable, you are good to go.

    Picture

Make sure Redemption Skips Queue stays unchecked.

  1. Assign the reward as the trigger in the [Champion Of The Hill] Main action

    Picture

  2. Already done! Continue with Configuration below.


Settings

General Settings

In the “General Settings” group, you can adjust two different things:

Picture

  • First, you can decide whether you want the cost of the reward to automatically increase upon each use. Therefore, doubleclick the “Set Argument” subaction and set its value for increaseCost to “True”. Otherwise make it “False”.

  • Second, you can also decide whether a permanent VIP (that is not champion of the hill) can become champion of the hill. You can again set it to “True” if a permanent VIP should be able to steal, “False” if not. You can then also set whether the VIP status should be returned to the permanent VIP once he gets pushed off the throne.

Cost Increase Settings

In the “Cost Increase Settings” group, you can decide how the cost should increase and by how much.

There are three different methods: costs can increase linearly, exponentially or have a combination of both. You can change the value to “Linear”, “Exponential” or “Both”.

Picture

  • If “Linear” is selected, the cost will increase by a fixed amount increaseCostTotalPoints. So if the cost is 1000 and the fixed amount set to 250, the next redemption will cost 1250 points.

    Picture

* If "Exponential" is selected, the cost will increase exponentially by the set percent value `increaseCostPercent`. So if the cost is 1000 and the percent set to 10, the next redemption will cost 1100 points.
  • If “Both” is selected, the cost will first increase linearly until it reaches a certain threshold increaseCostThreshold.

    Picture

    So in the example of the screenshots, the cost will increase linearly by 250 until it reaches 5000 points. From then on it will increase exponentionally by 10%. You can edit the treshold to your liking.

Reset Settings

In the [Champion Of The Hill] Reset action, you can decide whether you want a reset to happen and if so, if it should happen on a test trigger or daily, weekly or monthly. A new week starts every monday, a new month every 1st day of the month (surprised pikachu).

For the reset to happen, change False to True.

The reset occurs whenever you start your stream, so if you stream past midnight and want the reset to happen, you’ll have to go into the action and rightclick the “Test” trigger and hit “Test Trigger”.

Picture

After a reset happened, the action will “continue” below the Code group. You can use regular variables like %user% to give the last champion a present, shout them out or whatever you want to do.

Picture


You don’t have to delete the cost increase values from the “Set Argument” subactions if you don’t want to utilize them. In that case, just leave them as it is.

If the current champion gets banned, they’ll get removed automatically.

Ban


Changelog

Date Changes Version
August 20, 2024 Added the option to reset the current champion on a “Test” trigger and resets the reward to its original cost 1.1.2
June 23, 2024 Added a daily/weekly/monthly reset option. Added auto-removal of a champion when they get banned. 1.1.0
May 16, 2024 Changed the global var methods to userId and added a throne claim counter that shows in the reward description 1.0.0