H3MP

H3MP - Multiplayer mod for H3VR

As the title says, this is a mod that adds multiplayer to the virtual reality game Hotdogs, Horseshoes and Handgrenades.

MAIN BUILD - H3 Beta should be set to "None".

IMPORTANT

- Untested, TNH patches were not properly reviewed. There is not guarantee the mod even works. At least the code is up to date and compiles.

• See incompatibilities section below for a list of known incompatible mods and modes.
• Only report bugs if you don't use any of the mods from the incompatibilities list.
• Report bugs in the H3VR homebrew discord server (Look it up on google) and always send _full_ output logs.
• If you get "PatchVerify" errors on start up it means either your game or H3MP is the wrong version.
• Port forward or hosting solution must support both TCP and UDP
• UPnP will not work if you are behind multiple NATs. That means if you computer is connected to the internet through multiple routers.

Manual Installation

1. Download and install the latest (_not pre-release_) version of BepinEx
2. Download the latest release of H3MP
3. Put the H3MP folder from the zip file into the plugins folder (H3VR\BepInEx\plugins)

So you should end up with a H3VR\BepInEx\plugins\H3MP folder, containing H3MP.dll and other files.

Automatic Installation

Can be done through thunderstore using r2modman mod manager

Usage

All H3MP functions can be accessed through the wristmenu, in-game.

Hosting and joining can be done entirely from the in-game server list, accessible through H3MP's wristmenu section. The server list will let you host and join directly, as well as list your server publicly and join public servers. Upon hosting, you will have a check mark labeled "Forwarded". If left unchecked, UPnP will be used to open the entered port. Otherwise you will be expected to have already forwarded the port.

Direct connection, as could be done before without the server list, can still be done exactly the same way. To join a server directly, you will have to have set the IP and port of the server in your config file (see Config section below), then, in the wristmenu, press H3MP->Join. To host directly, you will have to open a port, set that port in your config file, and then, in the wristmenu, press H3MP->Host.

_If you forgot to set these before going in-game and restarting the game is too much of a hassle, mainly for people with 200+ mods that I figured probably take a while to load, you can set your config, then go to H3MP->Options->Reload config in the wristmenu which will reload your configs, after which you can connect/host_

Options

In the wristmenu, some options are available:

• _Reload config_: Will reload the config file if you modified it since starting the game. Useful if you modified it and don't want to have to restart the game.

• _Item interpolate_: This will toggle item interpolation. Item interpolation is the smoothing of item movement to prevent everything from looking "jagged". Turning it off will ensure that items are positionned/rotated exactly as you receive the data from another client. Due to latency, this will make item movement look extremely low FPS.

• _TNH Revive_: Will revive you if you are in MP TNH. This is so you can rejoin an ongoing game without having to restart it. Also useful if wanting to use a TNH map similarly to a sandbox map but dying respawns you in the wrong place. This will respawn you at your spawn supply point and get rid of your dead and spectating status.

• _Current color_: Lets you go through certain colors of player model. This color will be visible to other players. Available colors: White, Red, Green, Blue, Black, Desert, and Forest. Note that Desert and Forest are not camo they're just Beige and Dark green. Only available while connected!

• _Current IFF_: Lets you change IFF. Note that friendly fire is currently always on. Only available while connected!

• _Color by IFF_: Toggle that lets the host decide whether player colors should correspond to IFF. IFF 0 corresponds to White, 1 to Red, 2 to Green, and so on. Sequence is same as in _Current color_ option. The color then loops, so IFF 7 will correspond to White. Only available to Host!

• _Nameplate mode_: Lets host decide in which case the nameplate and health of a player should be visible. Available modes are: All, Friendly Only (Default), and None. All means all nameplates will always be visible to everyone, Friendly Only means nameplates will only be visible to player with same IFF, and None means no nameplates will be visible, no matter the IFF. Only available to Host!

• _Radar mode_: Lets host decide which players should be visible on the TNH radar. Available options are: All (Default), Friendly Only, and None. All will show both friendly and enemy players, Friendly Only will show only friendly players (same IFF), and None will show no other player, regardless of IFF. Only available to Host!

• _Radar Color IFF_: Lets host decide which colors players should have on the TNH radar. If true it will show players as Green or Red, depending on whether they are Friendly or Enemy, respectively. If false, it will instead show players with their corresponding colors. Only available to Host!

• _Max health_: Lets host decide the max player health in their current scene/instance. Available options are: Unset (default), 1, 500, 1000, 2000, 3000, 5000, 7500, and 10000. Unset means that the maximum health will be what was set by vanilla. Only available to Host!

Config

The config refers to a file in the H3MP folder called Config.json which contains a few important settings.

• _IP_: The IP of the server you will be joining
• _Port_