Skip to content

Setup

Jump to bottom Edit New page
sepalani edited this page Sep 1, 2025 · 10 revisions

Caution

If you want to join the open beta which supports multiplayer, please check #open-beta-instructions on Discord.

This guide is only for people wanting to host a server on a local infrastructure (multiplayer unsupported).

Several steps must be followed to setup this server project properly.

NB: This guide also works with InusualZ's MHTriServer, you just need to follow MHTriServer requirements instead of the Setup MH3SP section.

The Patching the game and Troubleshooting sections of this guide still apply.

Prerequisites

Python 2.7

Download and install the latest version of Python 2.7:

  • Windows: I'd recommend the x86 MSI installer even for 64-bit machines
  • Linux: On a Debian's terminal run: sudo apt install python2.7

Twisted for Python 2.7

On Windows run on a terminal (cmd.exe or powershell.exe):

  • C:\Python27\python.exe -m pip install twisted
  • OR C:\Python27\Scripts\pip.exe install twisted

The command is similar on Linux systems:

  • python2.7 -m pip install twisted
  • pip2.7 install twisted

Setup AltWFC

Download AltWFC

Configure the server

Since we don't need all servers, we don't need to install Apache and can just use the alternative config file:

  • In AltWFC's altwfc.cfg, set AlternativeConfig to ON

Start the server

On Linux you can start the server with this command:

  • sudo python2.7 master_server.py
    • NB: sudo is needed to bind on port 80 unless you set on the executable the cap_net_bind_service Linux capability.

On Windows, if you have only one version of python can double click on master_server.py to start it. Otherwise, you will have to run it from a terminal:

  • SHIFT + Right-click > Open a terminal here

  • OR Type cmdin the address bar and press Enter:

  • Then, run C:\Python27\python.exe master_server.py

If there aren't any SSL/socket error, the server is running correctly like the screenshot above.

Redirect the network traffic

For Dolphin emulator

If you plan to play on Dolphin, you can use your hosts file to redirect the network traffic.

hosts file location:

  • Windows: %SystemRoot%\system32\drivers\etc\hosts
  • Mac OS: /private/etc/hosts
  • Linux: /etc/hosts

Example of hosts file:

# Nintendo WFC
127.0.0.1 gpcm.gs.nintendowifi.net
127.0.0.1 gpsp.gs.nintendowifi.net
127.0.0.1 naswii.nintendowifi.net
127.0.0.1 nas.nintendowifi.net
127.0.0.1 gamestats.gs.nintendowifi.net
127.0.0.1 gamestats2.gs.nintendowifi.net
127.0.0.1 wiinat.available.gs.nintendowifi.net
127.0.0.1 wiinat.natneg1.gs.nintendowifi.net
127.0.0.1 wiinat.natneg2.gs.nintendowifi.net
127.0.0.1 wiinat.natneg3.gs.nintendowifi.net
# Monster Hunter 3 (JAP)
127.0.0.1 monhunter3wii.gamestats.gs.nintendowifi.net
127.0.0.1 monhunter3wii.gamestats2.gs.nintendowifi.net
127.0.0.1 monhunter3wii.available.gs.nintendowifi.net
127.0.0.1 monhunter3wii.natneg1.gs.nintendowifi.net
127.0.0.1 monhunter3wii.natneg2.gs.nintendowifi.net
127.0.0.1 monhunter3wii.natneg3.gs.nintendowifi.net
127.0.0.1 monhunter3wii.master.gs.nintendowifi.net
127.0.0.1 monhunter3wii.ms16.gs.nintendowifi.net
# Monster Hunter 3 (EU/US)
127.0.0.1 mh3uswii.available.gs.nintendowifi.net
127.0.0.1 mh3uswii.natneg1.gs.nintendowifi.net
127.0.0.1 mh3uswii.natneg2.gs.nintendowifi.net
127.0.0.1 mh3uswii.natneg3.gs.nintendowifi.net
127.0.0.1 mh3uswii.master.gs.nintendowifi.net
127.0.0.1 mh3uswii.gamestats.gs.nintendowifi.net
127.0.0.1 mh3uswii.gamestats2.gs.nintendowifi.net
127.0.0.1 mh3uswii.ms1.gs.nintendowifi.net
# Wiimmfi
127.0.0.1 gpcm.gs.wiimmfi.de
127.0.0.1 gpsp.gs.wiimmfi.de
127.0.0.1 naswii.wiimmfi.de
127.0.0.1 nas.wiimmfi.de
127.0.0.1 gamestats.gs.wiimmfi.de
127.0.0.1 gamestats2.gs.wiimmfi.de
127.0.0.1 wiinat.available.gs.wiimmfi.de
127.0.0.1 wiinat.natneg1.gs.wiimmfi.de
127.0.0.1 wiinat.natneg2.gs.wiimmfi.de
127.0.0.1 wiinat.natneg3.gs.wiimmfi.de
# Monster Hunter 3 (JAP)
127.0.0.1 monhunter3wii.gamestats.gs.wiimmfi.de
127.0.0.1 monhunter3wii.gamestats2.gs.wiimmfi.de
127.0.0.1 monhunter3wii.available.gs.wiimmfi.de
127.0.0.1 monhunter3wii.natneg1.gs.wiimmfi.de
127.0.0.1 monhunter3wii.natneg2.gs.wiimmfi.de
127.0.0.1 monhunter3wii.natneg3.gs.wiimmfi.de
127.0.0.1 monhunter3wii.master.gs.wiimmfi.de
127.0.0.1 monhunter3wii.ms16.gs.wiimmfi.de
# Monster Hunter 3 (EU/US)
127.0.0.1 mh3uswii.available.gs.wiimmfi.de
127.0.0.1 mh3uswii.natneg1.gs.wiimmfi.de
127.0.0.1 mh3uswii.natneg2.gs.wiimmfi.de
127.0.0.1 mh3uswii.natneg3.gs.wiimmfi.de
127.0.0.1 mh3uswii.master.gs.wiimmfi.de
127.0.0.1 mh3uswii.gamestats.gs.wiimmfi.de
127.0.0.1 mh3uswii.gamestats2.gs.wiimmfi.de
127.0.0.1 mh3uswii.ms1.gs.wiimmfi.de
# Capcom server
127.0.0.1 mh.capcom.co.jp
127.0.0.1 mmh-t1-opn01.mmh-service.capcom.co.jp
127.0.0.1 mmh-t1-opn02.mmh-service.capcom.co.jp
127.0.0.1 mmh-t1-opn03.mmh-service.capcom.co.jp
127.0.0.1 mmh-t1-opn04.mmh-service.capcom.co.jp

For a real Wii

You need to hosts a DNS server and redirect the network traffic to your local machine. This project provides a dummy DNS server that might work on simple network configuration.

You can run it via the following command:

  • On Windows: C:\Python27\python.exe dns_server.py
  • On Linux: sudo python2.7 dns_server.py
    • NB: sudo is needed to bind on port 53 unless you set on the executable the cap_net_bind_service Linux capability.

Then, enter the IP address displayed on the dns_server.py window as primary DNS in a working Internet connection from your Wii connection settings.

The redirection is working if:

  1. The Wii connection test succeeded
  2. AND you see on the dns_server.py window the sites that the Wii connected to.

Setup MH3SP

You should be all set as it can run under Python2.7 (like AltWFC) and Python3.

Download MH3SP

Configure the server

If you want to enable the sandstorm or the Japanese version support:

Start the server

You should be able to start the server by double-clicking on the master_server.py file.

If not, as usual run:

  • On Windows: C:\Python27\python.exe master_server.py
  • On Linux: python2.7 master_server.py

It should spawn 4 new log windows and the main window should look like this:

Patching the game

To connect properly to the AltWFC and MH3SP servers, the network traffic must be redirected and the game must be patched:

Troubleshooting

Some common issues and their solutions:

Add a custom footer
Add a custom sidebar

Clone this wiki locally