View source for Arcade Cabinet Linking

This article goes over all the aspects you need to know when it comes to linking either real physical cabinets, PCs running MAME, or a combination of the two. Please note these tutorials are written with the expectation you have basic computer knowledge like how to use a command line interface as well as fundamental networking concepts.

Disclaimer: MAME networking support is still very much in an alpha state. The emulator has a tendency to crash at random and wireless interfaces are '''NOT SUPPORTED'''. You must use a wired network interface. Additionally this likely only works on Windows and Linux (unverified) - MacOS is not supported.

First, determine which scenario applies to your setup the best by looking at the table of contents:

__TOC__

==Real cabinets at one physical location==

This is the easiest scenario - All you simply have to do is connect one or more (maximum of 8) cabs to the same unmanaged network switch. Afterwords, adjust each cabinet's setting so that the car color (for San Francisco Rush/Rush The Rock) or cabinet number (for Rush 2049) is different for each cab. You can then enter the network test on every cab through the test menu - Each cab should show up on each other cab. From there reboot back into the game and start a game and select a course on one cab. All other cabs should get an invitation to join the game that is about to start.

==Real cabinet(s) and MAME PC(s) at one physical location==

First, connect one or more (maximum of 8) cabs and/or PCs to the same unmanaged network switch.

TODO: Detailed steps

* Test if game can run at full speed on PC (critical for reliable linked play)
* Install TAP adapter
* Create bridge between NIC and TAP adapter
* Configure MAME to use TAP adapter
* Set up game (change car color/cab number, network test)

Afterwords, adjust each cabinet's setting so that the car color (for San Francisco Rush/Rush The Rock) or cabinet number (for Rush 2049) is different for each cab. You can then enter the network test on every cab through the test menu - Each cab should show up on each other cab.

==Real cabinet(s) at multiple physical locations==

In order to link one or more cabinets at multiple locations you will need some sort of network device that can bridge Layer 2 network traffic over a VPN connection where each cabinet or cabinets are located. The simplest to set up is [https://zerotier.com/ ZeroTier].

This device could be something like a Linux PC or a router with OpenWRT with at least two network interfaces.

===Create ZeroTier network===

# Navigate to [https://my.zerotier.com/ My ZeroTier] and create an account, then log in and create a network.
# Note the join code - It will look like this:
<code>123abc456def789g</code>
# Keep this open as we will need to access it later to approve our devices.
# Optionally, give this network a name as well.

===Preparing the bridge device===

====Generic Linux device running Debian-based distribution====

=====Automated install script=====

=====Manual setup=====

1. Install packages via package manager:

<code>apt update && apt install curl bridge-utils gpg</code>

2. Add the ZeroTier GPG Key, download and install ZeroTier:

<code>curl -s 'https://raw.githubusercontent.com/zerotier/ZeroTierOne/master/doc/contact%40zerotier.com.gpg' | gpg --import && if z=$(curl -s 'https://install.zerotier.com/' | gpg); then echo "$z" | sudo bash; fi</code>

3. Join your ZeroTier network you created earlier:

<code>zerotier-cli join 123abc456def789g</code>

4. Wait for about 5-10 seconds and check if your device appears in your My ZeroTier account, then check the "Auth?" checkbox and optionally give it a name.

5. Click the wrench icon and check the following boxes: Allow Ethernet Bridging, Do Not Auto-Assign IP.

6. Check that your device has connected to your ZeroTier network:
<code>zerotier-cli info</code>

7. Identify your network interfaces and note the name of the wired network interface that will connect to the switch that your cabs will be plugged into, as well as the name of your ZeroTier interface (starts with <code>zt</code>):

<code>ip a</code>

8. Create a bridge and add the interfaces to the bridge:

<code>brctl addbr br0</code>
<br>
<code>brctl addif br0 eth0</code>
<br>
<code>brctl addif br0 ztppabc123</code>

9. Restart your networking stack to apply the changes:

<code>systemctl restart networking</code>

From there, repeat these steps for the device at the other end that will perform the network bridging.

Note: With this, your bridge will be deleted upon reboot - Now is a good time to test and if it doesn't work, you can simply reboot to undo the changes. If everything works as expected, you can write these lines to <code>/etc/network/interfaces.d/br0</code>:

<code>auto br0</code>
<br>
<code>iface br0 inet dhcp</code>
<br>
<code>    bridge_ports eth0 ztppabc123</code>

This will make the bridge stay even after reboots.

====OpenWRT Device====

# By default, OpenWRT uses a 192.168.1.0/24 subnet, which may overlap with your current network at home - You will want to change this to prevent overlapping IP addresses to prevent packet routing issues. A good option would be to use 192.168.209.1 for the OpenWRT device. Change this on your br-lan interface and then reconnect to your router's new IP address.

# Connect your existing network into the WAN/Internet port on your OpenWRT device so has internet connectivity.

# Navigate to System > Software and click "Refresh Lists".

# In the package list, filter for "zerotier" and install the "zerotier" package.

# SSH into your router and execute the following commands as root:

<code>uci set zerotier.openwrt_network=zerotier</code>
<br>
<code>uci add_list zerotier.openwrt_network.join='123abc456def789g'</code>
<br>
<code>uci set zerotier.openwrt_network.enabled='1'</code>
<br>
<code>uci commit zerotier</code>

# Reboot your router.

# Navigate to Network > Interfaces and click on the Devices tab.

# Edit the br-lan device. In the dropdown, select the ZeroTier virtual interface (Interface name will start with ztpp).

# Save and apply the changes.

# Repeat this step for any additional OpenWRT devices at other locations.

== Real cabinet(s) and MAME PC(s) at multiple physical locations==

TODO