Ioquake3: Difference between revisions

(3 intermediate revisions by the same user not shown)

Line 2:

=== Client setup ===

{{Warning|The ioquake3 module is not yet upstream and will be available in the upcoming NixOS 26.11 release.}}

The game can be installed and configured using the dedicated <code>programs.ioquake3</code> option.<syntaxhighlight lang="nix">

programs.ioquake3 = {

Line 16:

Line 17:

};

</syntaxhighlight>

</syntaxhighlight>ioquake3 will use the demo game files. If you have purchased the game and have a full copy, you can point <code>programs.ioquake3.baseq3</code> to the baseq3 file system path.

=== Dedicated server setup ===

Following snippet will enable a Quake 3 Arena dedicated server. The map ~~<code>q3tourney3</code> (Hell~~'~~s Gate)~~ will be loaded.<syntaxhighlight lang="nix">

{{Warning|Parts of this module are not yet upstream and will be available in the upcoming NixOS 26.11 release.}}

Following snippet will enable a Quake 3 Arena dedicated server. The map ''q3dm7'' will be loaded.<syntaxhighlight lang="nix">

services.quake3-server = {

enable = true;

openFirewall = true;

~~baseq3~~ = "~~/var/lib/quake3~~";

settings = {

rconPassword = "super_secret";

sv_hostname = "My NixOS Quake 3 Arena Dedicated Server";

};

# Configure map rotation

extraConfig = ''

~~seta rconPassword~~ "~~super_secret~~"

set d1 "map q3dm7 ; set nextmap vstr d2"

~~seta sv_hostname~~ "~~My NixOS Quake 3 Arena Dedicated Server~~"

set d2 "map q3dm1 ; set nextmap vstr d1"

~~map q3tourney3~~

vstr d1

'';

};

</syntaxhighlight>~~Game files must be present and readable on the path specified.~~ The ~~full path to~~ the ~~single~~ game ~~file will~~ be ~~<code>/var/lib/quake3/.q3a/baseq3/pak0.pk3</code>. Permissions must be set world-readable.<syntaxhighlight lang="bash">~~

</syntaxhighlight>The server will use the demo game files, so various maps and assets won't be available.

~~chmod -R o+rX /var/lib/quake3/~~.~~q3a/~~

~~</syntaxhighlight>~~

If you have purchased the game and have a full copy, you can point <code>services.quake3-server.baseq3</code> to the baseq3 file system path. Setting it, for example, to <code>/var/lib/quake3</code>, the game file is to be expected at <code>/var/lib/quake3/.q3a/baseq3/pak0.pk3</code>.

[[Category: Applications]]

[[Category: Gaming]]

@@ Line 2: / Line 2: @@
 === Client setup ===
+{{Warning|The ioquake3 module is not yet upstream and will be available in the upcoming NixOS 26.11 release.}}
 The game can be installed and configured using the dedicated <code>programs.ioquake3</code> option.<syntaxhighlight lang="nix">
 programs.ioquake3 = {
@@ Line 16: / Line 17: @@
    };
 };
-</syntaxhighlight>
+</syntaxhighlight>ioquake3 will use the demo game files. If you have purchased the game and have a full copy, you can point <code>programs.ioquake3.baseq3</code> to the baseq3 file system path.
 === Dedicated server setup ===
-Following snippet will enable a Quake 3 Arena dedicated server. The map <code>q3tourney3</code> (Hell's Gate) will be loaded.<syntaxhighlight lang="nix">
+{{Warning|Parts of this module are not yet upstream and will be available in the upcoming NixOS 26.11 release.}}
+Following snippet will enable a Quake 3 Arena dedicated server. The map ''q3dm7'' will be loaded.<syntaxhighlight lang="nix">
 services.quake3-server = {
    enable = true;
    openFirewall = true;
-   baseq3 = "/var/lib/quake3";
+   settings = {
+    rconPassword = "super_secret";
+    sv_hostname = "My NixOS Quake 3 Arena Dedicated Server";
+  };
+  # Configure map rotation
    extraConfig = ''
-     seta rconPassword "super_secret"
+     set d1 "map q3dm7 ; set nextmap vstr d2"
-     seta sv_hostname "My NixOS Quake 3 Arena Dedicated Server"
+     set d2 "map q3dm1 ; set nextmap vstr d1"
-     map q3tourney3
+     vstr d1
    '';
 };
-</syntaxhighlight>Game files must be present and readable on the path specified. The full path to the single game file will be <code>/var/lib/quake3/.q3a/baseq3/pak0.pk3</code>. Permissions must be set world-readable.<syntaxhighlight lang="bash">
+</syntaxhighlight>The server will use the demo game files, so various maps and assets won't be available.
-chmod -R o+rX /var/lib/quake3/.q3a/
-</syntaxhighlight>
+If you have purchased the game and have a full copy, you can point <code>services.quake3-server.baseq3</code> to the baseq3 file system path. Setting it, for example, to <code>/var/lib/quake3</code>, the game file is to be expected at <code>/var/lib/quake3/.q3a/baseq3/pak0.pk3</code>.
 [[Category: Applications]]
 [[Category: Gaming]]