ILDeathmatch

ILDeathmatch is a version of Quake III Arena that has been retrofitted with Web Monetization in order to allow players to receive money in the form of XRP. ILDeathmatch changes basic Quake III gameplay in two ways:

• Spawning requires payment.
• Each kill pays the player that made said kill.

With Web Monetization, ILDeathmatch is able to compensate each kill in real time. ILDeathmatch uses the binary from inolen/quakejs with middleware from the dm-web-monetization module for payments.

Running ILDeathmatch

This tutorial is based on the one found at inolen/quakejs.

Prerequisites

• A Quake III Arena server running the baseq3 gamemode (This repository)
• A Web Monetization Server to manage payments between the server and its clients (ILDeathmatch-Server)

First, make sure you are running an instance of ILDeathmatch-Server. ILDeathmatch will make API calls to this server to issue charges and payments.

Next, execute the following commands in the root directory:

npm install
node build/ioq3ded.js +set fs_game baseq3 +set dedicated 1

At this point, you should see an EULA for Quake III appear in the terminal. Keep pressing Enter until you have read through the EULA, then answer the Agree? (y/n) prompt. Then the base game files will download. Once this finishes, press Ctrl+C to quit the server.

Navigate to the newly created base/baseq3 directory and create a file with the name server.cfg and add the following to it:

seta sv_hostname "CHANGE ME"
seta sv_maxclients 12
seta g_motd "CHANGE ME"
seta g_quadfactor 3
seta g_gametype 0
seta timelimit 15
seta fraglimit 25
seta g_weaponrespawn 3
seta g_inactivity 3000
seta g_forcerespawn 0
seta rconpassword "CHANGE_ME"
set d1 "map q3dm7 ; set nextmap vstr d2"
set d2 "map q3dm17 ; set nextmap vstr d1"
vstr d1

Replace the fields containing CHANGE_ME with whatever you wish, as well as modifying any other settings you wish to change. A good reference can be found at Quake 3 World.

Finally, create a file called config.json with a single field:

{
  "baseUrl": "localhost:8080",
  "secret": "YOUR_OWN_SECRET"
}

You can point baseUrl to another port if ILDeathmatch-Server is listening on one other than 8080. secret is a secret string that is used to sign a JSON Web Token that is passed between ILDeathmatch and ILDeathmatch-Server. This prevents anyone from the outside attempting to call your monetized APIs. Make sure that this secret is the same as the one you specify in config.json for ILDeathmatch-Server.

Now your server can be run with the following command:

node index.js

This spawns the Quake server as a child process of a parent Node.js process that captures server console output and makes API calls to ILDeathmatch-Server as necessary.

If you did everything right, you should be able to connect to the Quake server using the ILDeathmatch Server on localhost at http://localhost:8080/play?connect%20localhost:27960. Note that Quake servers always listen on port 27960, but you can replace localhost with whatever IP you are using to host the server.