Nosoop: Update documentation to reflect changes in MAXPLAYERS definition

2025-06-02T14:00:44Z

Update documentation to reflect changes in MAXPLAYERS definition

ProdigySim: Created page with "SourceMod assigns a Client Index number to client in the server. You can use these numbers to refer to specific clients in various SourceMod APIs. In particular, the [Clie..."

2020-10-16T19:50:24Z

Created page with "SourceMod assigns a Client Index number to client in the server. You can use these numbers to refer to specific clients in various SourceMod APIs. In particular, the [Clie..."

New page

[[SourceMod]] assigns a Client Index number to client in the server. You can use these numbers to refer to specific clients in various SourceMod APIs. In particular, the [Clients APIs https://sm.alliedmods.net/new-api/clients].

The server is given client index 0, and the first connected user will have client index 1.

There are two variables that can be used to talk about the maximum number of clients:

* <tt>MaxClients</tt>: The maximum number of players currently allowed to connect to the server.
** This is set at runtime based on <tt>gpGlobals->maxClients</tt> in the game server.
* <tt>MAXPLAYERS</tt>: The theoretical maximum number of clients allowed on any Source game.
** This number is set to 65, enough for 64 players + a SourceTV client.

These values represent the '''maximum count of clients'''. Since Client indexing starts at 1, be wary of off-by-one errors here!

It's recommended that you use <tt><= MaxClients</tt> when looping through the client list, and <tt>MAXPLAYERS+1</tt> when initializing an array to contain data for individual clients.

For example:
<sourcepawn>
// Declare static arrays to support the maximum number of clients possible.
new playerVotes[MAXPLAYERS+1];

public void OnPluginStart()
{
RegConsoleCmd("start_vote", Command_StartVote);
RegConsoleCmd("vote", Command_Vote);
}

public Action Command_StartVote(int client, int args)
{
// Loop through all clients based on current number of max clients.
for(int i = 0; i <= MaxClients; i++) {
playerVotes[i] = 0;
}
}

public Action Command_Vote(int client, int args)
{
char arg[128];
if( args > 0)
{
GetCmdArg(i, arg, sizeof(arg));
// Associate data with clients at their client index in an array.
playerVotes[client] = StringToInt(arg);
}

return Plugin_Handled;
}
</sourcepawn>

Other notes:

The game engine's CBaseServer has its own <tt>m_clients</tt> list. You can subtract 1 from a SourceMod client index to get the <tt>CBaseServer::m_clients</tt> index.

@@ Line 8: / Line 8: @@
 ** This is set at runtime based on <tt>gpGlobals->maxClients</tt> in the game server.
 * <tt>MAXPLAYERS</tt>: The theoretical maximum number of clients allowed on any Source game.
-** This number is set to 65, enough for 64 players + a SourceTV client.
+** As of SourceMod 1.12 this number is set to 101 for Team Fortress 2, enough for 100 players + a SourceTV client.
 These values represent the '''maximum count of clients'''. Since Client indexing starts at 1, be wary of off-by-one errors here!

Clients (SourceMod Scripting) - Revision history

Nosoop: Update documentation to reflect changes in MAXPLAYERS definition

ProdigySim: Created page with "SourceMod assigns a Client Index number to client in the server. You can use these numbers to refer to specific clients in various SourceMod APIs. In particular, the [Clie..."