Parameters

On your way to creating your own unique challenges.

For Moderators: Before you create your challenges, you must create a challenge set to group your challenges together!

Note that all event challenge sets will require approval from myst. Before approval, challenge sets are not visible to the public.

Main Parameters

There can be no parameters to a module to make the challenge generic. Parameters are used to customize the conditions in which the challenge will progress.

  • All parameters are optional

  • Conditional parameters ; are required where they are stated

  • Separate with commas, no spaces allowed for each parameter

  • Leave empty if there is no parameters

  • Does not have to be in order, but !NOT weapons and weapon classes have to be after "IS USING" weapons and weapon classes

Parameters Table

Note that player stated in the table is referring to the person completing the challenge.

Class
Team
State
Enemy Status
Team Status
One Chance
Timers
Conditions
Weapons
Special
Class

Player/Enemy Class

  • When you indicate more than 1 class, it means OR.

    • Eg. scout,soldier,demoman!ENEMY,heavy!ENEMY means the player is either Scout or Soldier, and that the enemy is either Demoman or Heavy.

  • To indicate as the enemy, add !ENEMY behind the parameter.

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

Team

Player/Enemy Team

  • When you indicate more than 1 team, it means OR.

    • Eg. red,blue,red!ENEMY,blue!ENEMY means the player is either on BLUE team or RED team, and that the enemy is either on BLUE team or RED team.

    • Eg. red,blue!ENEMY means that the player has to be in RED team and the enemy must be in BLUE team.

  • To indicate as the enemy, add !ENEMY behind the parameter.

Parameter

Description

red

is in RED team

blue

is in BLUE team

spec

is in SPECTATOR team

State

State

  • To indicate as the enemy, add !ENEMY behind the parameter.

  • Eg. alive;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

Enemy Status

Enemy Status

Parameter

Description

self

The enemy and the victim is the same

Examples

  • Rocket and sticky jumping equals self damage

human

A human enemy

robot

A non-human enemy, eg. 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 enemies' 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

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

team;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

enemyteam;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

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

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

  • Survive as the Last Man in Freak Fortress for 1 Minute [0/2] Module: alive Points: 2 Parameters: redalive;1,timer;0;60

  • Deal 250 Damage as the Last Man in Freak Fortress in 1:30 Minutes [0/5] Module: damage Points: 5 Parameters: redalive;1,timer;250;90

  • Deal 500 Damage Every 10 Seconds [0/3]

    Module:damage

    Points: 3

    Parameters: timer;500;10

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

  • Deal 250 Damage in the first 10 Seconds of a Round [0/2] Module: damage Points: 2 Parameters: stimer;250;10

  • Get 5 Eliminations in the first 10 Seconds of a Round [0/3]

    Module: kill

    Points: 3

    Parameters: stimer;5;10

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

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

Special

Special

These parameters are catered to the respective modules only.

kill (Optional)

Parameter

Description

killtype;typeno

The type of kill on the enemy

;typeno is the matching kill type number

  • Refer to the table below for the list of kill numbers

  • To indicate it wasn't this type of kill, add !NOT behind the parameter.

Examples

  • Backstab Parameters: killtype;2

  • Headshot But Not Suicide (somehow) Parameters: killtype;HEADSHOT,killtype;6!NOT

Kill 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

Other Parameters

To make things neater, maps and gamemodes function the same way but are separated from the main parameters.

Gamemodes

  • Separate with commas, spaces are allowed for each gamemode name.

  • * in front of a name if you want the challenge to match gamemodes CONTAINING that name. Otherwise, the challenge will match gamemodes with the exact naming.

  • # at the end of a gamemode name if you want the challenge to match case-sensitively.

  • !NOT at the end of a gamemode name if you don't want the challenge to track in that gamemode.

Maps

  • Separate with commas, no spaces allowed for each map name.

  • * in front of a name if you want the challenge to match maps CONTAINING that name. Otherwise, the challenge will match maps with the exact naming.

  • # at the end of a map name if you want the challenge to match case-sensitively.

  • !NOT at the end of a map name if you don't want the challenge to track in that map.

Mann vs Machine

  • To indicate a Mann vs Machine mission, simply indicate its mission/popfile name after the map name. A mission called Ambush on mvm_decoy, will be mvm_decoy_Ambush.

  • To indicate a specific wave of a mission, add ;wave<number> behind the map (map_mission) name. For example, mvm_decoy_Ambush;wave3 to indicate the 3rd wave of Ambush mission on mvm_decoy.

Note that if you are indicating that a challenge can be done in any mission of a MvM map, it should include a * infront of the map name. Otherwise, it can only be done in the default mission of that map.