NetworkUtil

NetworkUtil

A utility mod designed to simplify and standardise networking for other mods.

NetworkUtil provides a lightweight abstraction over Photon networking, allowing mod developers to easily send and receive synchronised data between the host and connected clients without rewriting boilerplate networking logic.

Core Features

• []Simple API for sending networked data

  []Clear host vs client detection

  []Request-based filtering for network events

  []Safe, predictable data handling using Hashtables

  1. NetworkRouter. SendData

  Primary function for sending networked data between host and clients.

  NetworkRouter. SendData(string requestID, Hashtable payload, RaiseEventOptions raiseEventOptions)

  This function can be called by both the host and clients. It supports:

  • []Host → Clients

    []Client → Host

    []Targeted or filtered event handling using request IDs

    Arguments:

    requestID (Required)

    A unique identifier used to differentiate network requests.

    This allows developers to:

    • []Filter incoming events by type

      []Route data to specific logic paths

      []Send data from a client to the host without other clients responding

      It's a string, so it can be anything. Though I recommend using numbers

      payload (Required)

      A Hashtable containing the data to be transmitted.

      Any data type supported by a Hashtable may be included.

      A Hashtable is mandatory and cannot be replaced with other structures.

      Example:

      string words = "words here";

      int value = 20;

      Hashtable payload = new Hashtable

      ["string"] = words,

      ["value"] = value

      raiseEventOptions (Optional)

      Allows developers to override Photon event options, such as changing the receiver group (for example, sending to All instead of the default behaviour Others).

      If not provided, default event options are used.

      Example options:

      raiseEventOptions = new RaiseEventOptions {Receivers = ReceiverGroup. Others};

      2. NetworkRouter. HostCheck

      Determines whether the current player is the host or a client.