Tech demos - Revision history

Dimitri at 14:24, 9 November 2025

2025-11-09T14:24:12Z

← Older revision		Revision as of 14:24, 9 November 2025
Line 20:		Line 20:
	$ cd build/Release/		$ cd build/Release/

	To run OpenArena, you only need to the game files. First download the zip archive (openarena-0.8.8.zip) from the [http://www.openarena.ws/ OpenArena website] (or ~~via wget)~~ and then extract the baseoa folder:		To run OpenArena, you only need to the game files. First download the zip archive (openarena-0.8.8.zip) from the [http://www.openarena.ws/ OpenArena website], or this [https://sourceforge.net/projects/oarena/ mirror] and then extract the baseoa folder:

	$ wget http://www.openarena.ws/request.php?4 -O openarena-0.8.8.zip		$ wget http://www.openarena.ws/request.php?4 -O openarena-0.8.8.zip

Dimitri: /* ioq3 */

2025-09-17T16:50:32Z

ioq3

← Older revision		Revision as of 16:50, 17 September 2025
Line 25:		Line 25:
	$ unzip -j openarena-0.8.8.zip 'openarena-0.8.8/baseoa/*' -d ./baseoa		$ unzip -j openarena-0.8.8.zip 'openarena-0.8.8/baseoa/*' -d ./baseoa

	~~Make sure you have a local Ouroboros layer running in your system (see [[Ouroboros Tutorial 01\|this tutorial]]).~~		To test the game, start a server:

	To test the game, start a server ~~(replace with the correct architecture extension for your machine, eg x86_64)~~:

	$ ./ioq3ded +set com_basegame baseoa +map aggressor		$ ./ioq3ded +set com_basegame baseoa +map aggressor

	~~Bind~~ the pid of the server to a name and register it in the local layer:		Create a local layer, bind the correct pid of the server to a name and register it in the local layer:

	$ irm bind proc <pid> name ~~my.ioq3.server~~		$ irm ipcp bootstrap type local name local layer local
	$ irm name reg ~~my.ioq3.server~~ layer ~~<your_local_layer>~~		$ irm bind proc <pid> name q3
			$ irm name reg q3 layer local

	To connect, start a client (in a different terminal):		To connect, start a client (in a different terminal):
Line 42:		Line 41:
	When the client starts, go to the console by typing ~ (tilde) and enter the following command		When the client starts, go to the console by typing ~ (tilde) and enter the following command

	connect -O ~~my.ioq3.server~~		connect -O q3

	The client should now connect to the ioq3 dedicated server over Ouroboros. Register the name in non-local layers to connect from other machines. Happy Fragging!		The client should now connect to the ioq3 dedicated server over Ouroboros. Register the name in non-local layers to connect from other machines. Happy Fragging!
Line 55:		Line 54:

	The client may seem to hang on a black screen because you need to give microphone permissions the first time you run this, just option-cmd-esc out and allow microphone access.		The client may seem to hang on a black screen because you need to give microphone permissions the first time you run this, just option-cmd-esc out and allow microphone access.

	= netcat =		= netcat =

Dimitri at 16:47, 17 September 2025

2025-09-17T16:47:11Z

← Older revision		Revision as of 16:47, 17 September 2025
Line 46:		Line 46:
	The client should now connect to the ioq3 dedicated server over Ouroboros. Register the name in non-local layers to connect from other machines. Happy Fragging!		The client should now connect to the ioq3 dedicated server over Ouroboros. Register the name in non-local layers to connect from other machines. Happy Fragging!

	== ~~OSX~~ Notes ==		=== OS X Notes ===
	The build requires pkgconfig to find the ouroboros library:		The build requires pkgconfig to find the ouroboros library:

Dimitri at 16:46, 17 September 2025

2025-09-17T16:46:48Z

← Older revision		Revision as of 16:46, 17 September 2025
Line 39:		Line 39:

	$ ./ioquake3 +set com_basegame baseoa		$ ./ioquake3 +set com_basegame baseoa

	on OS X the binary will be inside the ioquak3.app folder (note: client may seem to hang on a black screen because you need to give microphone permissions the first time you run this, just option-cmd-esc out and allow microphone access):
	~~$ ./ioquake3.app/Contents/MacOS/ioquake3 +set com_basegame baseoa~~

	When the client starts, go to the console by typing ~ (tilde) and enter the following command		When the client starts, go to the console by typing ~ (tilde) and enter the following command
Line 49:		Line 46:
	The client should now connect to the ioq3 dedicated server over Ouroboros. Register the name in non-local layers to connect from other machines. Happy Fragging!		The client should now connect to the ioq3 dedicated server over Ouroboros. Register the name in non-local layers to connect from other machines. Happy Fragging!

			== OSX Notes ==
			The build requires pkgconfig to find the ouroboros library:

			$ brew install pkgconfig

			The binary will be inside the ioquak3.app folder, an option is to start the client binary directly:
			$ ./ioquake3.app/Contents/MacOS/ioquake3 +set com_basegame baseoa

			The client may seem to hang on a black screen because you need to give microphone permissions the first time you run this, just option-cmd-esc out and allow microphone access.
	= netcat =		= netcat =

Dimitri at 16:33, 17 September 2025

2025-09-17T16:33:00Z

← Older revision		Revision as of 16:33, 17 September 2025
Line 1:		Line 1:
	= ioq3 =		= ioq3 =

	As a demo, we have added O7s support to the [https://github.com/ioquake/ioq3 ioq3] game engine. ioq3 is a fork of ID software’s [https://github.com/id-Software/Quake-III-Arena Quake III Arena GPL Source Release~~]. The port is available as a [https://{{SERVERNAME}}/patches/ouroboros-ioq3.patch patch~~]. The servers currently only work in dedicated mode (there is no way yet to start a server from the client).		As a demo, we have added O7s support to the [https://github.com/ioquake/ioq3 ioq3] game engine. ioq3 is a fork of ID software’s [https://github.com/id-Software/Quake-III-Arena Quake III Arena GPL Source Release]. The servers currently only work in dedicated mode (there is no way yet to start a server from the client).

	To get the demo, ~~first get~~ the latest ioq3 sources:		To get the demo, build the latest ioq3 sources from our fork:

	$ git clone https://~~github~~.~~com~~/~~ioquake~~/ioq3~~.git~~		$ git clone https://codeberg.org/o7s/ioq3
	$ cd ioq3		$ cd ioq3
			$ mkdir build
	~~Copy the patch via the link above, or get it via wget:~~		$ cd build
			$ cmake ..
	$ ~~wget https://ouroboros.rocks/patches/ouroboros-ioq3.patch~~		$ make -j

	~~Apply the patch to the ioq3 code:~~

	$ ~~git apply ouroboros-ioq3~~.~~patch~~

	~~With Ouroboros installed, build the ioq3 project in standalone mode:~~

	$ ~~STANDALONE=1~~ make

	You may need to install some dependencies like [https://wiki.libsdl.org/SDL2/Installation SDL2], see [https://ioquake3.org/help/building-ioquake3/building-ioquake3-on-linux/ the ioq3 documentation].		You may need to install some dependencies like [https://wiki.libsdl.org/SDL2/Installation SDL2], see [https://ioquake3.org/help/building-ioquake3/building-ioquake3-on-linux/ the ioq3 documentation].
Line 26:		Line 18:
	Go to your build directory:		Go to your build directory:

	$ cd build/~~<release_dir>~~/		$ cd build/Release/

	To run OpenArena, you only need to the game files. First download the zip archive (openarena-0.8.8.zip) from the [http://www.openarena.ws/ OpenArena website] (or via wget) and then extract the baseoa folder:		To run OpenArena, you only need to the game files. First download the zip archive (openarena-0.8.8.zip) from the [http://www.openarena.ws/ OpenArena website] (or via wget) and then extract the baseoa folder:
Line 37:		Line 29:
	To test the game, start a server (replace with the correct architecture extension for your machine, eg x86_64):		To test the game, start a server (replace with the correct architecture extension for your machine, eg x86_64):

	$ ./ioq3ded~~.<arch>~~ +set com_basegame baseoa +map aggressor		$ ./ioq3ded +set com_basegame baseoa +map aggressor

	Bind the pid of the server to a name and register it in the local layer:		Bind the pid of the server to a name and register it in the local layer:
Line 46:		Line 38:
	To connect, start a client (in a different terminal):		To connect, start a client (in a different terminal):

	$ ./ioquake3.~~<arch>~~ +set com_basegame baseoa		$ ./ioquake3 +set com_basegame baseoa

			on OS X the binary will be inside the ioquak3.app folder (note: client may seem to hang on a black screen because you need to give microphone permissions the first time you run this, just option-cmd-esc out and allow microphone access):
			$ ./ioquake3.app/Contents/MacOS/ioquake3 +set com_basegame baseoa

	When the client starts, go to the console by typing ~ (tilde) and enter the following command		When the client starts, go to the console by typing ~ (tilde) and enter the following command

Dimitri: /* netcat */

2025-09-04T18:06:19Z

netcat

← Older revision		Revision as of 18:06, 4 September 2025
Line 94:		Line 94:

	# register the netcat name in the local layer		# register the netcat name in the local layer
	irm name register nc layer local ~~(be branch / upcoming version 0.17)~~		irm name register nc layer local

	# bind the netcat program to <name>		# bind the netcat program to <name>

Thijs: /* ioq3 */ Update external links

2023-12-25T23:39:46Z

ioq3: Update external links

← Older revision		Revision as of 23:39, 25 December 2023
Line 1:		Line 1:
	= ioq3 =		= ioq3 =

	As a demo, we have added O7s support to the [https://github.com/ioquake/ioq3 ioq3] game engine. ioq3 is a fork of ID software’s Quake III Arena GPL Source Release. The port is available as a patch. The servers currently only work in dedicated mode (there is no way yet to start a server from the client).		As a demo, we have added O7s support to the [https://github.com/ioquake/ioq3 ioq3] game engine. ioq3 is a fork of ID software’s [https://github.com/id-Software/Quake-III-Arena Quake III Arena GPL Source Release]. The port is available as a [https://{{SERVERNAME}}/patches/ouroboros-ioq3.patch patch]. The servers currently only work in dedicated mode (there is no way yet to start a server from the client).

	To get the demo, first get the latest ioq3 sources:		To get the demo, first get the latest ioq3 sources:
Line 20:		Line 20:
	$ STANDALONE=1 make		$ STANDALONE=1 make

	You may need to install some dependencies like SDL2, see the ioq3 documentation.		You may need to install some dependencies like [https://wiki.libsdl.org/SDL2/Installation SDL2], see [https://ioquake3.org/help/building-ioquake3/building-ioquake3-on-linux/ the ioq3 documentation].

	The ioq3 project only supplies the game engine. To play Quake III Arena, you need the original game files and a valid key. Various open source games make use of the engine. We ~~wil~~ detail the procedure for running OpenArena in your ioq3 build directory.		The ioq3 project only supplies the game engine. To play Quake III Arena, you need the original game files and a valid key. Various open source games make use of the engine. We will detail the procedure for running OpenArena in your ioq3 build directory.

	Go to your build directory:		Go to your build directory:
Line 28:		Line 28:
	$ cd build/<release_dir>/		$ cd build/<release_dir>/

	To run OpenArena, you only need to the game files. First download the zip archive (openarena-0.8.8.zip) from the OpenArena website (or via wget) and then extract the baseoa folder:		To run OpenArena, you only need to the game files. First download the zip archive (openarena-0.8.8.zip) from the [http://www.openarena.ws/ OpenArena website] (or via wget) and then extract the baseoa folder:

	$ wget http://www.openarena.ws/request.php?4 -O openarena-0.8.8.zip		$ wget http://www.openarena.ws/request.php?4 -O openarena-0.8.8.zip
	$ unzip -j openarena-0.8.8.zip 'openarena-0.8.8/baseoa/*' -d ./baseoa		$ unzip -j openarena-0.8.8.zip 'openarena-0.8.8/baseoa/*' -d ./baseoa

	Make sure you have a local Ouroboros layer running in your system (see this tutorial).		Make sure you have a local Ouroboros layer running in your system (see [[Ouroboros Tutorial 01\|this tutorial]]).

	To test the game, start a server (replace with the correct architecture extension for your machine, eg x86_64):		To test the game, start a server (replace with the correct architecture extension for your machine, eg x86_64):

Dimitri: /* netcat */

2023-12-11T11:01:20Z

netcat

← Older revision		Revision as of 11:01, 11 December 2023
Line 55:		Line 55:

	= netcat =		= netcat =

			Ouroboros-netcat instructions:

			Clone the repo (somewhere):

			git clone https://github.com:dstaesse/netcat
			cd netcat

			To compile this Ouroboros version:

			LIBS=-louroboros-dev ./configure

			Or, to enable debugging output (the netcat -d flag):

			LIBS=-louroboros-dev ./configure --enable-debug=yes

			And give it a simple "make" command:

			make

			Ouroboros support is toggled with the -O flag.

			To start netcat in Ouroboros listen mode (assuming you are in the src/ folder):

			./netcat -Ol

			To send some data to the netcat instance:

			./netcat -Oc <name>

			Brief example over the "local" IPCP (you may need up to 3 terminal windows).

			#start the irmd
			sudo irmd --stdout

			#create a "local" IPCP.
			irm ipcp bootstrap type local name local layer local

			# register the netcat name in the local layer
			irm name register nc layer local (be branch / upcoming version 0.17)

			# bind the netcat program to <name>
			irm bind prog ./netcat

			# start an Ouroboros listen server (with some verbosity)
			./netcat -Ovvl

			# and from another terminal, send it a couple of bytes:
			echo "Here's Johnny!" \| ./netcat -Oc nc

			# if all went well, you should see the following output on the server side
			$ ./netcat -Ovvl
			Flow received (new fd=64)
			Here's Johnny!
			^CExiting.
			Total received bytes: 15
			Total sent bytes: 0

Dimitri: /* ioq3 */

2023-12-11T10:57:33Z

ioq3

← Older revision		Revision as of 10:57, 11 December 2023
Line 1:		Line 1:
	= ioq3 =		= ioq3 =

			As a demo, we have added O7s support to the [https://github.com/ioquake/ioq3 ioq3] game engine. ioq3 is a fork of ID software’s Quake III Arena GPL Source Release. The port is available as a patch. The servers currently only work in dedicated mode (there is no way yet to start a server from the client).

			To get the demo, first get the latest ioq3 sources:

			$ git clone https://github.com/ioquake/ioq3.git
			$ cd ioq3

			Copy the patch via the link above, or get it via wget:

			$ wget https://ouroboros.rocks/patches/ouroboros-ioq3.patch

			Apply the patch to the ioq3 code:

			$ git apply ouroboros-ioq3.patch

			With Ouroboros installed, build the ioq3 project in standalone mode:

			$ STANDALONE=1 make

			You may need to install some dependencies like SDL2, see the ioq3 documentation.

			The ioq3 project only supplies the game engine. To play Quake III Arena, you need the original game files and a valid key. Various open source games make use of the engine. We wil detail the procedure for running OpenArena in your ioq3 build directory.

			Go to your build directory:

			$ cd build/<release_dir>/

			To run OpenArena, you only need to the game files. First download the zip archive (openarena-0.8.8.zip) from the OpenArena website (or via wget) and then extract the baseoa folder:

			$ wget http://www.openarena.ws/request.php?4 -O openarena-0.8.8.zip
			$ unzip -j openarena-0.8.8.zip 'openarena-0.8.8/baseoa/*' -d ./baseoa

			Make sure you have a local Ouroboros layer running in your system (see this tutorial).

			To test the game, start a server (replace with the correct architecture extension for your machine, eg x86_64):

			$ ./ioq3ded.<arch> +set com_basegame baseoa +map aggressor

			Bind the pid of the server to a name and register it in the local layer:

			$ irm bind proc <pid> name my.ioq3.server
			$ irm name reg my.ioq3.server layer <your_local_layer>

			To connect, start a client (in a different terminal):

			$ ./ioquake3.<arch> +set com_basegame baseoa

			When the client starts, go to the console by typing ~ (tilde) and enter the following command

			connect -O my.ioq3.server

			The client should now connect to the ioq3 dedicated server over Ouroboros. Register the name in non-local layers to connect from other machines. Happy Fragging!

	= netcat =		= netcat =

Dimitri: Created page with "= ioq3 = = netcat ="

2023-12-11T10:55:47Z

Created page with "= ioq3 = = netcat ="

New page

= ioq3 =

= netcat =