๐ŸŽฎ Get on Steam

Super Battle Golf Mods Troubleshooting Guide

Last updated: March 2026

Quick Fixes

Most mod issues can be solved by:

  1. Verify BepInEx console appears when launching
  2. Check mod files are in BepInEx/plugins/
  3. Update BepInEx and mods to latest versions
  4. Remove recently added mods one by one

Common Issues & Solutions

๐Ÿ”ด Critical

BepInEx Console Doesn't Appear

Symptoms:

  • Game launches normally but no console window appears
  • Mods don't load at all
  • No BepInEx folder created after first launch

Causes:

  • BepInEx files not in correct location
  • Antivirus blocking BepInEx DLL files
  • Incorrect BepInEx version for game
  • Files not extracted properly

Solutions:

  1. Verify File Locations
    • Ensure winhttp.dll is in the same folder as SuperBattleGolf.exe
    • Check that BepInEx/ folder exists in game root
    • Verify doorstop_config.ini is present
  2. Add Antivirus Exception
    • Add game folder to Windows Defender exclusions
    • Whitelist winhttp.dll and BepInEx/ folder
    • Temporarily disable antivirus and test
  3. Re-extract BepInEx
    • Delete all BepInEx files
    • Download fresh BepInEx from Thunderstore
    • Extract with "Extract All" (not drag-and-drop)
    • Copy ALL files to game folder
  4. Run as Administrator
    • Right-click Steam โ†’ Run as Administrator
    • Launch Super Battle Golf
  5. Verify Game Files
    • In Steam: Properties โ†’ Installed Files โ†’ Verify
    • This restores any corrupted game files
    • Re-install BepInEx after verification
๐ŸŸ  High

Mods Not Loading / Not Working

Symptoms:

  • BepInEx console appears but mods don't activate
  • No errors in console but mod features missing
  • Some mods work, others don't

Solutions:

  1. Check Plugin Folder
    • Verify .dll files are in BepInEx/plugins/ (not subfolders)
    • Some mods need their own folder - check mod instructions
  2. Check BepInEx Console for Errors
    • Look for red error messages when game loads
    • Common errors: "Missing dependency", "Failed to load", "Version mismatch"
  3. Install Missing Dependencies
    • Many mods require other mods to work
    • Check mod page on Thunderstore for "Dependencies" section
    • Install all required dependencies
  4. Update Mods
    • Outdated mods may not work with current game version
    • Check Thunderstore for mod updates
    • Update BepInEx to latest version
  5. Check Mod Compatibility
    • Read mod description for game version compatibility
    • Some mods are abandoned and no longer maintained
๐ŸŸ  High

Game Crashes on Startup or During Play

Symptoms:

  • Game crashes immediately after launch
  • Crashes when loading into a match
  • Random crashes during gameplay
  • Freeze and "Not Responding" errors

Solutions:

  1. Identify Problematic Mod
    • Remove all mods from BepInEx/plugins/
    • Add mods back one at a time
    • Test game after each mod
    • When crash occurs, last added mod is the culprit
  2. Check Console Before Crash
    • Look for error messages in BepInEx console
    • Note which mod is mentioned in errors
    • Search error message on mod's Thunderstore page
  3. Resolve Mod Conflicts
    • Some mods modify the same game features
    • Try disabling one of the conflicting mods
    • Check mod descriptions for known conflicts
  4. Update Everything
    • Update BepInEx to latest version
    • Update all mods to latest versions
    • Verify game files in Steam
  5. Check System Resources
    • Some mods increase RAM/CPU usage
    • Close background applications
    • Lower in-game graphics settings
๐ŸŸก Medium

Multiplayer Issues with Mods

Symptoms:

  • Can't join modded servers
  • Get kicked from lobbies
  • Desync issues (players teleporting, wrong positions)
  • Host can't see other players' mod features

Solutions:

  1. Understand Mod Types
    • Client-side mods (UI, visuals) work in any lobby
    • Gameplay mods require all players to have them
    • Check mod description for multiplayer compatibility
  2. Match Mod Versions
    • All players must have exact same mod versions
    • Even minor version differences can cause issues
    • Coordinate with friends before joining
  3. Disable Gameplay Mods for Public Lobbies
    • Only use client-side mods in public matches
    • Create private lobby for modded gameplay
  4. Check Server Rules
    • Some community servers ban certain mods
    • Read server description before joining
๐ŸŸก Medium

Performance Issues After Installing Mods

Symptoms:

  • Lower FPS than before mods
  • Stuttering or lag spikes
  • Longer loading times
  • High CPU/RAM usage

Solutions:

  1. Identify Resource-Heavy Mods
    • Mods that add visual effects or record replays use more resources
    • Disable mods one by one to find the culprit
  2. Install Performance Mods
    • Get "PerformanceBoost" mod from Thunderstore
    • Optimize game settings
  3. Reduce Mod Count
    • Only keep essential mods active
    • Remove unused or redundant mods
  4. Close BepInEx Console
    • The console window uses resources
    • Minimize or close it after game loads
๐ŸŸข Low

Mod Configuration Not Saving

Symptoms:

  • Mod settings reset after restarting game
  • Configuration changes don't apply

Solutions:

  1. Check Config File Permissions
    • Ensure BepInEx/config/ folder is not read-only
    • Run game as administrator
  2. Edit Config Files Manually
    • Navigate to BepInEx/config/
    • Open mod's .cfg file with Notepad
    • Edit values and save
    • Launch game

Advanced Troubleshooting

Reading BepInEx Logs

BepInEx creates detailed log files that help diagnose issues:

  1. Navigate to BepInEx/LogOutput.log
  2. Open with Notepad
  3. Look for lines containing "ERROR" or "FATAL"
  4. Note the mod name mentioned in error
  5. Search the error message online or on mod's Thunderstore page

Clean Reinstall Process

If all else fails, perform a clean reinstall:

  1. Backup Saves
    • Copy %AppData%\LocalLow\Brimstone\SuperBattleGolf\ to safe location
  2. Remove All Mods
    • Delete BepInEx/ folder
    • Delete doorstop_config.ini
    • Delete winhttp.dll
    • Delete doorstop_libs/ folder
  3. Verify Game Files
    • Steam โ†’ Properties โ†’ Installed Files โ†’ Verify
  4. Reinstall BepInEx
    • Download fresh BepInEx
    • Extract to game folder
    • Launch game once
  5. Add Mods Gradually
    • Install 2-3 mods at a time
    • Test after each batch

Mod-Specific Issues

MoreGolfers: Players can't see each other

Cause: Not all players have MoreGolfers installed or different versions.

Solution:

  • Ensure ALL players have MoreGolfers installed
  • Verify everyone has the same version
  • Host must have the mod for it to work
BetterSwingPreview: Lines not showing

Cause: Mod not loaded or conflicting with another visual mod.

Solution:

  • Check BepInEx console for loading confirmation
  • Disable other mods that modify UI/visuals
  • Update to latest version
CustomMaps: Maps not appearing in list

Cause: Map files in wrong location or incompatible format.

Solution:

  • Ensure map files are in BepInEx/plugins/CustomMaps/
  • Check map is compatible with current game version
  • Verify all players have the same custom maps

Prevention Tips

๐Ÿ“‹ Keep a Mod List

Maintain a text file listing all installed mods and versions. Makes troubleshooting easier.

๐Ÿ”„ Update Regularly

Check for mod updates weekly. Updated mods fix bugs and improve compatibility.

๐Ÿ’พ Backup Before Modding

Backup your save files and working mod setup before making changes.

๐Ÿงช Test Individually

Install and test mods one at a time to quickly identify issues.

Getting Help

If you're still experiencing issues:

๐Ÿ’ฌ Discord Community

Join the official Discord and ask in #modding-help channel.

๐Ÿ› Report on Thunderstore

Report bugs on the mod's Thunderstore page. Include your BepInEx log file.

๐Ÿ“บ Reddit Community

Post on r/SuperBattleGolf with detailed description and screenshots.

โš ๏ธ When Asking for Help, Include:
  • List of installed mods and versions
  • BepInEx version
  • Game version
  • Error messages from console
  • BepInEx/LogOutput.log file (upload to pastebin)
  • Steps to reproduce the issue

Related Guides

๐Ÿ“ฅ

Installation Guide

Step-by-step mod installation tutorial.

โ†’ โญ

Best Mods

Top 10 must-have Super Battle Golf mods.

โ†’ ๐ŸŽฎ

Mods Overview

Complete guide to Super Battle Golf modding.

โ†’