Valheim Custom RPC Commands

A Valheim mod that introduces custom RPC (Remote Procedure Call) commands for server-side and client-side gameplay interactions.
Built to extend the game's multiplayer communication and provide mod developers and server admins new ways to interact with peers, ZDOs, and events.

✨ Features

• Define and register your own RPC commands.
• Extend existing Valheim mechanics with new multiplayer calls.
• Integration with RCON Mods for remote management.
• Compatible with other Jotunn and Harmony mods.
• Useful for building gameplay automation, custom commands, and enhanced server administration.

📦 Dependencies

This mod depends on the following libraries/mods:

• Jötunn (the Valheim Library)
• HarmonyX
• RCON Mod

Please install these before using this mod.

🔧 Installation

1. Install BepInEx into your Valheim directory if you haven’t already.
   • BepInEx Valheim Guide
2. Download the release .dll for Valheim Custom RPC Commands.
3. Place the .dll file into your BepInEx/plugins/ folder.
4. Ensure Jotunn, Harmony, and RCON Mod are installed and in the correct load order.
5. Launch Valheim and check the console log for [CustomRPC] Loaded.

▶️ Usage

• RPC commands can be registered via ZRpc or ZRoutedRpc hooks.
• Example:

  ZRoutedRpc.instance.Register("MyCustomRPC", (long sender, ZPackage pkg) => {
      var msg = pkg.ReadString();
      ZLog.Log($"Received MyCustomRPC: {msg}");
  });
  

• Invoke your custom RPC from a peer:

  ZRoutedRpc.instance.InvokeRoutedRPC(ZRoutedRpc.Everybody, "MyCustomRPC", "Hello world!");
  

🧩 Development

Clone this repo and build against:

• valheim_Data/Managed/assembly_valheim.dll
• BepInEx/core/0Harmony.dll
• Jotunn, HarmonyX, and RCON references.

Example .csproj reference snippet:

<ItemGroup>
  <Reference Include="0Harmony" HintPath="..\BepInEx\core\0Harmony.dll" />
  <Reference Include="Jotunn" HintPath="..\BepInEx\plugins\Jotunn.dll" />
  <Reference Include="RCON" HintPath="..\BepInEx\plugins\RCON.dll" />
</ItemGroup>

⚠️ Disclaimer

This is an experimental mod for Valheim. Use at your own risk.
Back up your saves before installing, and do not use on official servers.

📜 License

MIT License – feel free to fork, modify, and contribute.

🙌 Credits

• BepInEx team
• Jotunn contributors
• Harmony by Andreas Pardeike
• RCON Mod developers

Happy modding, and may Odin bless your server!