[RedSword]

Teams Management Interface

v. 1.2.3

Forewords : I define Teams Management as the action of moving 1 or more players from one or both teams to another. All the ones initiated by this interface are either between round end and round start or instantly (tested under CS:S, CS:GO and DoD:S only).

I made this interface partly because Sourcemod has lacked since a while of the option "transfer on round end" that MAP had.

Also see 2nd post for a list of plugins using this interface plugin.

Features :

• Centralize different Teams Management requests from different plugins.
• Provides Natives to request a Teams Management. For exemple : to scramble the teams or to move someone to a team; or even to prevent/cancel the ones made by other plugins, by overriding them by another usual request, or a cancel request.
• Provides Forwards to inform plugins when a Teams Management is accepted, canceled or executed.
• --------------------
• Only one "global" Teams Management can be executed at a time (global = affecting all or a lot of players).
• Between the end of a round and the beginning of the following, that "global" Teams Management is executed, followed by any "singular" Teams Management (player going to team X).
• During the time between Teams Management and Round Start, no damage except from bomb can be taken (unless Teams Management are instant). This is to prevent people killing each other because the skin of a team won't represent the real one for that short moment.

Known bugs :

• None.

CVars :

• teamsmanagementinterfaceversion: Gives version -_-'
• ----------
• tmi_sound : Allow the interface to play a sound when teams are scrambled if the calling plugin doesn't. 0 = disabled, 1 = enabled. Def. 1.
• ----------
• tmi_fade : Allow the interface to fade-in players screens when teams are managed if the calling plugin doesn't. 0 = disabled, 1 = enabled. Def. 1.
• tmi_fade_duration : Duration of the fade-in. Best values are around 250-1000. Def. 500.
• ----------
• tmi_delay : Time in seconds before round start when team will be scrambled. Default 0.1 (0.25 under CSGO).
• tmi_blockdmg : If damage is blocked between the moment people are changing teams and round start. 0=no, 1=yes (default).

--------------

Any suggestions/comments on the code or the plugin are welcomed and appreciated.

Changelog :

• 1.0.0 Initial release. (10-04-2012)
• 1.0.1 Corrected bug preventing to manually transfer more than one player per round. Also changed a bit the comments in the include file. (11-04-2012)
• 1.0.2 Corrected bug where Teams Management would be carried over Draw Rounds (could be disastrous gameplay-wise; i.e. terrorists at CTs' spawn with CT's skin :$) (12-04-2012)
• 1.0.3 Corrected crappy scrambling when a team has a fixed amount of players (i.e. 2vALL). (01-07-2012)
• 1.0.4 Changed the way the end-game-team-managing-prevention works so it is more robust (KillTimer apparently brought some rare bug, having TIMER_FLAG_NO_MAPCHANGE flag concurence the "cs_win_panel_match" event sometimes...). Thanks to KyleS. (12-07-2012)
• 1.1.0 (07-10-2012)
  • Added DOD:S support.
  • Added the possibility of instant teams management (rather than only on round end).
  • Made invulnerability more late (I really thought it was made more late than that :$).
• 1.2.0 (27-12-2012)
  • Added CS:GO support.
  • Added the possibility to swap teams (i.e. CT <-> T => T <-> CT). See actionId == 4.
  • Now uses good fade color under DoD:S (Green/Red, rather than Red/Blue).
  • Fixed package using the 'cstrike' folder, as this is multi-mod.
• 1.2.1 (23-01-2013)
  • Added support for protobuf. This means compatibility with the recent CSGO update.
  • Modified attachment structure (directly in mod folder now).
  • See notes as for why two versions are attached.
• 1.2.2 (31-01-2013)
  • Changes tmi_delay default under CSGO to 0.25.
  • This should prevent a bug where everyone was invulnerable (under CSGO). Thanks to PsyGaming for reporting.
• 1.2.3 (01-02-2013)
  • Bug where players were all invulnerable should now be fixed in all mods. (was still possible in CS:S by toying with round restart)

Todo list :

• Add team balance. (veeerrrry low priority)

Notes :

• SDKHooks are required to compile (and run).
• Extract TeamsManagementInterface.zip in your server folder (sound/misc/ folder put aside, no folder should be created).
• Since my .inc is heavily commented I won't paste it here.
• Use 1.2.3 if you have mm:source 1.10.0-hg816 or later AND sourcemod 1.5.0-hg3755 or later for CSS/CSGO/DODS compatibility.
• Use 1.2.0 if you are on SM stable branch (won't work on CSGO).

[RedSword]

Plugins using this interface (by me) :

• Auto Team Scramble 2 (Scramble teams when certain conditions are meet)
• Teams Management Commands (Scramble teams via a command, or prevent/cancel the ones initiated by Auto Team Scramble 2)

Plugins using this interface (by others) :

• No known yet.

[RedSword]

Also reserved.

[Ares Veteran]

Starts being interesting.

[Fearts]

Does this have immune level protections? If not would it be possible to add them?

[RedSword]

Originally Posted by Fearts Does this have immune level protections? If not would it be possible to add them?

We'll see; I'm considering it. I think I'll do it after I add specific player switch on round end. Not sure thought.

You did mean when everyone's is scrambled right ? (i.e. fair/unfair scrambling ; as I don't see a immunity protection between admins useful...)

Thanks for the interest,

Red

EDIT : Considering that I'd like people to be able to get scrambled if they're at least willing (for your protection thing), I'd need to do a keyvalue & menu thing; so I'd probably put that in a late spot on my todo list.

Also, did you mean immunity level or a flag for immunity ?

[Fearts]

I was talking about setting immunity levels so that a admin with level 5 immune couldn't switch the team of a admin with level 6.

[RedSword]

Originally Posted by Fearts I was talking about setting immunity levels so that a admin with level 5 immune couldn't switch the team of a admin with level 6.

O.o...

I don't plan on adding that. It seems more to be an inter-admin problem, plus if the other guy has an higher immunity, I can guess he must have higher or about the same right, meaning he could simply cancel the team switch done on himself...

You can try convincincing me otherwise, but I really don't see the point. Also sometimes even admins on ventrilo/teamspeak can ask you to change their teams for them...

[Fearts]

It is a internal problem. However, it is hard to monitor and would be much easier to just have immune levels set. Reason being admins will use this to basically slay another admin. They will switch their team and then shoot them in the face. Like you said it is internal but would be a nice feature.

[RedSword]

Originally Posted by Fearts It is a internal problem. However, it is hard to monitor and would be much easier to just have immune levels set. Reason being admins will use this to basically slay another admin. They will switch their team and then shoot them in the face. Like you said it is internal but would be a nice feature.

...

I think you didn't understand the point of this interface.

There is absolutely no instant team switching options given by this plugins. ALL teams switch, managements and whatever are done between round end and round start, using CS_TeamSwitch() (so players do not die from it), making people not die from team switching. They're also immune during a small moment to other players damage (to prevent a short delay in which people can see each others with the models they had that round, but with the new teams affected to the player's entity; and I can't correct that since I don't know why the delay between round start and round end is never exactly the same).

If you were testing under a different mod then CS:S, it could kill you (since I made it for CS:S and let a window of opportunity for other mods; but I'm not sure and it's untested under other mods)

So I really don't see what you're afraid of. Did I misunderstand or does that sooth your fears and answer your questions ?

Red

EDIT : 1.0.1 is out :

Corrected bug preventing to manually transfer more than one player per round. Also changed a bit the comments in the include file. (11-04-2012)

RE-EDIT : Fearts, test it yourself with TMC

RE-RE-EDIT : Updated Forewords to make it more clear .