# Conditions
Note that every reference to `player` is referring to the person completing the challenge.
* All parameters are OPTIONAL
* Separate each parameter with a comma `,`
* No spaces are allowed between each parameter
* Conditional parameters `;` are required where stated
* Parameters do not have to be in order
* `!NOT` conditions have to appear after the parameter
* Leave empty if there are no parameters
{% tabs %}
{% tab title="Class" %}
### Player or Enemy Class
* When you indicate more than 1 class, it means OR.
* To indicate as the enemy, add a `!ENEMY` notation behind the parameter. Otherwise, add a `!SELF` notation to indicate the player.
**Examples**
* `scout!SELF,soldier!SELF,demoman!ENEMY,heavy!ENEMY` means that the player is either a Scout or Soldier, and the enemy is either a Demoman or Heavy.
| Parameter | Description |
| ------------ | ---------------------- |
| `scout` | is playing as Scout |
| `soldier` | is playing as Soldier |
| `pyro` | is playing as Pyro |
| `demoman` | is playing as Demoman |
| `heavy` | is playing as Heavy |
| `engineer` | is playing as Engineer |
| `medic` | is playing as Medic |
| `sniper` | is playing as Sniper |
| `spy` | is playing as Spy |
| {% endtab %} | |
{% tab title="Team" %}
### Player or Enemy Team
* When you indicate more than 1 team, it means OR.
* To indicate as the enemy, add a `!ENEMY` notation behind the parameter. Otherwise, add a `!SELF` notation to indicate the player.
**Examples**
* `red!SELF,blue!SELF,red!ENEMY,blue!ENEMY` means that the player is either on the BLUE team or RED team, and the enemy is either on the BLUE team or RED team.
* `red!SELF,blue!ENEMY` means that the player has to be on the RED team and the enemy must be in the BLUE team.
| Parameter | Description |
| ------------ | -------------------- |
| `red` | is in RED team |
| `blue` | is in BLUE team |
| `spec` | is in SPECTATOR team |
| {% endtab %} | |
{% tab title="State" %}
### State
* To indicate as the enemy, add a `!ENEMY` notation behind the parameter. Otherwise, add a `!SELF` notation to indicate the player.
**Examples**
* `alive!SELF,dead!ENEMY` means that the player is alive and the enemy is dead.
| Parameter | Description |
| ------------ | ------------------- |
| `alive` | The player is alive |
| `dead` | The player is dead |
| {% endtab %} | |
{% tab title="Enemy Status" %}
### Enemy Status
| Parameter | Description |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `self` | The enemy and victim are the same
Examples
- Rocket and sticky jumping equals self damage
|
| `human` | A human enemy |
| `robot` | A non-human enemy
Examples
- The bots in Mann vs Machine (not inclusive of NPCs like the HHH, Merasmus, Monoculus, and Skeletons)
|
| `sameteam` | The enemy is on the same team (team kill)
\[NOT RECOMMENDED]
|
| `name;search` | Match the enemy name
;search is the matching term to search for
\* in front of a name if you want the challenge to match names CONTAINING that name.- Otherwise, the challenge will match names with the exact naming.
# at the end of a name if you want the challenge to match case-sensitively.- If you include multiple name searches, it means OR.
|
| `dist;meters;e/m/l` | How far away the enemy is from the player
;metersis the number of meters away
;e is exactly ;meters away;m is more than or equals to ;metersaway;l is less than or equals to;meters away
If you include multiple distances, it means OR.
|
### Templates
| Description | Parameter List |
| --------------------------------------------------------------- | ------------------------ |
| `name;*Sentry Buster` | Sentry Busters |
| `name;*Giant,name;*Super,name;*Major,name;*Colonel,name;*Titan` | Giant Robots |
| `name;*Giant Medic` | Giant Medics |
| `name;*Super Scout` | Super Scouts |
| `name;*Extended Buff Soldier` | Extended Buffed Soldiers |
| `name;*Bowman` | Bowmans |
| `name;*Samurai` | Samurais |
| `name;*Deflector` | Deflectors |
| `name;*Demoknight` | Demoknights |
| {% endtab %} | |
{% tab title="Team Status" %}
### Team Status
* When you indicate more than 1 team, it means **AND**.
* Eg. `redtotal;5,bluetotal;5` means that both BLUE and RED teams have exactly 5 players each.
| Parameter | Description |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `total;amount;e/m/l` | The total number of players
;amount is the number of players
;e is exactly ;amount of players;m is more than or equals to ;amountof players;l is less than or equals to ;amount of players
|
| `redtotal;amount;e/m/l` | The total number of players in red team
;amount is the number of players
;e is exactly ;amount of players;m is more than or equals to ;amountof players;l is less than or equals to ;amount of players
|
| `bluetotal;amount;e/m/l` | The total number of players in blue team
;amount is the number of players
;e is exactly ;amount of players
;m is more than or equals to ;amountof players
;l is less than or equals to ;amount of players
|
| `totalalive;amount;e/m/l` | The total number of players alive
;amount is the number of players
;e is exactly ;amount of players;m is more than or equals to ;amountof players;l is less than or equals to ;amount of players
|
| `redalive;amount;e/m/l` | The total number of players alive in red team
;amount is the number of players
;e is exactly ;amount of players;m is more than or equals to ;amountof players;l is less than or equals to ;amount of players
|
| `bluealive;amount;e/m/l` | The total number of players alive in blue team
;amount is the number of players
;e is exactly ;amount of players;m is more than or equals to ;amountof players;l is less than or equals to ;amount of players
|
| `teamcount;amount;e/m/l` | The total number of players in the player's team
;amount is the number of players
;e is exactly ;amount of players;m is more than or equals to ;amountof players;l is less than or equals to ;amount of players
|
| `enemyteamcount;amount;e/m/l` | The total number of players in the enemy's team
;amount is the number of players
;e is exactly ;amount of players;m is more than or equals to ;amountof players;l is less than or equals to ;amount of players
|
| `teamalive;amount;e/m/l` | The total number of players alive in the player's team
;amount is the number of players
;e is exactly ;amount of players;m is more than or equals to ;amountof players;l is less than or equals to ;amount of players
|
| `enemyteamalive;amount;e/m/l` | The total number of players alive in enemy's team
;amount is the number of players
;e is exactly ;amount of players;m is more than or equals to ;amountof players;l is less than or equals to ;amount of players
|
| {% endtab %} | |
{% tab title="One Chance" %}
### One Chance
Only one parameter is allowed from this category for each challenge.
| Parameter | Description |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `onelife;amount` | Achieved in a single life.
;amount is the number of times the module is run before increasing the points by 1
Eg. Deal 500 Damage in One Life \[0/5] uses damage module with 5 points and has parameters of onelife;500
|
| `oneround;amount` | Achieved in a single round.
;amount is the number of times the module is run before increasing the points by 1
Eg. Walk 1000m in One Round \[0/10] uses distance module with 10 points and has parameters of oneround;1000
|
| {% endtab %} | |
{% tab title="Timers" %}
### Timers
Only one parameter is allowed from this category for each challenge.
| Parameter | Description |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `timer;amount;seconds` | A timer run every second.
;amount is the number of times the module is run before increasing the points by 1
;seconds is the number of seconds that has passed before checking whether it should increase the points by 1
Examples
|
| `stimer;amount;seconds` | A timer run only once in the first x seconds of the round.
;amount is the number of times the module is run before increasing the points by 1
;seconds is the number of seconds that has passed before checking whether it should increase the points by 1
Examples
|
| {% endtab %} | |
{% tab title="Conditions" %}
### Conditions
When you indicate more than 1 condition, it means **AND**.
| Parameter | Description |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cond;tfcond` | Whether the player is or isn't in a condition.
;tfcond is the matching condition
- List of Conditions
Does not have to include TFCond\_, only the text after that (case sensitive)
- To indicate the player isn't in a condition, add
!NOT behind the parameter. - To indicate as the enemy, add
!ENEMY behind the parameter.
Examples
Player is NOT Ubercharged
Parameters: cond;5!NOT
Player is Ubercharged But NOT Stunned
Parameters: cond;5,cond;15!NOT
Enemy is NOT Ubercharged and NOT Taunting
Parameters: cond;5!ENEMY,cond;7!ENEMY
|
| {% endtab %} | |
{% tab title="Weapons" %}
### Weapons
* When you indicate more than 1 weapon or weaponclass, it means **OR** for all the "is using" weapons and **AND** for all the "is not using" weapons.
* The player can use **either one** of the weapons in the "IS USING" pool, and the player MUST NOT use **ANY** of the weapons in the "IS NOT USING `!NOT`" pool.
* Eg. `weapon;1071,weapon;423,weapon;221!NOT,weapon;264!NOT` means the player is either using a Golden Frying Pan or Saxxy but NOT a Holy Mackerel or normal Frying Pan.
* Eg. If you add `weapon;1071!ENEMY,weapon;423!ENEMY,weapon;221!ENEMY!NOT,weapon;264!ENEMY!NOT` to the above example, it means that BOTH the player and enemy are either using a Golden Frying Pan or Saxxy but NOT a Holy Mackerel or normal Frying Pan.
* To indicate as the enemy, add `!ENEMY` behind the parameter.
| Parameter | Description |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `weapon;weapon_index` | The weapon index the player is using. Used for specific weapons.
- To indicate the player isn't this weapon, add
!NOT behind the parameter.
Examples
- Not using a Golden Fying Pan
Parameters:weapon;1071!NOT
List of Weapon Indexes
|
| `weaponclass;tf_weaponclassname` | The weapon classname the player is using. Used for a broad category of weapon types.
- To indicate the player isn't this weapon class, add
!NOT behind the parameter.
Examples
- Not using a weapon with tf\_weapon\_rocketlauncher classname
(does not include ALL rocket launchers such as the Cow Mangler 5000)
Parameters: weaponclass;tf\_weapon\_rocketlauncher!NOT
List of Weapon Classnames
|
### Templates
| Description | Parameter List |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Using any of the explosive weapons | `weaponclass;tf_weapon_rocketlauncher,weaponclass;tf_weapon_rocketlauncher_directhit,weaponclass;tf_weapon_particle_cannon,weaponclass;tf_weapon_rocketlauncher_airstrike,weaponclass;tf_weapon_grenadelauncher,weaponclass;tf_weapon_cannon,weaponclass;tf_weapon_pipebomblauncher` |
| Using any melee weapons | `weaponclass;saxxy,weaponclass;tf_weapon_bat,weaponclass;tf_weapon_bat_wood,weaponclass;tf_weapon_bat_fish,weaponclass;tf_weapon_bat_giftwrap,weaponclass;tf_weapon_shovel,weaponclass;tf_weapon_fireaxe,weaponclass;tf_weapon_breakable_sign,weaponclass;tf_weapon_slap,weapon;307,weaponclass;tf_weapon_bottle,weaponclass;tf_weapon_sword,weaponclass;tf_weapon_katana,weaponclass;tf_weapon_fists,weaponclass;tf_weapon_wrench,weaponclass;tf_weapon_robot_arm,weaponclass;tf_weapon_bonesaw,weaponclass;tf_weapon_club,weaponclass;tf_weapon_knife` |
| {% endtab %} | |
{% tab title="Special" %}
### Special
These parameters are catered to the respective modules only.
#### `damage / kill (Optional)`
| Parameter | Description |
| --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| damagetype;typeno
killtype;typeno
| The type of damage / kill on the enemy
;typeno is the matching type number
- Refer to the table below for the list of type numbers
- To indicate it wasn't this type of damage or kill, add
!NOT behind the parameter.
Examples
|
| Type | Type Number |
| ----------------------------------------- | ----------- |
| TF\_CUSTOM\_HEADSHOT | 1 |
| TF\_CUSTOM\_BACKSTAB | 2 |
| TF\_CUSTOM\_BURNING | 3 |
| TF\_CUSTOM\_WRENCH\_FIX | 4 |
| TF\_CUSTOM\_MINIGUN | 5 |
| TF\_CUSTOM\_SUICIDE | 6 |
| TF\_CUSTOM\_TAUNT\_HADOUKEN | 7 |
| TF\_CUSTOM\_BURNING\_FLARE | 8 |
| TF\_CUSTOM\_TAUNT\_HIGH\_NOON | 9 |
| TF\_CUSTOM\_TAUNT\_GRAND\_SLAM | 10 |
| TF\_CUSTOM\_PENETRATE\_MY\_TEAM | 11 |
| TF\_CUSTOM\_PENETRATE\_ALL\_PLAYERS | 12 |
| TF\_CUSTOM\_TAUNT\_FENCING | 13 |
| TF\_CUSTOM\_PENETRATE\_HEADSHOT | 14 |
| TF\_CUSTOM\_TAUNT\_ARROW\_STAB | 15 |
| TF\_CUSTOM\_TELEFRAG | 16 |
| TF\_CUSTOM\_BURNING\_ARROW | 17 |
| TF\_CUSTOM\_FLYINGBURN | 18 |
| TF\_CUSTOM\_PUMPKIN\_BOMB | 19 |
| TF\_CUSTOM\_DECAPITATION | 20 |
| TF\_CUSTOM\_TAUNT\_GRENADE | 21 |
| TF\_CUSTOM\_BASEBALL | 22 |
| TF\_CUSTOM\_CHARGE\_IMPACT | 23 |
| TF\_CUSTOM\_TAUNT\_BARBARIAN\_SWING | 24 |
| TF\_CUSTOM\_AIR\_STICKY\_BURST | 25 |
| TF\_CUSTOM\_DEFENSIVE\_STICKY | 26 |
| TF\_CUSTOM\_PICKAXE | 27 |
| TF\_CUSTOM\_ROCKET\_DIRECTHIT | 28 |
| TF\_CUSTOM\_TAUNT\_UBERSLICE | 29 |
| TF\_CUSTOM\_PLAYER\_SENTRY | 30 |
| TF\_CUSTOM\_STANDARD\_STICKY | 31 |
| TF\_CUSTOM\_SHOTGUN\_REVENGE\_CRIT | 32 |
| TF\_CUSTOM\_TAUNT\_ENGINEER\_SMASH | 33 |
| TF\_CUSTOM\_BLEEDING | 34 |
| TF\_CUSTOM\_GOLD\_WRENCH | 35 |
| TF\_CUSTOM\_CARRIED\_BUILDING | 36 |
| TF\_CUSTOM\_COMBO\_PUNCH | 37 |
| TF\_CUSTOM\_TAUNT\_ENGINEER\_ARM | 38 |
| TF\_CUSTOM\_FISH\_KILL | 39 |
| TF\_CUSTOM\_TRIGGER\_HURT | 40 |
| TF\_CUSTOM\_DECAPITATION\_BOSS | 41 |
| TF\_CUSTOM\_STICKBOMB\_EXPLOSION | 42 |
| TF\_CUSTOM\_AEGIS\_ROUND | 43 |
| TF\_CUSTOM\_FLARE\_EXPLOSION | 44 |
| TF\_CUSTOM\_BOOTS\_STOMP | 45 |
| TF\_CUSTOM\_PLASMA | 46 |
| TF\_CUSTOM\_PLASMA\_CHARGED | 47 |
| TF\_CUSTOM\_PLASMA\_GIB | 48 |
| TF\_CUSTOM\_PRACTICE\_STICKY | 49 |
| TF\_CUSTOM\_EYEBALL\_ROCKET | 50 |
| TF\_CUSTOM\_HEADSHOT\_DECAPITATION | 51 |
| TF\_CUSTOM\_TAUNT\_ARMAGEDDON | 52 |
| TF\_CUSTOM\_FLARE\_PELLET | 53 |
| TF\_CUSTOM\_CLEAVER | 54 |
| TF\_CUSTOM\_CLEAVER\_CRIT | 55 |
| TF\_CUSTOM\_SAPPER\_RECORDER\_DEATH | 56 |
| TF\_CUSTOM\_MERASMUS\_PLAYER\_BOMB | 57 |
| TF\_CUSTOM\_MERASMUS\_GRENADE | 58 |
| TF\_CUSTOM\_MERASMUS\_ZAP | 59 |
| TF\_CUSTOM\_MERASMUS\_DECAPITATION | 60 |
| TF\_CUSTOM\_CANNONBALL\_PUSH | 61 |
| TF\_CUSTOM\_TAUNT\_ALLCLASS\_GUITAR\_RIFF | 62 |
| TF\_CUSTOM\_THROWABLE | 63 |
| TF\_CUSTOM\_THROWABLE\_KILL | 64 |
| TF\_CUSTOM\_SPELL\_TELEPORT | 65 |
| TF\_CUSTOM\_SPELL\_SKELETON | 66 |
| TF\_CUSTOM\_SPELL\_MIRV | 67 |
| TF\_CUSTOM\_SPELL\_METEOR | 68 |
| TF\_CUSTOM\_SPELL\_LIGHTNING | 69 |
| TF\_CUSTOM\_SPELL\_FIREBALL | 70 |
| TF\_CUSTOM\_SPELL\_MONOCULUS | 71 |
| TF\_CUSTOM\_SPELL\_BLASTJUMP | 72 |
| TF\_CUSTOM\_SPELL\_BATS | 73 |
| TF\_CUSTOM\_SPELL\_TINY | 74 |
| TF\_CUSTOM\_KART | 75 |
| TF\_CUSTOM\_GIANT\_HAMMER | 76 |
| TF\_CUSTOM\_RUNE\_REFLECT | 77 |
| TF\_CUSTOM\_DRAGONS\_FURY\_IGNITE | 78 |
| TF\_CUSTOM\_DRAGONS\_FURY\_BONUS\_BURNING | 79 |
| TF\_CUSTOM\_SLAP\_KILL | 80 |
| TF\_CUSTOM\_CROC | 81 |
| TF\_CUSTOM\_TAUNTATK\_GASBLAST | 82 |
#### `placement (Required)`
| Parameter | Description |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `placement;pos;all/my/other` | Be the top X players left alive (usually for arena, no respawn gamemodes)
;pos is the number of players left (including the player)
;all to check the number of players left alive in both teams;my to check the number of players left alive in the player's team;other to check the number of players left alive in the other team
|
| {% endtab %} | |
| {% endtabs %} | |
###