Configuring Pokemon and Friends - Cloud Edition
by Waldo, Silverlink and CodeWithTD
Version: 2.0.2OBS ImportDLLStreamerbot Import
Allow users to catch and collect Pokémon on stream. With an online Pokédex and real catch rates and shinnies, while supporting 8 GENERATIONS. This is the must have for any Pokémon fan's stream!
Be sure to check out the freebies so you can use the Pokemon Game with our Currency System!!
🛒 View on StreamUP Shop💡General Notice
This guide assumes you have the latest StreamUP DLL installed. All required plugins, including the StreamUP plugin, and Streamer.Bot should be up to date. It also assumes you have already imported any fonts, OBS scenes or Browser Sources and Streamer.Bot import files.
Please make sure you have followed the standard product installation steps for StreamUP products.
If you haven't and where appropriate please follow these specifically:
Some steps are accompanied by images, you can click on these images to make them bigger. Where appropriate they have been tagged with Numbers, you can find the corresponding number in brackets (X)
Getting Setup
This section explains how to set up the Pokemon and Friends game. This will help you get it into a working state.
Getting your StreamUP API Key
- Go to https://api.streamup.tips/twitch
- Read the very important notice on the website
- Click the “LOGIN WITH TWITCH” button
- On the next page, Twitch will show what permissions are required; click Authorize
- After authorization you should see “Hi, YourUserName” — this means it worked
- Click “Click here to reveal your key.”
‼️VERY IMPORTANT
DO NOT SHOW THIS CODE TO ANYONE!
- Copy the key to your clipboard — you'll use it later
Triggering A Catch
With the new update you can now choose to trigger by a Command or trigger by a Channel Point. Whichever method you choose will result in a random ball being chosen.
If you want to use a Channel Reward Redemption
If you want to use a Channel Point reward you can, however you will need to create one.
To do that follow the guide below.
- Go to the “Actions” tab
- Click on “StreamUP - Pokémon and Friends - Perform Catch”
- Open up the Reward Redemption (1)
- In the new window click Create Reward (2)
- Give your reward a Title (the bot will automatically update it to “Catch the ‘Pokémon Name’”) (3)
- Add a description so viewers know what the reward does (4)
- Set a colour if you wish! (5)
- Set a cost that fits your community (6)
- Click Save (7)
- Select the Reward (8)
- Press Ok (9)
INFO
You can customize other reward settings, but these are the minimum required steps.
If you wish to use a Command.
If you wish to use a command you can, all you need to do is enable the Trigger on the Perform Catch Action and then Enable the Command (We show you how to enable commands a bit further down, so you can do it when you get to that bit!)
Opening and configuring PaF settings
INFO
Before you open the settings, make sure your Streamer.bot is connected to OBS.
- Click the “StreamUP - Pokémon and Friends - Settings” action (1)
- Right-click the “StreamUP” trigger (2)
- Click “Test Trigger” (3)
- Our Settings Popup will now appear.
- Adjust the remaining settings to your preference — read each option's description.
- You will need to Enter The API Key, if you didn't grab it earlier you can get it now.
- Select which is the highest Generation you want to spawn, meaning if you select "3" then Pokemon from Generations 1,2 and 3 will spawn.
- Select your language.
- Select your sprite type, examples are below.
- Adjust the catch rate. (The math of catch rate is explained below)
- Adjust the Shiny Spawn rate. (The math of shiny is explained below)
- Adjust the Flee Chance (The math of Flee is explained below)
- Allow Seasonal Pokemon will make it so special pokemon can spawn.
- Now select the channel point you just made, if you want to use channel points.
- Adjust the Status Effect Boost
- Add the Status Effects (I've posted some examples below)
- Adjust the chance for the status to be worn off if the Pokemon escaped.
- Then go to the balls tab
- Choose which balls you want to be enabled, how often you want them to show, and then how much you want to boost the catch rate with them. (All math is explained below)
- When finished, press “Save” at the bottom.
Example Status Effects
- Asleep
- Poisoned
- Confused
- Burnt
- Frozen
- Paralysed
- Cursed
Enabling the Twitch Commands
- Go to Commands (1)
- Find the “StreamUP - Pokémon and Friends” category (2)
- Right-click on the category (2)
- Click “Enable All” to enable the commands. (3)
INFO
We have set !poke-reset, !poke-end and !poke-spawn to be available to moderators and higher by default.
WARNING
If you are not using a command to catch you will have to check that one individually!
Customizing Spawn and Flee timers
INFO
By default, Pokémon spawn between 5 and 15 minutes and flee 10 minutes after a spawn. You can change these values in Streamer.Bot.
- Go to the Services tab within Streamer.Bot (1)
- Open the “Timer” tab (2)
- Right click on the "Spawn Pokemon" Timer (3)
- Then Click Enable (4)
INFO
If you’re happy with the defaults, you only need to enable “StreamUP - Pokémon and Friends - Spawn Pokémon Timer”.
Changing and Enabling “StreamUP - Pokémon and Friends - Spawn Pokémon Timer”
- Double-click “StreamUP - Pokémon and Friends - Spawn Pokémon Timer”
- Toggle the “Enabled” box, so that it is on. (1)
- Ensure Random Interval is On (2)
- Change the first and second box values (in seconds) to adjust spawn frequency (3)
- Press “Ok”
INFO
From the moment you click “Ok”, Pokémon will spawn according to that timer.
Changing the “StreamUP - Pokémon and Friends - Automatic Flee Timer”
- Double-click “StreamUP - Pokémon and Friends - Automatic Flee Timer”
- Change the value (in seconds) to adjust how quickly Pokémon flee (2)
- You can also enable “Random” to make flee times variable (1)
- Press “Ok”
WARNING
Do NOT enable this timer manually when testing — it is enabled automatically when a Pokémon spawns.
Using the Status Effect
This version comes with a new feature, you can now apply status effects such as Poisoning and Confusion. This feature is optional however there is no setting in the Settings UI to turn it off. If you do not want this feature on just disable the action or have no triggers on it and it can not be used.
And that should be it! StreamUP - Pokémon and Friends - Cloud Edition should now be up and running. If you have any questions or need support, feel free to ask us in Discord!
How To Use
This next section will explain how to use and get the most out of your Pokemon and Friends
Triggers
In this update we replaced the old Select an Action when ... settings and introduced Triggers. These triggers will now run on certain event.
So all you need to do is to create a new action and add the relevant trigger and the aub-actions you want.
These events are:-
- Pokemon Spawned (
pafSpawned) - Pokemon Shiny Spawned (
pafShinySpawned) - Pokemon Captured (
pafCaptured) - Pokemon Fled (
pafFled) - Pokedex Checked (
pafPokedexChecked) - Any Ball Thrown (
pafAnyBallThrown) - Pokeball Thrown (
pafPokeballThrown) - Great Ball Thrown (
pafGreatBallThrown) - Ultra Ball Thrown (
pafUltraballThrown) - Master Ball Thrown (
pafMasterballThrown) - Pokemon Status Applied (
pafStatusApplied) - Pokemon Status Wore Off (
pafStatusWoreOff) - Catch Failed/Escaped (
pafCatchFailed) - Pokemon Error (
pafError)
INFO
If you want to use a switch case like I've added the trigger code in the brackets ()
You can also edit the switch case provided in StreamUP Pokemon Admin • Pokemmon and Friends • Outputs and just add the sub-actions there, just like piQmi has done below.
Arguments
When you use the triggers you have access to a certain amount of triggers.
For Catch, Spawn, Flee -
| Argument | Description |
|---|---|
%parse.id% | The Pokédex ID number of the Pokémon |
%parse.name% | The name of the Pokémon |
%parse.captutureRate% | The base catch rate of the Pokémon (0–255) |
%parse.isShiny% | Whether the Pokémon is shiny (true/false) |
%parse.spriteUri% | URL to the Pokémon's sprite image |
%parse.descriptions[i]% | Pokédex description entry at index i |
For Pokedex Checked -
| Argument | Description |
|---|---|
%url% | Link to the stream's Pokédex page for this Pokémon |
%name% | The name of the Pokémon looked up |
%pokeId% | The Pokédex ID number of the Pokémon |
%description% | The Pokédex description text |
%image% | URL to the Pokémon's image |
For Status Applied/Worn Off
| Argument | Description |
|---|---|
%statusName% | This is the name of the Status that has been applied |
%statusValue% | This is the value that has been applied |
Commands
Commands will be the main way, other than the Channel Point Redeem, that a user will interact below are a list of the commands and there intended use.
!pokedex• Allows viewers to find out about pokemon if its on screen or the name or number you enter, and it will also give a link to that streams pokedex which displays the pokemon caught.!poke-reset• In the Event something should go wrong, you now have a way of resetting the game.!poke-spawn• Allows you to spawn a pokemon, if no input is given it will be random however you can add a name or number to get a specified pokemon.
WARNING
Please Remember Commands are disabled by default upon importing them
Sprite Types
Default Sprite
Showdown Animated Sprite
Official Artwork
Pokémon HOME Sprite
The Math
For the Nerds that care here is a quick overview of the math, don't worry if you don't understand you go and be a Pokemon Master. You don't need to know the math if you 'Catch em All'!
Catch Rate
The Pokemon that spawn will have 1 of 4 Base Catch Rates (50, 33, 25, 20) this is dependant on the rarity of the Pokemon.
The boosted catch rate will allow you to add to that number by x. For example lets say you choose to boost by 10 this now adds an extra 10 to your chance of catching. So a 50 becomes 60
You can also then add a status effect which also adds to the chance, so if you add a status effect it and if it adds another 10 your 60 is now 70.
Now lets consider the balls, this value is also added to the total. So lets take your 70 and lets say you use a Great Ball this will add 10. This means your new catch rate value is 80 and you can think of this as a percentage, you now have a 80% chance of catching the Pokemon!
If your catch rate is over 100 it is a guaranteed catch.
Shiny Rate
This has been overhauled and is now a integer and it refers to how often a shiny will appear, if you set it to 256 then 1 in 256 will be shiny. So the lower the number the more frequent a shiny pokemon will appear.
Flee Rate
Flee rate is a simple percentage, the higher the number the higher the chance of the Pokemon fleeing if it breaks out of the ball.
Status Worn Off
This is also a simple percentage, the higher the number the higher the chance of the status wearing off.
Ball Rate
We have already spoken about catch rates, and as you are already aware when you redeem Perform Catch. A Random Ball will be selected from the ones that are enabled.
The way the weighting works is it's like buying a raffle ticket, if you set:
- Poke to 100
- Great to 30
- Ultra to 10
- Master to 1
Then those numbers would correspond to the amount of tickets each get, Poke getting 100 and Master getting 1 and so on. Then imagine pulling out 1 ticket and that the ball you use.
The higher the number, the more tickets one would hypothetically get and therefore the higher chance of that ball being selected.