InvisibilityDecoy

Invisibility Decoy

Invisibility Decoy is a Bopl Battle BepInEx plugin written mainly by GPT-6 Astra.

Adds a decoy to the existing invisibility ability. Decoys are indistinguishable from the player and are affected by physics (can be eaten, shot, blown up, sucked into a black hole, etc.)

Installation

Drop InvisibilityDecoy.dll into Bopl Battle/BepInEx/plugins.

Config

After restarting the game, a configuration file will appear in Bopl Battle/BepInEx/config. There you can change how long a decoy will stay before fading out from existence.

Intended behavior

• Activating invisibility is now instantaneous and leaves a visible decoy (your copy) standing where you stood. It loops the native idle animation.
• Like in the unmodded game, after 5 seconds, the player fades in. Similarly, using an ability makes you visible for a while.
• The decoy has no movement input and cannot use abilities, eat opponents, nor collect ability pickups. It starts with zero inherited velocity. Gravity, moving platforms, wind, ropes, and other physical forces can still move it.
• Attacks and hazards destroy the decoy independently. Black holes attract and absorb its native player body. Water and blast zones use the native prefab's boundary handling.
• The duplicator makes another passive decoy, with the usual outward launch. Growth and shrink effects change that decoy's size independently.
• Destroying or copying a decoy does not change the real player's life count, invisibility, size, or revive state. Decoys cannot keep an eliminated team in the round.
• A decoy remains until destroyed or the round changes, including after your invisibility expires. The limit is 16 active decoys per original player. At the limit, a new invisibility activation replaces that player's oldest decoy; duplication stops producing additional copies.

Building from source in VS Code

Requirements: a.NET SDK supporting C# 10 or later, an installed copy of the game, and BepInEx 5 with Harmony. Open the build folder as your VS Code workspace.

• Set ManagedDir to the game's BoplBattle_Data/Managed directory.
• Set BepInExDir to the BepInEx/core directory containing BepInEx.dll and 0Harmony.dll. With a mod manager, this is usually inside the selected mod profile.
• In the project's terminal write:

dotnet build InvisibilityDecoy.csproj -c Release

• Copy bin/Release/netstandard2.1/InvisibilityDecoy.dll to your active profile's BepInEx/plugins/ directory and restart the game.