BallSwap is a server-side mod for Super Battle Golf that periodically swaps all players' balls during a match, adding a chaotic twist to every game.

How It Works

At a set interval, every active player's ball is reassigned to a different player — guaranteed to be someone else's (no player ever
keeps their own ball). The swap applies only to players who are still active in the match; scored or eliminated players are excluded.

When a swap happens, a chat message is sent to notify all players.

Countdown

When the countdown is enabled, a warning will appear in chat and on-screen before each swap, giving players a heads-up. The countdown
can be set to either 5 or 10 seconds.

The on-screen timer displays in large yellow text near the top of the screen.

Interval Modes

BallSwap supports two interval modes:

• Fixed — set MinInterval and MaxInterval to the same value. Swaps happen on a consistent schedule.
• Random — set different values for MinInterval and MaxInterval. The next swap interval is randomly chosen between the two each time.

Configuration

Install https://thunderstore.io/c/super-battle-golf/p/AtomicStudio/ModConfig/ to adjust settings in-game, or edit the config file
directly.

Enable (default: true) — Enable or disable the mod

• MinInterval (default: 20, range: 10–180) — Minimum seconds between swaps
• MaxInterval (default: 40, range: 10–180) — Maximum seconds between swaps
• ShowCountdown (default: true) — Show countdown warning before each swap
• CountdownDuration (default: FiveSeconds, options: FiveSeconds, TenSeconds) — How early the countdown warning appears

Installation

1. Install https://thunderstore.io/c/super-battle-golf/p/BepInEx/BepInExPack/
2. Install https://thunderstore.io/c/super-battle-golf/p/AtomicStudio/ModConfig/ (recommended)
3. Install BallSwap via the Thunderstore mod manager or drop the DLL into your BepInEx/plugins folder

Notes

• The mod is host-side — only the host needs it installed
• The first swap is delayed by ~13 seconds to allow the intro cinematic and match countdown to finish
• Swaps are skipped if fewer than 2 active players remain
• if changes are made to the timers or the countdown is being enabled/ the time changed it will only take effect after the next swap