NetherNet configuration - PetteriM1/NukkitPetteriM1Edition GitHub Wiki

Game versions 26.30 and newer can use NetherNet to connect when enabled on the server in most cases. NetherNet is required starting from 26.60.

How to enable NetherNet

In server.properties:

  • nethernet=on
  • Set server-port to a free tcp port. Players will enter this port in game (default 19132).
    • RakNet will keep using this port (udp) if raknet=on.
  • Set webrtc-port to a free udp port.
    • Must not be the same as server-port if raknet=on. You can disable RakNet if you don't need to support old versions.

Optionally:

  • Generate nethernet-identity.p12, put it in server directory and set nethernet-identity-password to the password of generated nethernet-identity.p12 file.
    • Players will be asked to trust the server only on first join.
    • keytool -genkeypair -alias identity -keyalg EC -groupname secp384r1 -storetype PKCS12 -keystore nethernet-identity.p12 -storepass nethernet -dname "CN=Your Server" -validity 36500
  • Update connections-per-address (default 8) if needed by certain lan or proxy setups.
  • Set advertised-addresses if the server does not see the host's real public IP.
    • In format public-ip:webrtc-port (advertised-addresses=123.345.56.78:20132) separated by "," if multiple
  • Set webrtc-mtu manually only if tunneling traffic is causing automatic option not to work.

Issues connecting on consoles?

Do not use firewall to drop packets on 443/tcp. Instead reject/reset the connection or have your website return 404 for /v1/join.