Self Hosted Photon

v0.1.0·Updated 2025-12-01

Allows you to connect to a self-hosted Photon server via an IP address or a hostname.

About this mod Author’s original text

Self Hosted Photon

With this mod you can easily join to a self-hosted version of Photon via an IP address or a hostname.

DISCLAIMER

This mod is not yet finished, so you may experience some issues. If you do do not hesitate to create a new issue on the project GitHub.

Setup

For Server Hosts

To use this mod you will need a Photon Server first of all. There is a nice GitHub project that allows you to run your own Photon server via Docker.

After you have set up the server you need to share the server address and port with your clients.

From this point you can just follow the client setup.

For Clients

First of all will need to enable the mod and set the server address and port in the configs, after you can just join a game (the lobby host and the server host does not have to be the same person).

Config

Example config

Settings file was created by plugin Self_Hosted_Photon v0.0.0

Plugin GUID: Self_Hosted_Photon

[General]

Enable or disable the plugin.

Setting type: Boolean

Default value: true

Enabled = true

[Server]

The IP address or hostname of the Photon server.

Setting type: String

Default value: 127.0.0.1

Address = 127.0.0.1

The port number of the Photon server.

Setting type: String

Default value: 5055

Port = 5055

To save yourself some trouble you can use the REPOConfig mod that allows you to change your settings in-game.

Credit

Credit to REPOLib for the GitHub CI/CD pipeline.

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPack

File & checksum

Filename
Self_Hosted_Photon-0.1.0.zip
File size
29.8 KiB