1. Requirements
For this guide, it is necessary to install the following addons:
Rematch,
tdBattlePetScript,
tdBattlePetScript Rematch. It is assumed that installation and setup are already done, and teams are set or easy to set by you.
2. How it works
Basically the addon selects the required ability following instructions written in the script. E.g.:
use(Dodge:312)
use(Nature's Ward:574) [!self.aura(Nature's Ward:820).exists]
use(Alpha Strike:504)
This set of lines result in the following actions:
round 1: it casts
Dodge
round 2: it tries to cast
Dodge, but since it is on CD, it goes to the next line and casts
Nature's Ward
round 3: it tries to cast
Dodge, but since it is on CD, it tries the next line. Since aura
Nature's Ward is active, it goes to the next line and casts
Alpha Strike, and so on.
To summarize: each line is read sequentially until it finds a command that can be executed. The challenge here is writing scripts able to cast the spells according to the desired strategy.
3. Script creation
3.1 The editor
The easiest way to write a script is when you are doing a pet battle with a team previously saved on Rematch.
After starting the fight, open Rematch, right click over the corresponding team and select 'Write script'.
It will open a new window, the 'Script editor'. During the battle, and while the script editor is active it is possible to write a script using the auto-complete feature.
With the script editor opened and during a fight, start typing the desired action and it will soon show an dropdown list.
After selecting an action (type Enter or click over the action) a new list with the abilities available to the active pet will be shown.
Again, select the desired ability and if needed add the conditions when this action will be executed. Start by typing a bracket '[' followed by the first letter of the condition. Options are a target (self, enemy) or weather.
Anyway, a new list will be shown, it there is any.
In case there are additional required parameters, as with auras, a new list will be shown. As before, select the appropriate option.
Once you are familiar with the commands, you might just type the command followed by a dot to activate the dropdownlist with the available options. Remember to close the condition with a bracket: ']'.
Writing and editing a script is not difficult itself since the addon makes it very easy with the dropdown lists. Good luck!
3.2 Actions
ability/
use: casts an ability
change: changes active pets
catch: catches a pet, if possible
standby: pass a round
quit: quits the fight
3.3 Conditions
Conditions are written between brackets ([condition]):
if &
endif
3.4 Target
self: checks a condition on your own pets
enemy: checks for a condition on your enemy's pet
3.5 Functions
dead (boolean)
exists (boolean)
hp (compare)
hp.can_explode (boolean)
hp.full (boolean)
hp.high (boolean)
hp.low (boolean)
hpp (compare)
aura.exists (boolean)
aura.duration (compare)
weather (boolean)
weather.duration (compare)
active (boolean)
ability.usable (boolean)
ability.duration (compare)
ability.strong (boolean)
ability.weak (boolean)
ability.type (equality)
round (boolean)
played (boolean)
speed (compare)
speed.fast (boolean)
speed.slow (boolean)
level (compare)
level.max (boolean)
power (compare)
type (equality)
quality (compare)
id (equality)
is (boolean)
4. Pratical examples
Although the script helps a lot with its auto-complete feature, it won't be enough to write good scripts. It is a good idea to choose a fight and play with the script editor until you feel more confident with the commands and becomes able to write more complex scripts. Below there will be some examples taken from pet battlers using specific strategies. It is assumed that the team is loaded, the abilities are the ones mentioned on the strategy guide, and that the recommended pet is being used, not an equivalent.
4.1 Wailing Critters
The Wailing Critters dungeon offers a nice opportunity to start improving your skills. Until you win the last fight the dungeon is repeatable and you might leave the dungeon, heal, and restart. There is also some random pets in the back row, but only a few families and abilities. The first 3 fights require only one pet with a fixed set of abilities, turning it into a nice place to practice your skills. The script might work for most of the fight where the same pet+abilities are being used, making it a very useful script. The link for the strategy is
here.
The strategy:
Prio 1: Keep Emerald Presence active
Prio 2: Use Emerald Dream when you drop below ~1000 health
Prio 3: Emerald Bite
use(Emerald Presence:597)
use(Emerald Dream:598)
use(Emerald Bite:525)
As it is written, the script will cast
Emerald Presence every time it is available. This ability does not have a CD, so we have to add a condition that prevents it from casting if the aura is already present.
The only conditions available are the 'aura(
Emerald Presence).exists' or 'aura(
Emerald Presence).duration'. The condition that seems to fit the strategy better is the first one.
After writing it, we would have
use(Emerald Presence:597) [self(#1Emerald Proto-Whelp).aura(Emerald Presence).exists], which could be read as "cast
Emerald Presence if my
Emerald Proto-Whelp has
Emerald Presence active".
We want the opposite of that, so deny the condition by using a '!' before the target:
use(Emerald Presence:597) [!self(#1Emerald Proto-Whelp).aura(Emerald Presence).exists], translating into "cast
Emerald Presence if my
Emerald Proto-Whelp does NOT have
Emerald Presence active". Yay!
use(Emerald Presence:597) [!self(Emerald Proto-Whelp).aura(Emerald Presence).exists]
Next step: as of now, the script will cast
Emerald Dream on CD, which might not be required, specially at the beginning of the fight. Let's add the condition that will cast the ability once your whelp is low on health.
use(Emerald Dream:598) [self(Emerald Proto-Whelp).hp<1000]
You might choose to heal your whelp if it is below an amount expressed in percents, and not a fixed amount:
use(Emerald Dream:598) [self(Emerald Proto-Whelp).hpp<50]
This last condition will cast
Emerald Dream if your Whelp is below 50% health.
The final script:
use(Emerald Presence:597) [!self(Emerald Proto-Whelp).aura(Emerald Presence).exists]
use(Emerald Dream:598) [self(Emerald Proto-Whelp).hp<1000]
use(Emerald Bite:525)
If your proto-whelp dies you may change it to another equivalent pet with the same abilities, and the script will keep working. To change pets add the following line:
change(#2) [self(#1).dead] (change to pet number 2 if my pet number 1 is dead)
Now, some remarks about the way the script is written.
- If your team has two Emerald Proto-Whelp, the script might not work as expected if you change pets. To avoid problems, instead of naming it, give it the team position, or just use the 'self' target. This will also allow you to use a different pet with the same skills, like the Dream Whelpling or the Emerald Whelpling
- Do not use a slot number for abilities. It might cause problems if you use an alternative pet whose abilites are on different slot positions, like the Zandalari pets where the abilites Hunting Party and Black Claw sometimes are on a different tier.
- Use either the ability's code number or both name and code. Some players might use a localized version of the game, and for them the script will not work if you use only the name of the abilities
- You might leave only the abilities code number, which will result in a shorter script, but it is not necessary
A suggestion for all scripts (change to the appropriate team slot):
change(#2) [self(#1).dead]
use(Emerald Presence:597) [!self.aura(Emerald Presence:823).exists]
use(Emerald Dream:598) [self.hp<1000]
use(Emerald Bite:525)
4.2 Small fragments
Scripts are written for a specific strategy, but there are many common actions that can be use in many scripts. Adjust them to your needs, checking for the right conditions, and apply them when suitable.
standby [round=1]
- Change pet to leveling and back (change slot numbers where appropriate):
change(#2) [self(#1).dead & !self(#2).played]
change(#3) [self(#2).active]
- Use a dodge ability to block an enemy's ability (in this case, Burrow)
use(Deflection:490) [enemy.aura(Underground:340).exists]
- Change the use of abilities depending on active enemy pet
If the enemy's pets are the first or second, you pet will cast
Breath. Once the third pet enters the fight, your pet will cast
Bombing Run on CD and
Decoy if your enemy uses
Burrow
if [enemy(#3).active]
use(Decoy) [enemy.aura(Underground:340).exists]
use(Bombing Run)
endif
use(Breath)
5. Resources
16 Comments (EN)
Show first:
0
Sally wrote on 09/23/2019
I need to use kick on the round after he used "Death Bleat", when the ability has 7 turns cooldown. I have not found anything in the API to check for cooldown left.
1
Remte
wrote on 09/24/2019
1
DragonsAfterDark
wrote on 09/24/2019
You can go about that in one of two ways:
ability(Kick:307) [enemy.aura
Using this method, you need to wait until Eleanor has done the first round of Death Bleat. Once they do the first round, and you start typing in aura for the script, it should give you a list of all the auras on Eleanor, and one of them should be whatever comes up for their first round of Death Bleat. It would end up looking like:
ability(Kick:307) [enemy.aura(Whatever the Aura's Name is Here).exists]
Or, as Remte pointed out, if the CD doesn't start until the damage is released, you'd need to do something like this:
ability(Kick:307) [enemy.ability(Death Bleat's Code Here).duration=8]
You'll get the specific code for Eleanor's Death Bleat when you start typing in ability. I only have player pet codes copied down, and not enemy pets, so I can't say what the code will look like.
-5
JaneDoe wrote on 03/24/2019
3
Lazey
wrote on 04/12/2019
0
Hodaress wrote on 03/11/2019
That is, which file is modified. I've backed up my teams and thought I was also backing up my scripts. However, during the most recent WoW update, my WTF folder was corrupted and I had to restore from an earlier version I had saved to a different hard drive last month. This WTF folder had all of my saved teams and scripts but although the teams restored, the scripts did not. So, I'm look for where the scripts are stored so I can also back that file up also.
Any suggestions?
2
Lazey
wrote on 04/12/2019
0
Sarah wrote on 02/17/2019
1
Kiwicat#21513
wrote on 12/04/2018
I created my first script today and it was so satisfying when I finally got it to succeed. In the beginning, all the commands made no sense to me, but now its like I learned a new language ^^
1
Loeve wrote on 11/22/2018
4
Eekwibble
wrote on 11/23/2018
TDScripts work on the same principle but with a much easier to understand code. Scripts are for the actual battles themselves. They are the code the game uses to apply the moves you select.
I find it easiest to think of it as the 'TD' standing for 'Top Down', meaning the code written will read from the top line to the bottom, and as each conditional is met - i.e.; your pet does something (or doesn't, if the command was 'standby') - the script restarts at the top.
TL:DR:
Rematch is an addon that allows for easier customisation of pets for specific battles than the standard UI;
tdBattlePetScript is a plug-in for Rematch that allows specific moves to be used in a programmed format to complete battles at the repeated press of a single button (that makes it sound boring; it isn't... It's awesome...).
2
HarleyDoc
wrote on 10/10/2018
0
Killdozer wrote on 10/15/2018
2
Kranthos
wrote on 11/05/2018
1
BevansDesign#1728
wrote on 09/12/2018
1
Eekwibble
wrote on 09/13/2018
1
BevansDesign#1728
wrote on 09/28/2018
3
Kranthos
wrote on 11/13/2018
2
Eekwibble
wrote on 11/14/2018
1
Kranthos
wrote on 11/14/2018
1
Eekwibble
wrote on 11/15/2018
It is to have the opening line read:
change(next) [ self(#1).dead and !self(#3).played ]
and have the carry pet in the 2nd slot, that way its attack never gets used.
There are other ways and most of them involve putting the swap commands at the start of the script.
0
gannymede wrote on 09/09/2018
0
anon wrote on 09/08/2018
1. start of the fight check if ENEMY team pet 1 2 3 one of them is RARE it will start fight else it will forfeit the fight
2. if the current enemy pet you're fighting is poor/common/uncommon it will kill it and when it gets to rare pet it will damage it under >35?% or whatever the catch % is and try to capture it
pets to use
any pet with superbark / weakening blow
2
Kranthos
wrote on 11/03/2018
quit [ enemy(#1).quality!~Rare,4 & enemy(#2).quality!~Rare,4 & enemy(#3).quality!~Rare,4 ]
if [ enemy.quality~Rare,4 ]
catch
change(#1)
use(Superbark:1357)
use(Weakening Blow:826)
endif
test(This section is for, e.g., an Emerald Protowhelp#2,2,2) [ round<1 ]
use(Emerald Presence:597) [ !self.aura(Emerald Presence:823).exists ]
use(Emerald Dream:598) [ self.hpp<50 ]
use(Emerald Bite:525)
test(This section is for, e.g., a Darkmoon Tonk#1,1,2) [ round<1 ]
use(Ion Cannon:209) [ enemy.hp<=488 & enemy.type~Elemental,7 ]
use(Ion Cannon:209) [ enemy.hp<=732 & enemy.type!~Beast,8 ]
use(Ion Cannon:209) [ enemy.hp<=1098 ]
use(Shock and Awe:646)
use(Missile:777)
change(next)
standby
1
Kranthos
wrote on 11/03/2018
use(Ion Cannon:209) [ enemy.hp<=1098 & enemy.type~Beast,8 ]
use(Ion Cannon:209) [ enemy.hp<=732 & enemy.type!~Elemental,7 ]
use(Ion Cannon:209) [ enemy.hp<=488 ]
5
Prudentius
wrote on 08/30/2018
1
Sloober
wrote on 08/04/2018
1
Aranesh
wrote on 08/05/2018