Getting Started

Download

Windows: HappinessMP Server 2.1.1 Windows.zip (Last updated: 2026-08-20)
Linux: HappinessMP Server 2.1.1 Linux.zip (Ubuntu 22.04, Last updated: 2026-08-20)

Windows installation

1. Download server files from Download section.
2. Extract the ZIP archive.
3. Configure the settings.xml according to your needs (see Settings for more info).
4. Run HappinessMP.Server.exe.

Linux installation

1. Download server files from Download section.
2. Extract the ZIP archive:

   unzip "HappinessMP Server 2.1.1 Linux.zip" -d happinessmp-server
   cd happinessmp-server

3. Configure the settings.xml according to your needs (see Settings for more info).
4. Make the server binary executable:

   chmod +x HappinessMP.Server.out

5. Run the server:

   ./HappinessMP.Server.out

Ports

If you want your server to be reachable from the internet, you have to open the following ports in your firewall and forward them in your router:

Port	Protocol	Description
9999 (default)	UDP and TCP	Main port. Handles the general communication between client and server as well as the HTTP server.
9998 (default)	UDP	Relay port. Mainly used for the exchange of game sync packets.

Both ports have to be open, otherwise players will not be able to join. If you changed the port in your settings.xml, open your configured ports instead of the defaults.

Example for Linux with ufw:

sudo ufw allow 9999/tcp
sudo ufw allow 9999/udp
sudo ufw allow 9998/udp

On Windows you can add the rules via Windows Defender Firewall → Advanced settings → Inbound Rules → New Rule.

Connect to my server

Either simply connect via the server list or use 127.0.0.1 on the direct connect page in the launcher.