Here be the comprehensive DJ guide for each server some day. The commands and guidelines on how to be a proper DJ.
A quick summary of the commands:
@put clientnumber team
Puts player with clientnumber in desired team. team should be: r b s
Shorter version is @p cnum team, even more shorter versions are: @r <cnum>, @b <cnum> and @s <cnum>.
Kicks the player from server. @kickmap kicks for the duration of current map. @kickauto kicks automatically forever.
Locks or unlocks the teams. Note: this is a soft-lock which means it locks spectators out (disallow join when called as vote). Players can switch and mix and go spec freely. It is a feature!
short versions are @l and @u (or @ul)
Use this when
Restart the current map with this one in case of a bad /ready or bad teams, etc! @restart is shorter.
The universal swiss army spec knife!
Without an arg it forces the last joiner to spec: use it when teams are unlocked but someone joins without asking or without a pair! You don't have to fiddle with cnums and @put commands in the heat of the game!
It has a global cool-off period (5seconds, that's plenty in this game!) to prevent the racecondition between two or more djs! (ie: they are both typing @s at the same time. the slower one would force a valid player to spec too not just the offender without the cool off)
It also has a 30 seconds safety mechanism to prevent the race condition between the dj and the offender! ie: while you are typing @spec, just before pressing enter the offender leaves or joins spec you would force a legit benevolent player to spec! (hopefully the flagman at 7:7 overtime!)
The safety mechanism gives immunity to players in a team already for more than 30 seconds (but @spec cnum works ofc!). 30 seconds are more than enough to notice someone has joined illegally and type @s.
You can even bind it and spam it every second without causing any turmoil! shorter version is @s you don't even need @lock with this one! (and the offender will receive polite hint)
maybe still needs some testing, do it during warmup!
There are many more commands depending on your DJ Level. Check out them with @whoami. Do not apply them if you aren't sure in their effects!
Type the commands with a dot instead of the 'at' sign if you don't want to be exposed. Like this: .put 4 s ; .kick 13 ; .whoami The commands won't be printed for everyone.
These few are already enough for proper dj'ing, the list will be complete and formatted SOON.
Apologies for current ugliness here.....