Skip to content

ACS functions: "GetPlayerJoinQueuePosition" and "SkipJoinQueue", and GAMEEVENT_JOINQUEUECHANGED EVENT script type

Adam Kaminski requested to merge topic/default/acs-joinqueue into branch/default

Since modders have asked for features that allow true spectators in the join queue to be forced into the game, I added new ACS functions for this:

  • GetPlayerJoinQueuePosition: returns the player's position in the join queue. If they're not in the queue, this function returns -1.
  • SkipJoinQueue: forces true spectators that are in the join queue to join the game outside of normal game mode rules (modders do this at their own risk). This still respects sv_maxplayers in online games (i.e. there can't be more players than what the limit allows).

This also adds the new EVENT script type: GAMEEVENT_JOINQUEUECHANGED that triggers when the join queue is changed. The activator is the world, arg1 is the index of the player being added/removed from the queue, and arg2 is their current position (-1 means they've been removed).

Edited by Adam Kaminski

Merge request reports