1,575
edits
Changes
no edit summary
'''<pre style="color: orange">NOTE: This guide assumes your local server's hostname is "quakejs"</pre>'''
=Setup the Environment=
==Install Node.js & NPM==
#copy ''jq.exe'' & ''wget.exe'' from your Downloads folder to ''C:\Program Files\Git\mingw64\bin\''
#Hit '''Windows Key + R''' and type "cmd" to launch the Command Prompt.
#Run the following command to ensure we're in our Home Directory<pre>%HOMEPATH%</pre>
#You can test (or run) your server with the following command, but there isn't much point until we setup the Content Server and Play Page. <pre>node build/ioq3ded.js +set fs_game baseq3 set dedicated 1 +exec server.cfg</pre>
If you want to setup a permanent installation you will probably want to install UwAmp as a program on your machine. If you are planning on using it intermittently or just want to test it out, you may want to download the stand-alone ZIP version of UwAmp. Follow either [[#Permanent Install]] or [[#Standalone Install]] based on your preference.
#Visit https://www.uwamp.com/en/?page=download and download the ''exe'' installer
#*You might need to download and install the Visual C++ Redistributable as described at the top of the UwAmp download page. If in doubt, download and install it
#run the following command to close Git Bash<pre>exit</pre>
#Visit https://www.uwamp.com/en/?page=download and download the ''zip'' installer
#*You might need to download and install the Visual C++ Redistributable as described at the top of the UwAmp download page. If in doubt, download and install it
#run the following command to close Git Bash<pre>exit</pre>
In a permanent install you may want to make the QuakeJS Game Server run when you boot the machine and log in. Follow these steps to create a Schedule Task to run the server any time your user logs in
##On the '''Settings''' tab uncheck '''Stop the task if it runs longer than:'''
##click '''OK'''
=Extras=
==Create a Game Server Shortcut==
==Turning on and off the Game Server==
Run the shortcut you created on the desktop or go into '''Task Scheduler''' and run the '''QuakeJS Sever''' task manually to start the server. Close the window that pops up to stop it.
=Notes on Customization=
==Changing the Hostname==
If you want to use a hostname other than "quakejs" you'll need to update the line <pre>var args = ['+set', 'fs_cdn', 'quakejs:80', '+connect', 'quakejs:27960']; //custom args list targeting a local content server and local game server both at the address 'quakejs'</pre> in <pre>/var/www/html/index.html</pre> to your new hostname (instead of quakejs).
==Understanding Server Settings in server.cfg==
{| border="1" style="border-collapse:collapse"
!Parameter
!Description
|-
|seta sv_hostname "DM Server All Maps"
|What players will see on the join server window
|-
|seta sv_maxclients 16
|Maximum number of players on the server
|-
|seta g_motd "Welcome to our Quake3 server"
|Message players will see while joining the server
|-
|seta g_quadfactor 3
|Quad Damage strength. 3 is normal
|-
|seta g_gametype 0
|Sets the type of game:<br />0 - Free for all<br />1 - Tournament<br />2 - Free for all(again)<br />3 - Team Deathmatch<br />4 - Capture the Flag
|-
|seta timelimit 15
|Sets the timelimit
|-
|seta fraglimit 25
|-Sets the fraglimit
|-
|seta g_weaponrespawn 3
|Number of seconds before weapons respawn
|-
|seta g_inactivity 3000
|Number of seconds before an inactive player is kicked
|-
|seta g_forcerespawn 0
|Forces players to respawn:<br />0 - off<br />1 - on
|-
|seta rconpassword "password"
|Sets the password to allow client control of the server
|-
|set d1 "map q3dm1 ; set nextmap vstr d2"<br />set d2 "map q3dm2 ; set nextmap vstr d3"<br />set d3 "map q3dm3 ; set nextmap vstr d1"<br />vstr d1
|These last few lines of this example set up a simple map rotation
|}
Visit https://www.quake3world.com/q3guide/servers.html for details on these settings.
==Using the Full Quake 3 Game==
This guide (and Inolen's original project) targets the Demo version of Quake 3. If you'd like to try your hand at hosting a node.js version of the full Quake 3 game ronfar623 over at reddit figured out how to do it. You can read his instructions at the link below. Note that he starts by following my instructions above to set up a working Demo version so you'll need to do that first.<br />
https://www.reddit.com/r/quake/comments/cpn4rp/how_to_setup_your_own_local_quakejs_server/ezr8m3c?utm_source=share&utm_medium=web2x