Repository files navigation

The H2M in-game server browser has a few bugs where it does not display the whole server list or does not join the correct server. The launcher aims to address these issues and provide more features.

Join if you want to stay up-to-date with the launcher, have questions, suggestions, or looking for people to play H2M with.

• Launch H2M-Mod.
• Displays the server count and the total players.
• Join other servers without having to disconnect first.
• Utilizes theIW4MAdmin API to get accurate and up to date server information.
• Sort servers byname, map, mode, player count, and ping.
• Additional filter options:
  • View empty, full, or private servers.
  • Minimum and maximum players.
  • Maximum server slots.
  • Map packs (MWR, MW2, MW2CR, Etc...)
  • Gamemodes.
  • Maximum Ping.
  • Filter out any keywords from the hostname, for instance, "trickshot" to filter out trickshot servers.
• Add servers to favourites and view recently played servers.
• Support for private servers, you can enter the password from the launcher.
• Filters out dead/zombie servers that do not respond to UDP packets being sent.
• Reconnect to last server shortcut (seeShortcuts).
• Game overlay (seeShortcuts).

• Search preferences for the matchmaking.
• Centralized server for queueing.
• Predefined playlist(s) of "trusted" servers.
• Provides a list of privileged slots for servers.

• Global player queues for full servers.
• See your position and how many players are in the queue.
• Takes privileged slots into account (Currently manually configured, request more servers to be supported!)
• Ability to force join without leaving the queue if it fails.
• Join the queue while playing on another server and automatically connect when the slot is free.

• Invite your friends to join the party by copying the party ID.
• The party leader controls the session for everyone.
• Supports joining,Queueing andMatchmaking.
• Ability to kick members or promote someone to party leader.

• Detect whether the game is running.
• Detect whether the player is in the menu or connected to a server.
• Automatically set the game location if unset in settings and the game is detected.

• Auto-Updater(Click on the new version available text to download latest release).
• Settings menu to set the master server URL or set the directory of the H2M-Mod Executable.
• Toggle game communication and server queueing.
• Change keybindings for reconnect and refresh.

1. Download the latest release fromHERE.

2. Paste theH2M-Launcher.UI.exe inside the root of the game directory and run it.

• If you want to store the launcher elsewhere, you can set the path to theh2m-mod.exe in the settings.
• Click the settings icon in the bottom right corner of the launcher, and you should see theGame Location option that you can change.

3. Before using the server browser make sure H2M is running. You can pressLaunch H2M to run the game.

4. Find a server you want to play on, select it, and press the join button. The H2M window should automatically be set as the foreground window.

This section will try to address most common issues people may encouter while using the browser.The FAQ will be regurarly updated while receiving feedback.Please read through this section before creating an issue.

The log files can be found in the following directory:%localappdata%\BetterH2MLauncher

Fastest way to access the directory is by pressingWin + R to open the run menu and paste the directory in theOpen text box.

Answer: Either the server is not running or you need to change one or more windows settings.

• If you are on Windows 11, you need to change your default terminal toWindows Console Host. This is found underSettings > System > For Developers. Make sure to restart your game after changing the terminal.

• If the above does not apply to you or it still does not send a connect command, you may need to add/change your keyboard layout toEnglish US.

Answer: Open theServer List orAPI Link in your browser and see if you are able to reach the domain. If not, then check if your ISP or firewall is blocking you from accessing the domain.Alternatively, you can try switching to the alternative master serverhttp://api.raidmax.org:5000.

Answer: The launcher only displays servers that are actually running. Many servers in the IW4MAdmin-Master Panel are offline and reporting false stats.

• Make sure that the server reports an IPv4 Address to the panel, as IPv6 servers are not supported and will not show up.

Answer: It is possible that the launcher fails to copy the server command to your clipboard, this could be because another application is currently using your clipboard and is still holding on to that process.Go to your Windows Settings and search for Clear Clipboard.

Answer: Delete thelaunchersettings.json file located atC:\Users\<YourUserName>\AppData\Local\BetterH2MLauncher. After deleting the json file, next time you launch the exe it should be created again.

1. If you wish to compile the code from source, clone the repository and open theH2MLauncher.sln solution using Visual Studio or JetBrains Rider.

2. Open the terminal inside theH2MLauncher.UI project directory and run the following command to create a standalone executable:

dotnet publish-r win-x64/p:PublishSingleFile=true/p:IncludeNativeLibrariesForSelfExtract=true--self-contained true

3. The executable should now be found underbin/Release/net8.0/win-x64/publish and you can copy it into your game directory from there.