Super Battle Shock

Super Battle Shock

Super Battle Shock connects local Super Battle Golf hits, knockouts, timeouts, and eliminations to supported shock devices such as PiShock and OpenShock.

Only your local player can trigger the mod. Other players do not need it installed.

Features

• Supports PiShock V3 and OpenShock.
• Configurable trigger mode for every supported hit-event.
• Separate intensity and duration groups for clubs, weapons, explosions, and vehicles.
• Optional timeout, unmapped knockout, water, and fog shocks.
• Local overlay, local chat-feed, or log-only notifications.
• Configurable cooldown and lobby protection to prevent unwanted shock spam.

Requirements

• Super Battle Golf.
• BepInExPack 5.4.2305 or newer. A mod manager installs this dependency automatically.
• A configured PiShock V3 or OpenShock device is required only when sending physical shocks.

Quick Start

• Install Super Battle Shock with Gale, r2modman, or another -compatible mod manager.
• Launch Super Battle Golf once to create BepInEx/config/com.github.addzeey.SbgShock.cfg in the active profile.
• Open the config through your mod manager or a text editor.
• Set Shock Provider to PiShock or OpenShock.
• Add the credentials for that provider.
• Start with low intensity and short duration values.

Provider Setup

Shock Provider defaults to PiShock. Change it to OpenShock when using an OpenShock device.

PiShock

IMPORTANT PiShock support uses PiShock hardware must be flashed to V3 for this API path to work.

Configure these values under [PiShock]:

| Setting | Value |

| --- | --- |

| ApiUrl | Keep the default unless instructed otherwise. |

| ApiKey | Your PiShock API key. |

| ShockerId | Your PiShock V3 shocker ID. |

The old ShareCode setup is not supported. PiShock users need an ApiKey and ShockerId.

• PiShock V3 documentation
• Shocker ID lookup

PiShock Partner Discount

Shop at the PiShock store and use promo code ADDZEEY for 10% off.

OpenShock

Configure these values under [OpenShock]:

| Setting | Value |

| --- | --- |

| ApiUrl | Keep the default unless using another compatible server. |

| ApiKey | Your OpenShock API token. |

| DeviceId | Your OpenShock device or share ID. |

Create an API token and copy the appropriate device or share ID from your OpenShock account.

Hit Trigger Modes

Every supported hit-event family has a HitMode setting. Related variants share the same setting.

| Mode | Behavior |

| --- | --- |

| Disabled | Ignore this hit. |

| AnyHit | Trigger whenever the local hit handler receives the cause, including blocked hits or hits without a new knockout. |

| KnockoutOnly | Trigger only when the hit creates a new knockout or downed state. This is the default. |

Orbital laser center, thunderstorm direct-hit, and railgun direct-hit eliminations also use their matching hit-mode settings.

Hit Events

All listed hit modes default to KnockoutOnly.

| Event | Config setting | Intensity / duration group | Default |

| --- | --- | --- | --- |

| Club swing | ClubHitMode | ClubHitIntensity / ClubHitDuration | 25% / 1 second |

| Ball hit (normal or Electromagnet-reflected) | GolfBallHitMode | GolfBallHitIntensity / GolfBallHitDuration | 25% / 1 second |

| Rocket Driver swing, spin, or projectile | RocketDriverHitMode | ClubHitIntensity / ClubHitDuration | 25% / 1 second |

| Jumbo Burger giant swing, projectile, or collision | JumboBurgerHitMode | ClubHitIntensity / ClubHitDuration | 25% / 1 second |

| Dueling Pistol | DuelingPistolHitMode | WeaponHitIntensity / WeaponHitDuration | 35% / 1 second |

| Elephant Gun | ElephantGunHitMode | WeaponHitIntensity / WeaponHitDuration | 35% / 1 second |

| Railgun | RailgunHitMode | WeaponHitIntensity / WeaponHitDuration | 35% / 1 second |

| Rocket | RocketHitMode | ExplosiveHitIntensity / ExplosiveHitDuration | 50% / 2 seconds |

| Rocket backblast | RocketBackBlastHitMode | ExplosiveHitIntensity / ExplosiveHitDuration | 50% / 2