Difference between revisions of "Connectivity"

From DOSBoxWiki
Jump to: navigation, search
(DOSBox Local Network configuration)
 
(12 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The below article is directed from a free resource which the link is stated at below line:
+
DOSBox networking works in a client-server architecture, where one machine acts as a server and all the others connect to it as its clients. DOSBox emulates outdated protocols and actually routes them to Internet's own IP protocol (TCP/IP for serial/modem emulation and the even better UDP/IP for IPX emulation).
http://www.dedoimedo.com/games/reviving/dosbox_multiplayer.html
+
  
The name of the author was undisclose, however, speacial thanks to the original author for contributing this information.
+
== IPX emulation ==
 +
First, [[Dosbox.conf#%5Bipx%5D|enable IPX]].
  
 +
=== Start IPX server ===
  
== Enjoying multiplayer games on LAN in DOSBox - IPX ==
+
Power on DOSBox on all the computers that you want to participate in the LAN games. One of these computers will have to act as a server. The rest will be clients.
  
 +
On the server machine, execute the following command:
  
By now, you have already discovered that I'm a bit of an old games fan. Using DOSBox is probably the simplest, most sensible way of enjoying your old favorites. But so far, I have only shown you the single player mode. DOSBox also allows you to setup multiplayer games.
+
ipxnet startserver [UDP port]
  
 +
See screenshot below:
  
If you have more than one computer and would like to enjoy a session of Doom, Warcraft or any other 90s classic, then read on.
+
[[Image:dosbox_lan_02.png]]
  
This article will show you how to setup multiplayer games using IPX protocol. A follow-up article will demonstrate how to play even older games using direct serial connection.
+
UDP port is optional. Otherwise it defaults to 213 (the assigned IANA port for IPX tunnelling). If you want another port, for example, port 19900, type:
 +
ipxnet startserver 19900
  
 +
If you change the default, it's customary to choose something above 1024 as anything below is considered reserved. In Linux specifically, only root (or superuser) can use port numbers lower than 1024.
  
 +
Whatever UDP port is chosen (including the default), '''it must be forwarded and open to the outside network if a server is hidden behind a router (NAT)'''.
  
== DOSBox Local Network configuration ==
+
=== Start client(s) ===
  
=== Enable IPX Networking Emulation ===
+
On each one of the clients, run the following command to connect to the server:
First, we must enable IPX networking emulation.
+
  
Find and open the '''dosbox.conf''' file (the configuration file for DOSBox); it should be located in the DOSBox directory.
+
ipxnet connect <IP> [UDP port]
  
You can find the '''dosbox.conf''' by browsing '''Start > All Programs > Dosbox'''
+
For example:
  
 +
ipxnet connect 192.168.2.100
  
[[Image:Dosbox_config.png]]
+
See screenshot below:
  
 +
[[Image:dosbox_lan_03.png]]
  
Inside the file, search for an entry labeled [ipx]. Below the explanation comment (marked with #), change the configuration line from ipx=false to ipx=true as shown in the example below.
+
Port is optional. The same rules apply as in [[#Start IPX server]]. For example:
 +
ipxnet connect 192.168.2.100 19900
  
[ipx]
+
You now have the network running. You can confirm it by typing:
# ipx -- Enable ipx over UDP/IP emulation.
+
  IPXNET STATUS
+
If you want to check the speed and/or see the list of server and all clients, type:
ipx=true
+
  IPXNET PING
  
You might find it hard to believe, but this is ALL of the tampering with the configuration files you will need.
+
'''Start your game'''
  
 +
If you're done, but want to remain in DOSBox, the clients can optionally use the following commands:
 +
  IPXNET DISCONNECT
 +
and only after all clients disconnect (or you'll risk locking them up), the server can type:
 +
  IPXNET STOPSERVER
  
=== Start IPX server ===
+
== Modem emulation==
 +
First, define [[Configuration:SerialPort]].
  
Power on DOSBox on all the computers that you want to participate in the LAN games. One of these computers will have to act as a server. The rest will be clients.
+
If you change the default TCP port, it's customary to choose something above 1024 as anything below is considered reserved. In Linux specifically, only root (or superuser) can use port numbers lower than 1024.
  
On the server machine, execute the following command:
+
Whatever TCP port is chosen (including the default 5000), '''it must be forwarded and open to the outside network if a server is hidden behind a router (NAT)'''.
  
ipxnet startserver
+
===The game's modem options===
 +
You must enter the game's modem options and:
 +
* Define the same COM number as you chose in DOSBox. If the game is hardcoded to a certain COM number, this must be the one you choose in DOSBox.
 +
* Choose the highest modem's speed the game allows.
 +
* <sup>''For [[#Emulating making a call|clients only]]''</sup> If there's an address book, you can define the server in advance. Actually, some games might refuse to call anyone that's not listed in advance in the address book.
 +
* The game's other modem options don't matter in DOSBox.
  
See screenshot below:
+
Exit the settings, enter the game itself and find the call/answer menu entry.
  
[[Image:dosbox_lan_02.png]]
+
====Emulating answering a call====
 +
Some games may want you to define an auto-answer command in advance, while others may want you to answer manually when the call comes in. Some may allow both modes.
  
 +
In the first mode, the server should choose the "wait for calls" option in their game. If the game wants you to type a manual command, use "ATS0=1" (answer on first call).
  
=== Start client(s) ===
+
In the second mode, the server should choose the "answer call" option when the game announces a call is coming in. If the game wants you to type a manual command, use "ATA".
  
On each one of the clients, run the following command to connect to the server:
+
====Emulating making a call====
 +
The client should choose the "make a call" option in their game. Then supply the server's hostname or IP address.
  
ipxnet connect <IP >
+
If the game wants you to type a manual command, use "ATDT<IP>". For example, if the server is "hosty" <1.2.3.4>, type:
 +
ATDT1.2.3.4
 +
or "ATDT<HOST>". For example, in the case of "hosty":
 +
ATDThosty
  
Specifically, in my case:
+
== How to obtain a computer's IP address==
  
ipxnet connect 192.168.2.100
+
If connecting to others on the Internet, search for your [http://www.whatismyip.com/ external IP address] and make sure you forwarded the ports on your router to your computer.
  
See screenshot below:
+
If on a LAN (local network):
  
[[Image:dosbox_lan_03.png]]
+
On GNU/Linux:
 +
ifconfig
  
You now have the network running.
+
On Mac: Press Cmd-Space, type network, press enter, and select the connection. The IP address is to the right.
  
 +
===Windows===
  
'''Start your games'''
+
Go to "My Network Places"
  
Yes, that's it! I have tested this setup on a network where both clients sit behind a router and run a personal firewall. Everything worked (and works) flawlessly. The one thing you may have to do is allow DOSBox network access in your firewall rules.
+
Click on "View My Network Connections"
  
== How to Obtain Computer's IP ==
+
[[Image:Network_settings1.png]]
There are many several ways to obtain a computer's IP address in a local network.
+
  
Below are one of the common way:
+
Right Click the Network that you are using and choose "Status", then, you will be able to obtain the computer's IP address in a local network.
  
Go to "My Network Place"
+
[[Image:Network_settings2.png]]
  
Click on "View My Network Connections"
+
==Dedicated server==
  
[[Image:Network_settings1.png]]
+
You may wish to run a public facing dedicated server, doing this will allow multiple clients (e.g. players behind NAT on their respective broadband connections) to connect outbound to your server and thus see each others games without needing to port forward.
  
 +
Several implementations exist...
  
Right Click the Network that you are using and choose "Status", then, you will be able to obtain the computer's IP address in a local network.
+
====A Linux version by Michał Siejak (MasterM)====
 +
* http://www.vogons.org/viewtopic.php?t=22994#p171180
 +
* http://www.youtube.com/watch?v=uy-a0PzCw1E
 +
* http://github.com/intangir/ipxnet
  
 +
====A Perl version by Alexander Clouter (diGriz)====
 +
* http://www.vogons.org/viewtopic.php?t=22994#p179078
 +
* http://github.com/steveschnepp/ipxserver
  
[[Image:Network_settings2.png]]
+
====A Java version by Ralf Grillenberger (H-A-L-9000)====
 +
* http://www.vogons.org/viewtopic.php?t=22994#p171196
 +
* http://home.arcor.de/h-a-l-9000/tunnelserver.html
  
 +
====A Windows version by Joe Petrie (CodeJunkie)====
 +
* http://www.vogons.org/viewtopic.php?t=22994#p185381
 +
* http://www.classicgamingarena.com/downloads
  
 +
====A Linux and Windows version by Hans Peter Anvin (hpa)====
 +
* http://www.vogons.org/viewtopic.php?t=22994&start=20#p209067
 +
* http://git.zytor.com/games/dosbox/ipxrelay.git/
  
== Setting up Modem ==
+
==External links==
- empty -
+
* [http://www.dedoimedo.com/games/reviving/dosbox_multiplayer.html dedoimedo.com] (the original article plus screenshots from actual multiplayer games)
no article yet, please help in editting this section.
+

Latest revision as of 23:22, 9 April 2016

DOSBox networking works in a client-server architecture, where one machine acts as a server and all the others connect to it as its clients. DOSBox emulates outdated protocols and actually routes them to Internet's own IP protocol (TCP/IP for serial/modem emulation and the even better UDP/IP for IPX emulation).

IPX emulation

First, enable IPX.

Start IPX server

Power on DOSBox on all the computers that you want to participate in the LAN games. One of these computers will have to act as a server. The rest will be clients.

On the server machine, execute the following command:

ipxnet startserver [UDP port]

See screenshot below:

Dosbox lan 02.png

UDP port is optional. Otherwise it defaults to 213 (the assigned IANA port for IPX tunnelling). If you want another port, for example, port 19900, type:

ipxnet startserver 19900

If you change the default, it's customary to choose something above 1024 as anything below is considered reserved. In Linux specifically, only root (or superuser) can use port numbers lower than 1024.

Whatever UDP port is chosen (including the default), it must be forwarded and open to the outside network if a server is hidden behind a router (NAT).

Start client(s)

On each one of the clients, run the following command to connect to the server:

ipxnet connect <IP> [UDP port]

For example:

ipxnet connect 192.168.2.100 

See screenshot below:

Dosbox lan 03.png

Port is optional. The same rules apply as in #Start IPX server. For example:

ipxnet connect 192.168.2.100 19900

You now have the network running. You can confirm it by typing:

 IPXNET STATUS

If you want to check the speed and/or see the list of server and all clients, type:

 IPXNET PING

Start your game

If you're done, but want to remain in DOSBox, the clients can optionally use the following commands:

 IPXNET DISCONNECT 

and only after all clients disconnect (or you'll risk locking them up), the server can type:

 IPXNET STOPSERVER

Modem emulation

First, define Configuration:SerialPort.

If you change the default TCP port, it's customary to choose something above 1024 as anything below is considered reserved. In Linux specifically, only root (or superuser) can use port numbers lower than 1024.

Whatever TCP port is chosen (including the default 5000), it must be forwarded and open to the outside network if a server is hidden behind a router (NAT).

The game's modem options

You must enter the game's modem options and:

  • Define the same COM number as you chose in DOSBox. If the game is hardcoded to a certain COM number, this must be the one you choose in DOSBox.
  • Choose the highest modem's speed the game allows.
  • For clients only If there's an address book, you can define the server in advance. Actually, some games might refuse to call anyone that's not listed in advance in the address book.
  • The game's other modem options don't matter in DOSBox.

Exit the settings, enter the game itself and find the call/answer menu entry.

Emulating answering a call

Some games may want you to define an auto-answer command in advance, while others may want you to answer manually when the call comes in. Some may allow both modes.

In the first mode, the server should choose the "wait for calls" option in their game. If the game wants you to type a manual command, use "ATS0=1" (answer on first call).

In the second mode, the server should choose the "answer call" option when the game announces a call is coming in. If the game wants you to type a manual command, use "ATA".

Emulating making a call

The client should choose the "make a call" option in their game. Then supply the server's hostname or IP address.

If the game wants you to type a manual command, use "ATDT<IP>". For example, if the server is "hosty" <1.2.3.4>, type:

ATDT1.2.3.4

or "ATDT<HOST>". For example, in the case of "hosty":

ATDThosty

How to obtain a computer's IP address

If connecting to others on the Internet, search for your external IP address and make sure you forwarded the ports on your router to your computer.

If on a LAN (local network):

On GNU/Linux:

ifconfig

On Mac: Press Cmd-Space, type network, press enter, and select the connection. The IP address is to the right.

Windows

Go to "My Network Places"

Click on "View My Network Connections"

Network settings1.png

Right Click the Network that you are using and choose "Status", then, you will be able to obtain the computer's IP address in a local network.

Network settings2.png

Dedicated server

You may wish to run a public facing dedicated server, doing this will allow multiple clients (e.g. players behind NAT on their respective broadband connections) to connect outbound to your server and thus see each others games without needing to port forward.

Several implementations exist...

A Linux version by Michał Siejak (MasterM)

A Perl version by Alexander Clouter (diGriz)

A Java version by Ralf Grillenberger (H-A-L-9000)

A Windows version by Joe Petrie (CodeJunkie)

A Linux and Windows version by Hans Peter Anvin (hpa)

External links

  • dedoimedo.com (the original article plus screenshots from actual multiplayer games)