Hamilton

Version 0.1.9

Hamilton is a Super Battle Golf BepInEx mod that gives every player a permanent dueling pistol slot.

Features

• Adds a permanent dueling pistol in the second hotkey position, directly after the driver.
• Adds a host-controlled Hamilton On/Off dropdown to the Custom Rules Battle section.
• Syncs the Custom Rules toggle through Steam lobby metadata so guests follow the host setting without custom network messages.
• Checks every Steam lobby member for the same Hamilton version and keeps Hamilton disabled until everyone has it.
• Seeds the permanent pistol as soon as the lobby inventory is available.
• Keeps slot 2 corrected to the permanent pistol if the game briefly places a normal item there.
• Uses the game's synced inventory list directly when seeding the permanent pistol.
• Restricts synced inventory writes to the server/host to avoid client-side inventory desync.
• Backfires now use the native player knockout path so the shooter falls down.
• Adds a very rare orbital-strike misfire using the game's native orbital laser asset.
• Expands the item bar to five visible positions:
  • Driver
  • Permanent dueling pistol
  • Normal item slot
  • Normal item slot
  • Normal item slot
• Keeps the permanent pistol loaded by preventing normal use-count depletion.
• Removes dueling pistols from normal item box spawns.
• Lets the game's normal item-pickup behavior fill the three regular inventory slots.
• Adds configurable shot chaos:
  • Normal shot.
  • Misfire: the shot does not fire.
  • Backfire: the shot hits the shooter instead.

Requirements

• Super Battle Golf on PC.
• BepInEx 5 x64 installed in the game folder.
• Every multiplayer player should install the same mod version.
• If the host cannot turn Hamilton on, check BepInEx\LogOutput.log for the player who is missing or running the wrong Hamilton version.

Install

1. Close Super Battle Golf.
2. Extract this package into the folder that contains Super Battle Golf.exe.
3. Confirm the DLL exists at BepInEx\plugins\HamiltonMod.dll.
4. Launch the game through Steam.

Configure

After the first launch, edit:

BepInEx\config\codex.superbattlegolf.hamilton.cfg

Useful settings:

• MisfireChance: default 0.15
• BackfireChance: default 0.10
• OrbitalStrikeOnMisfireChance: default 0.01
• AutoSelectPistol: default false
• GrantCheckIntervalSeconds: default 1

Hosts can also turn Hamilton on or off per match from:

Match Setup > Rules > Custom > Battle > Hamilton

Guests see the host-selected value, but only the host can change it.

Disable

Delete or rename:

BepInEx\plugins\HamiltonMod.dll

Then restart the game.

Changelog

0.1.9

• Added a host-controlled Hamilton On/Off dropdown in Custom Rules.
• Added Steam lobby version checks so Hamilton stays disabled until all players have the same version.
• Keeps the permanent dueling pistol synced through the host/server inventory.
• Removes dueling pistols from random item-box spawns while Hamilton is active.
• Adds misfire, backfire, and rare orbital-strike misfire outcomes.

0.1.0

• Initial private test build.