2 Copyright (C) 1996-1997 Id Software, Inc.
4 This program is free software; you can redistribute it and/or
5 modify it under the terms of the GNU General Public License
6 as published by the Free Software Foundation; either version 2
7 of the License, or (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13 See the GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
23 // for secure rcon authentication
28 cvar_t rcon_password = {CVAR_CLIENT | CVAR_SERVER | CVAR_PRIVATE, "rcon_password", "", "password to authenticate rcon commands; NOTE: changing rcon_secure clears rcon_password, so set rcon_secure always before rcon_password; may be set to a string of the form user1:pass1 user2:pass2 user3:pass3 to allow multiple user accounts - the client then has to specify ONE of these combinations"};
29 cvar_t rcon_secure = {CVAR_CLIENT | CVAR_SERVER, "rcon_secure", "0", "force secure rcon authentication (1 = time based, 2 = challenge based); NOTE: changing rcon_secure clears rcon_password, so set rcon_secure always before rcon_password"};
30 cvar_t rcon_secure_challengetimeout = {CVAR_CLIENT, "rcon_secure_challengetimeout", "5", "challenge-based secure rcon: time out requests if no challenge came within this time interval"};
31 cvar_t rcon_address = {CVAR_CLIENT, "rcon_address", "", "server address to send rcon commands to (when not connected to a server)"};
32 cvar_t cl_name = {CVAR_CLIENT | CVAR_SAVE | CVAR_USERINFO, "name", "player", "change your player name"};
33 cvar_t cl_topcolor = {CVAR_CLIENT | CVAR_SAVE | CVAR_USERINFO, "topcolor", "0", "change the color of your shirt"};
34 cvar_t cl_bottomcolor = {CVAR_CLIENT | CVAR_SAVE | CVAR_USERINFO, "bottomcolor", "0", "change the color of your pants"};
40 Sends an entire command string over to the server, unprocessed
43 void CL_ForwardToServer (const char *s)
46 if (cls.state != ca_connected)
48 Con_Printf("Can't \"%s\", not connected\n", s);
55 // LadyHavoc: thanks to Fuh for bringing the pure evil of SZ_Print to my
56 // attention, it has been eradicated from here, its only (former) use in
58 if (cls.protocol == PROTOCOL_QUAKEWORLD)
59 MSG_WriteByte(&cls.netcon->message, qw_clc_stringcmd);
61 MSG_WriteByte(&cls.netcon->message, clc_stringcmd);
62 if ((!strncmp(s, "say ", 4) || !strncmp(s, "say_team ", 9)) && cl_locs_enable.integer)
64 // say/say_team commands can replace % character codes with status info
67 if (*s == '%' && s[1])
69 // handle proquake message macros
73 case 'l': // current location
74 CL_Locs_FindLocationName(temp, sizeof(temp), cl.movement_origin);
76 case 'h': // current health
77 dpsnprintf(temp, sizeof(temp), "%i", cl.stats[STAT_HEALTH]);
79 case 'a': // current armor
80 dpsnprintf(temp, sizeof(temp), "%i", cl.stats[STAT_ARMOR]);
82 case 'x': // current rockets
83 dpsnprintf(temp, sizeof(temp), "%i", cl.stats[STAT_ROCKETS]);
85 case 'c': // current cells
86 dpsnprintf(temp, sizeof(temp), "%i", cl.stats[STAT_CELLS]);
88 // silly proquake macros
89 case 'd': // loc at last death
90 CL_Locs_FindLocationName(temp, sizeof(temp), cl.lastdeathorigin);
92 case 't': // current time
93 dpsnprintf(temp, sizeof(temp), "%.0f:%.0f", floor(cl.time / 60), cl.time - floor(cl.time / 60) * 60);
95 case 'r': // rocket launcher status ("I have RL", "I need rockets", "I need RL")
96 if (!(cl.stats[STAT_ITEMS] & IT_ROCKET_LAUNCHER))
97 dpsnprintf(temp, sizeof(temp), "I need RL");
98 else if (!cl.stats[STAT_ROCKETS])
99 dpsnprintf(temp, sizeof(temp), "I need rockets");
101 dpsnprintf(temp, sizeof(temp), "I have RL");
103 case 'p': // powerup status (outputs "quad" "pent" and "eyes" according to status)
104 if (cl.stats[STAT_ITEMS] & IT_QUAD)
107 strlcat(temp, " ", sizeof(temp));
108 strlcat(temp, "quad", sizeof(temp));
110 if (cl.stats[STAT_ITEMS] & IT_INVULNERABILITY)
113 strlcat(temp, " ", sizeof(temp));
114 strlcat(temp, "pent", sizeof(temp));
116 if (cl.stats[STAT_ITEMS] & IT_INVISIBILITY)
119 strlcat(temp, " ", sizeof(temp));
120 strlcat(temp, "eyes", sizeof(temp));
123 case 'w': // weapon status (outputs "SSG:NG:SNG:GL:RL:LG" with the text between : characters omitted if you lack the weapon)
124 if (cl.stats[STAT_ITEMS] & IT_SUPER_SHOTGUN)
125 strlcat(temp, "SSG", sizeof(temp));
126 strlcat(temp, ":", sizeof(temp));
127 if (cl.stats[STAT_ITEMS] & IT_NAILGUN)
128 strlcat(temp, "NG", sizeof(temp));
129 strlcat(temp, ":", sizeof(temp));
130 if (cl.stats[STAT_ITEMS] & IT_SUPER_NAILGUN)
131 strlcat(temp, "SNG", sizeof(temp));
132 strlcat(temp, ":", sizeof(temp));
133 if (cl.stats[STAT_ITEMS] & IT_GRENADE_LAUNCHER)
134 strlcat(temp, "GL", sizeof(temp));
135 strlcat(temp, ":", sizeof(temp));
136 if (cl.stats[STAT_ITEMS] & IT_ROCKET_LAUNCHER)
137 strlcat(temp, "RL", sizeof(temp));
138 strlcat(temp, ":", sizeof(temp));
139 if (cl.stats[STAT_ITEMS] & IT_LIGHTNING)
140 strlcat(temp, "LG", sizeof(temp));
143 // not a recognized macro, print it as-is...
149 // write the resulting text
150 SZ_Write(&cls.netcon->message, (unsigned char *)temp, (int)strlen(temp));
154 MSG_WriteByte(&cls.netcon->message, *s);
157 MSG_WriteByte(&cls.netcon->message, 0);
159 else // any other command is passed on as-is
160 SZ_Write(&cls.netcon->message, (const unsigned char *)s, (int)strlen(s) + 1);
163 void CL_ForwardToServer_f (cmd_state_t *cmd)
167 if (!strcasecmp(Cmd_Argv(cmd, 0), "cmd"))
169 // we want to strip off "cmd", so just send the args
170 s = Cmd_Argc(cmd) > 1 ? Cmd_Args(cmd) : "";
174 // we need to keep the command name, so send Cmd_Argv(cmd, 0), a space and then Cmd_Args(cmd)
175 s = va(vabuf, sizeof(vabuf), "%s %s", Cmd_Argv(cmd, 0), Cmd_Argc(cmd) > 1 ? Cmd_Args(cmd) : "");
177 // don't send an empty forward message if the user tries "cmd" by itself
180 CL_ForwardToServer(s);
188 cvar_t cl_color = {CVAR_READONLY | CVAR_CLIENT | CVAR_SAVE, "_cl_color", "0", "internal storage cvar for current player colors (changed by color command)"};
190 // Ignore the callbacks so this two-to-three way synchronization doesn't cause an infinite loop.
191 static void CL_Color_c(cvar_t *var)
195 Cvar_Set_NoCallback(&cl_topcolor, va(vabuf, sizeof(vabuf), "%i", ((var->integer >> 4) & 15)));
196 Cvar_Set_NoCallback(&cl_bottomcolor, va(vabuf, sizeof(vabuf), "%i", (var->integer & 15)));
199 static void CL_Topcolor_c(cvar_t *var)
203 Cvar_Set_NoCallback(&cl_color, va(vabuf, sizeof(vabuf), "%i", var->integer*16 + cl_bottomcolor.integer));
206 static void CL_Bottomcolor_c(cvar_t *var)
210 Cvar_Set_NoCallback(&cl_color, va(vabuf, sizeof(vabuf), "%i", cl_topcolor.integer*16 + var->integer));
213 static void CL_Color_f(cmd_state_t *cmd)
217 if (Cmd_Argc(cmd) == 1)
219 if (cmd->source == src_command)
221 Con_Printf("\"color\" is \"%i %i\"\n", cl_topcolor.integer, cl_bottomcolor.integer);
222 Con_Print("color <0-15> [0-15]\n");
227 if (Cmd_Argc(cmd) == 2)
228 top = bottom = atoi(Cmd_Argv(cmd, 1));
231 top = atoi(Cmd_Argv(cmd, 1));
232 bottom = atoi(Cmd_Argv(cmd, 2));
235 * This is just a convenient way to change topcolor and bottomcolor
236 * We can't change cl_color from here directly because topcolor and
237 * bottomcolor may be changed separately and do not call this function.
238 * So it has to be changed when the userinfo strings are updated, which
239 * happens twice here. Perhaps find a cleaner way?
242 top = top >= 0 ? top : cl_topcolor.integer;
243 bottom = bottom >= 0 ? bottom : cl_bottomcolor.integer;
248 // LadyHavoc: allowing skin colormaps 14 and 15 by commenting this out
254 if (cmd->source == src_command)
256 Cvar_SetValueQuick(&cl_topcolor, top);
257 Cvar_SetValueQuick(&cl_bottomcolor, bottom);
266 packet <destination> <contents>
268 Contents allows \n escape character
271 static void CL_Packet_f(cmd_state_t *cmd) // credit: taken from QuakeWorld
277 lhnetaddress_t address;
278 lhnetsocket_t *mysocket;
280 if (Cmd_Argc(cmd) != 3)
282 Con_Printf ("packet <destination> <contents>\n");
286 if (!LHNETADDRESS_FromString (&address, Cmd_Argv(cmd, 1), sv_netport.integer))
288 Con_Printf ("Bad address\n");
292 in = Cmd_Argv(cmd, 2);
294 send[0] = send[1] = send[2] = send[3] = -1;
296 l = (int)strlen (in);
297 for (i=0 ; i<l ; i++)
299 if (out >= send + sizeof(send) - 1)
301 if (in[i] == '\\' && in[i+1] == 'n')
306 else if (in[i] == '\\' && in[i+1] == '0')
311 else if (in[i] == '\\' && in[i+1] == 't')
316 else if (in[i] == '\\' && in[i+1] == 'r')
321 else if (in[i] == '\\' && in[i+1] == '"')
330 mysocket = NetConn_ChooseClientSocketForAddress(&address);
332 mysocket = NetConn_ChooseServerSocketForAddress(&address);
334 NetConn_Write(mysocket, send, out - send, &address);
338 =====================
341 ProQuake rcon support
342 =====================
344 static void CL_PQRcon_f(cmd_state_t *cmd)
348 lhnetsocket_t *mysocket;
350 if (Cmd_Argc(cmd) == 1)
352 Con_Printf("%s: Usage: %s command\n", Cmd_Argv(cmd, 0), Cmd_Argv(cmd, 0));
356 if (!rcon_password.string || !rcon_password.string[0] || rcon_secure.integer > 0)
358 Con_Printf ("You must set rcon_password before issuing an pqrcon command, and rcon_secure must be 0.\n");
362 e = strchr(rcon_password.string, ' ');
363 n = e ? e-rcon_password.string : (int)strlen(rcon_password.string);
366 cls.rcon_address = cls.netcon->peeraddress;
369 if (!rcon_address.string[0])
371 Con_Printf ("You must either be connected, or set the rcon_address cvar to issue rcon commands\n");
374 LHNETADDRESS_FromString(&cls.rcon_address, rcon_address.string, sv_netport.integer);
376 mysocket = NetConn_ChooseClientSocketForAddress(&cls.rcon_address);
380 unsigned char bufdata[64];
383 MSG_WriteLong(&buf, 0);
384 MSG_WriteByte(&buf, CCREQ_RCON);
385 SZ_Write(&buf, (const unsigned char*)rcon_password.string, n);
386 MSG_WriteByte(&buf, 0); // terminate the (possibly partial) string
387 MSG_WriteString(&buf, Cmd_Args(cmd));
388 StoreBigLong(buf.data, NETFLAG_CTL | (buf.cursize & NETFLAG_LENGTH_MASK));
389 NetConn_Write(mysocket, buf.data, buf.cursize, &cls.rcon_address);
395 =====================
398 Send the rest of the command line over as
399 an unconnected command.
400 =====================
402 static void CL_Rcon_f(cmd_state_t *cmd) // credit: taken from QuakeWorld
406 lhnetsocket_t *mysocket;
408 if (Cmd_Argc(cmd) == 1)
410 Con_Printf("%s: Usage: %s command\n", Cmd_Argv(cmd, 0), Cmd_Argv(cmd, 0));
414 if (!rcon_password.string || !rcon_password.string[0])
416 Con_Printf ("You must set rcon_password before issuing an rcon command.\n");
420 e = strchr(rcon_password.string, ' ');
421 n = e ? e-rcon_password.string : (int)strlen(rcon_password.string);
424 cls.rcon_address = cls.netcon->peeraddress;
427 if (!rcon_address.string[0])
429 Con_Printf ("You must either be connected, or set the rcon_address cvar to issue rcon commands\n");
432 LHNETADDRESS_FromString(&cls.rcon_address, rcon_address.string, sv_netport.integer);
434 mysocket = NetConn_ChooseClientSocketForAddress(&cls.rcon_address);
435 if (mysocket && Cmd_Args(cmd)[0])
437 // simply put together the rcon packet and send it
438 if(Cmd_Argv(cmd, 0)[0] == 's' || rcon_secure.integer > 1)
440 if(cls.rcon_commands[cls.rcon_ringpos][0])
443 LHNETADDRESS_ToString(&cls.rcon_addresses[cls.rcon_ringpos], s, sizeof(s), true);
444 Con_Printf("rcon to %s (for command %s) failed: too many buffered commands (possibly increase MAX_RCONS)\n", s, cls.rcon_commands[cls.rcon_ringpos]);
445 cls.rcon_commands[cls.rcon_ringpos][0] = 0;
448 for (i = 0;i < MAX_RCONS;i++)
449 if(cls.rcon_commands[i][0])
450 if (!LHNETADDRESS_Compare(&cls.rcon_address, &cls.rcon_addresses[i]))
454 NetConn_WriteString(mysocket, "\377\377\377\377getchallenge", &cls.rcon_address); // otherwise we'll request the challenge later
455 strlcpy(cls.rcon_commands[cls.rcon_ringpos], Cmd_Args(cmd), sizeof(cls.rcon_commands[cls.rcon_ringpos]));
456 cls.rcon_addresses[cls.rcon_ringpos] = cls.rcon_address;
457 cls.rcon_timeout[cls.rcon_ringpos] = host.realtime + rcon_secure_challengetimeout.value;
458 cls.rcon_ringpos = (cls.rcon_ringpos + 1) % MAX_RCONS;
460 else if(rcon_secure.integer > 0)
464 dpsnprintf(argbuf, sizeof(argbuf), "%ld.%06d %s", (long) time(NULL), (int) (rand() % 1000000), Cmd_Args(cmd));
465 memcpy(buf, "\377\377\377\377srcon HMAC-MD4 TIME ", 24);
466 if(HMAC_MDFOUR_16BYTES((unsigned char *) (buf + 24), (unsigned char *) argbuf, (int)strlen(argbuf), (unsigned char *) rcon_password.string, n))
469 strlcpy(buf + 41, argbuf, sizeof(buf) - 41);
470 NetConn_Write(mysocket, buf, 41 + (int)strlen(buf + 41), &cls.rcon_address);
476 memcpy(buf, "\377\377\377\377", 4);
477 dpsnprintf(buf+4, sizeof(buf)-4, "rcon %.*s %s", n, rcon_password.string, Cmd_Args(cmd));
478 NetConn_WriteString(mysocket, buf, &cls.rcon_address);
483 static void CL_RCon_ClearPassword_c(cvar_t *var)
485 // whenever rcon_secure is changed to 0, clear rcon_password for
486 // security reasons (prevents a send-rcon-password-as-plaintext
487 // attack based on NQ protocol session takeover and svc_stufftext)
488 if(var->integer <= 0)
489 Cvar_SetQuick(&rcon_password, "");
492 void CL_InitCommands(void)
494 Cvar_RegisterVariable(&cl_color);
495 Cvar_RegisterCallback(&cl_color, CL_Color_c);
496 Cvar_RegisterVariable(&cl_topcolor);
497 Cvar_RegisterCallback(&cl_topcolor, CL_Topcolor_c);
498 Cvar_RegisterVariable(&cl_bottomcolor);
499 Cvar_RegisterCallback(&cl_bottomcolor, CL_Bottomcolor_c);
500 Cvar_RegisterVariable(&rcon_address);
501 Cvar_RegisterVariable(&rcon_secure);
502 Cvar_RegisterCallback(&rcon_secure, CL_RCon_ClearPassword_c);
503 Cvar_RegisterVariable(&rcon_secure_challengetimeout);
505 Cmd_AddCommand(CMD_CLIENT | CMD_CLIENT_FROM_SERVER, "cmd", CL_ForwardToServer_f, "send a console commandline to the server (used by some mods)");
506 Cmd_AddCommand(CMD_CLIENT, "color", CL_Color_f, "change your player shirt and pants colors");
507 Cmd_AddCommand(CMD_CLIENT, "rcon", CL_Rcon_f, "sends a command to the server console (if your rcon_password matches the server's rcon_password), or to the address specified by rcon_address when not connected (again rcon_password must match the server's); note: if rcon_secure is set, client and server clocks must be synced e.g. via NTP");
508 Cmd_AddCommand(CMD_CLIENT, "srcon", CL_Rcon_f, "sends a command to the server console (if your rcon_password matches the server's rcon_password), or to the address specified by rcon_address when not connected (again rcon_password must match the server's); this always works as if rcon_secure is set; note: client and server clocks must be synced e.g. via NTP");
509 Cmd_AddCommand(CMD_CLIENT, "pqrcon", CL_PQRcon_f, "sends a command to a proquake server console (if your rcon_password matches the server's rcon_password), or to the address specified by rcon_address when not connected (again rcon_password must match the server's)");
510 Cmd_AddCommand(CMD_CLIENT, "packet", CL_Packet_f, "send a packet to the specified address:port containing a text string");