The best way to learn how to use the WebCore is by example. See the documentation for more information.
The requested URL is always shown first; if a page uses one or more WebCore templates, those are shown afterwards.
00 <?php
01 include_once ('quake/init.php');
02
03 $Page->title->subject = 'Administering a Server';
04
05 $Page->location->append ("Quake III Arena", "./");
06 $Page->location->append ("Servers");
07
08 $Page->start_display ();
09 ?>
10 <div class="main-box">
11 <div class="text-flow">
12 <p>You can administer your Quake server directly from the server console,
13 but that usually isn't very convenient. Especially if you aren't anywhere
14 near your server when you play. Much better would be to administer the
15 server from your client as you play. Fortunately, Quake III lets you do
16 just that with the <code>\rcon</code> command.</p>
17 <p>Once you are set up properly, simply type <code>\rcon</code>,
18 followed by the command you wish to issue to the server. The command is
19 executed at the server as if you had typed it directly into the console.</p>
20 <h2>Setting up the server</h2>
21 <p>You'll need to do a couple of things before this will work, though. By
22 default, remote administration is disabled on any QIII server. To enable
23 it, you must set the variable <code>rconpassword</code>
24 at the server to a non-empty string. Here's an example (we'll use this
25 password below):</p>
26 <pre><code>\seta rconpassword "q3pw"</code></pre>
27 <p>The <code>\seta</code> command sets the variable
28 and stores the value for future restarts.</p>
29 <h2>Setting up the client</h2>
30 <p> On the client you are using to administer, you can do one of two things.
31 You can type:</p>
32 <pre><code>\rcon "q3pw" status</code></pre>
33 <p>This sends the password with the remote command and requests the status
34 of the server. If you plan to issue multiple commands, you can set the
35 rconpassword on the client side the same way as you set it on the server
36 (see above). Then, you issue a status command like this:</p>
37 <pre><code>\rcon status</code></pre>
38 <p>Now, you're all set to change maps, game styles, time limits, frag limits,
39 etc.</p>
40 <p>If you want to administer a server without even connecting to it, you
41 must set the <code>rconaddress</code> variable:</p>
42 <pre><code>\seta rconaddress xxx.xxx.xxx.xxx</code></pre>
43 <p>Where <code>xxx.xxx.xxx.xxx</code> is the ip address of the server. This
44 is especially useful when you can't log on to the server for some reason
45 (too many users, you don't have the correct map, etc.).</p>
46 <h2>Issuing commands</h2>
47 <p>At this point, you can issue an command you like to the server. Interesting
48 ones are:</p>
49 <pre><code>\rcon map "map name"</code></pre>
50 <p>This will change the map on the server. The map must exist on the server.</p>
51 <pre><code>\rcon kick "user name"</code></pre>
52 <p>This kicks the specified user off the map. Use quotes to kick players
53 with spaces in their names.</p>
54 <pre><code>\rcon addbot "bot name" "skill level [1-5]"</code></pre>
55 <p>Adds a bot to the game at a certain skill level. 1 =quot;I Can Win",
56 5 =quot;Nightmare". For instance,</p>
57 <pre><code>\rcon addbot Major 2</code></pre>
58 <p>puts the bot Major in at skill level 'Bring It On'. You can kick bots
59 the same way as players, too.</p>
60 </div>
61 </div>
62 <?php $Page->finish_display (); ?>
63
64