You are viewing a potentially older version of this package. View all versions.
khalil-Piggyback_Fix-1.4.4 icon

Piggyback Fix

Compatibility fix for the original Piggyback mod (by nakaz0ra). Restores carrying mates after the 2026-08-12 PEAK update. Apache 2.0, fork of the original.

Date uploaded 2 weeks ago
Version 1.4.4
Download link khalil-Piggyback_Fix-1.4.4.zip
Downloads 11
Dependency string khalil-Piggyback_Fix-1.4.4

This mod requires the following mods to function

BepInEx-BepInExPack_PEAK-5.4.75301 icon
BepInEx-BepInExPack_PEAK

BepInEx pack for PEAK. Preconfigured and ready to use.

Preferred version: 5.4.75301

README

Piggyback (Compatibility Fix) — 1.4.4

This is a community-maintained compatibility fix for the original Piggyback mod.

Original author: nakaz0ra Original project: https://github.com/nakaz0ra/peak-piggyback Original Thunderstore page: https://thunderstore.io/c/peak/p/nakaz0ra/Piggyback/ (page currently unavailable — see note below) License: Apache License 2.0 (LICENSE file included, unchanged from the original)


What is this?

Have you ever been in a situation where your mate went for a bathroom break or just went AFK and you thought "if only I could carry them"? Then this mod is for you! This mod allows you to carry other players even when they're not passed out.

This package is a FORK of the original Piggyback mod. It is not an official update by the original author. It exists because the PEAK game update of 2026-08-12 broke the original 1.4.3 build, and the original author has not (yet) released a fix.

Note on the original page: the original Thunderstore package nakaz0ra/Piggyback is currently unavailable (404). All code credit goes to nakaz0ra under Apache 2.0; this package only repairs the game-API breakage.

What was fixed in 1.4.4?

The game update removed/reworked two APIs the original mod used:

Breakage Original (1.4.3) Fixed (1.4.4)
BackpackSlot.hasBackpack field removed by the game referenced 7× → crash / "cannot switch items" now uses BackpackSlot.IsEmpty() (backpackType == BackpackType.None)
MainCameraMovement.Spectate()Spectate(bool useGhost) signature change Delegate.CreateDelegate threw ArgumentException every frame (3400+/session) delegate now binds Action<MainCameraMovement, bool>, called with useGhost:false while carried

No gameplay logic was changed — only the two game-API incompatibilities above.

Manual Installation

  1. Download BepInEx from here and follow the installation instructions provided there.
  2. Download this mod and drag and drop the Piggyback.dll file into your PEAK BepInEx plugins folder located at: <game directory>\BepInEx\plugins
  3. Remove any previous copy of the original Piggyback.dll first (same plugin GUID — keeping both installed will conflict).

Usage

Only the players who intend to carry others need to have the mod installed; the players being carried don't need it, but it is recommended that they do if they want to use the spectate view while being carried instead of the first-person view.

The player being carried can get down by themselves by jumping or crouching.
If a player is sprinting, climbing, jumping, crouching, holding an item, or reaching for another player, you won't be able to pick them up. This helps prevent trolling or picking them up on accident.

Configuration

The settings are the same as the original mod, in: <game directory>\BepInEx\config\nakazora.peak.piggyback.cfg

  • EnablePiggyback (default true) — master switch for carrying non-passed-out players.
  • AllowPiggybackByOthers (default true) — instantly drop if someone carries you while you're awake.
  • SpectateView (default true) — spectate the carrier while being carried (first-person otherwise).
  • HoldToCarryTime (default 1.5) — hold-interact time to start carrying (0 = instant).
  • SwapBackpack (default true) — auto-swap your backpack onto the carried player and back on drop.
  • AccurateWeight (default false) — add the carried player's item weight to your own weight.
  • GamepadDropKeybind (default LeftShoulder+RightShoulder) — gamepad drop binding (keyboard default is 4).

License

This project is distributed under the Apache License 2.0 (see the LICENSE file). The license text is the original from nakaz0ra's repository, unchanged. Per Apache §4(b), the modified source file (Piggyback.cs) carries a prominent modification notice; source is available on request or in the fork repository.

CHANGELOG

Changelog

1.4.5

  • Fix README.md

1.4.4 (compatibility fix, community-maintained)

Restores the original Piggyback 1.4.3 for the PEAK game update of 2026-08-12.

Fixed:

  • BackpackSlot.hasBackpack field was removed by the game update; all 7 references now use BackpackSlot.IsEmpty() (backpackType == BackpackType.None). This was the cause of the "cannot switch items" / repeated MissingFieldException errors.
  • MainCameraMovement.Spectate() was changed to Spectate(bool useGhost); the spectate delegate now binds Action<MainCameraMovement, bool> and is invoked with useGhost:false while carried. This was the cause of ~3400 ArgumentException: method arguments are incompatible per session.

Changed (build):

  • Version bumped 1.4.3 → 1.4.4 to denote the fix.
  • Rebuilt against the updated game assemblies (including Unity.InputSystem).

Unchanged:

  • All gameplay logic, config keys, and plugin GUID (nakazora.peak.piggyback) are identical to the original 1.4.3.

1.4.3 (original, by nakaz0ra)