Packer-HeadlessServer icon


Unofficial H3MP Headless Server plugin

By Packer
Last updated 2 weeks ago
Total downloads 29
Total rating 0 
Categories Tools
Dependency string Packer-HeadlessServer-0.1.3
Dependants 0 other mods depend on this mod

This mod requires the following mods to function

nrgill28-HookGenPatcher_H3VR-1.2.3 icon

Generates MonoMod HookGen MMHOOK files during the bepinex preloader phase.

Preferred version: 1.2.3
nrgill28-Atlas-1.0.0 icon

The next generation of mapping tools for H3VR

Preferred version: 1.0.0
VIP-H3MP-1.8.0 icon

H3MP - Multiplayer Mod

Preferred version: 1.8.0


Headless Server

For hosting ongoing dedicated H3MP servers on a seperate Windows PC.

alt Donate alt Donate


This is a specialized plugin for niche hosting, it only provides basic dedicated server hosting functionality. Its funtionality is for basic game setup and running at lowest resources. The performance increase of using a dedicated server to player hosted servers would be negaliable and can't guarentee any performance benefits.

How to Setup Server PC

  1. Download Steam on your server PC
  2. Login to your Steam account with H3VR
  3. Download H3VR (Alpha - Mod Safe Branch)
  4. Do not download SteamVR, it is not needed
  5. Run H3VR once, it should take you to the main menu and do nothing, quit H3VR
  6. Switch Steam to Offline Mode (Top left of steam "Steam > Go Offline...")
  7. Install R2Modman
  8. Add the Headless Server plugin and any dependencies it asks for
  9. Only add mods you need for the server, the less mods the better
  10. Open the Headless Server Config (R2Modman > Config editor > BepInEx\Config\Packer-Headless\config.json)
  11. Set your config settings (See below for explanation)
  12. Start Modded in R2Modman
  13. You should now be able to navigate the world using WASD and the mouse
  14. Goto the game Options panel in the main menu and lower your game settings down to Turbo Potato, his will give a minor performance improvement
  15. Press Right Alt + H to show the server commands in the console window
Questions and Answers

Q: How can I (H3VR interaction)

A: For most things, you can't. You need to use the hotkey commands to perform the basic functions to host the server.

Q: I can't press the buttons using the mouse

A: Mouse pointer functionality is only basic and isn't supported very well, try moving very close to the button (Use mouse scroll to slow down your movement) until you're almost clipping inside of the button.

Q: Can I Kick or Ban players?

A: No, this and H3MP in general is based on the honour system. This is out of scope of such a niche project.


The config is the way we setup automation in the server, its broken down to several settings.

    "autoStart": 0,
    "logEnabled": 0,
    "sceneName": "TakeAndHold_Lobby_2",
    "autoCleanupTime": 601,
    "autoSceneReloadTime": 14401

autoStart This is used for automatically Hosting in H3MP and loading into a scene defined by sceneName.

logEnabled If true the console will log errors and logs as normal, this can be disabled if a server is to run for a long time. It is important that you test the server and make sure it runs smoothly before turning this off.

sceneName This is the internal scene name of the map you want to load when you use the Hotkey or Auto Start, it default to Take and Hold.

autoCleanupTime In seconds, how long between automatic server cleanups. Set this to 0 for no auto cleanups (Clients are able to do cleanups)

autoSceneReloadTime In seconds, how long the game will run before it reloads the sceneName scene. This is to help with any map breaks or crashes that may happen.


0.1.3 Released

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2023-9-17 0.1.3 29 Version 0.1.3 Install