IssaMod
Adds 26 new items to Super Battle Golf -- from an orbiting gunship you pilot from above, to a pack of angry attack bears. All items drop from standard item boxes and are fully configurable.
For more information as well as the mod's source code, please see the mod's GitHub repository.
Items
⚾ Baseball Bat
A melee weapon that replaces your golf club swing. Wind up and send anyone in range flying. Straightforward, personal, deeply satisfying.
🛩️ AC-130 Gunship
You become the gunship. The plane circles the map at altitude while you stare down a targeting camera and rain rockets on your friends. Fire is free, ammo is infinite, and the only limit is how long you can stay on station (and also the configured time-limit). Hit the mayday button and the gunship nosedives -- your opponents can lock onto it with a rocket launcher and shoot it down before it reaches them. If they can't, the crash does the work for you.
💣 Stealth Bomber
Paint a target on the course from ground level, then confirm the strike. Moments later a B-2 roars overhead and carpets the area with bombs. Great for punishing anyone who stops moving. The bomber itself is a valid rocket launcher target -- lock on before the run completes to intercept it.
🎯 Predator Missile
You pilot the missile. It drops from altitude and you steer it directly with your camera from a sort of first-person view until it hits something or you let go.
⚛️ Nuke
Drop a nuclear bomb that blows all of the other players sky-high!
🍩 Giant Flying Donut
A massive donut spawns and you pilot it around the course from a third-person perspective. It follows the terrain at low altitude, fires downward lasers as it passes over players, and can be shot down with standard weapons. Equal parts absurd and devastating.
🐻 Attack Bears
Summons AI-controlled battle bears onto the course. Bears chase down the nearest player, wind up, and launch them like a ball. They take damage from all weapons -- guns, clubs, the bat, rockets, explosions -- and become more aggressive when they get hit. Bears are persistent until killed, which means your bears are everyone's problem. And your own.
🧊 Freeze World
Turn the world into ice and watch as everybody helplessly slips around.
🌌 Low Gravity
Reduces gravity across the entire course for a configurable duration. Shots fly further, players float on hits, and any ball already airborne gets a free extension. Can backfire badly on anyone with a long putt already in motion. (And yes, the swing preview / power bar IS adjusted during low gravity.)
🎯 M200 Intervention
A scoped sniper rifle. Right-click to zoom and show the scope overlay. Fire to hit instantly at any range without the backwards-knockback dive of the Elephant Gun. Tight spread when scoped, normal spread when hipfired. One shot, one hole in someone's plan.
⚡ Javelin
Locks onto a ground target point and flies a lofted arc: up, turn at apex, dive straight down.
💥 Sticky Grenade
Thrown with an arc preview so you know exactly where it's going. Sticks to whatever it lands on -- terrain, structures, or a player who wasn't paying attention. Detonates on a fuse. If it sticks to a player, they have a few seconds to contemplate their choices.
🌀 Black Hole Grenade
Thrown with an arc preview. Lands and opens a black hole that pulls every nearby player and object toward its center for several seconds, then violently ejects everything outward in random directions. Good luck putting after that.
🧱 Placeable Wall
Plants a destructible brick wall wherever you're standing. Useful for blocking shots, redirecting players, or just making the course more chaotic. The wall takes damage from rockets, explosives, golf clubs, and the baseball bat -- it will eventually come down, but it might save you long enough for it to matter.
🔫 AK-47
A rapid-fire sub-machine gun. Hold the fire button and spray bullets downrange at high speed. Each bullet hits independently, so sustained fire on a target adds up fast. Accuracy degrades with range, so this one rewards getting close.
🔄 Position Swap
Pick any other player from the chooser overlay. Warning circle appear around both of you while a short countdown runs -- then you swap positions in a burst of smoke. Great for dumping someone into a bad lie or pulling yourself out of one. Can't be used on players sitting in a golf cart.
🧪 Poison Jar
Lob a jar of poison with an arc preview. On landing it shatters and douses anyone within the blast radius -- including you, if your aim is bad. Poisoned players suffer a full screen of visual distortion: camera roll, FOV breathing, double vision, and aim drift that makes lining up a shot genuinely difficult. The radius and duration are both configurable, so you can turn it into a small precise splash or a wide lingering cloud.
🛸 Drone Swarm
Deploys a swarm of kamikaze drones that fan out overhead and circle the course. Each drone flies independently with erratic noise-driven steering, then picks a random target and dives. They home in continuously until they get close, then lock their aim point and fly straight -- so a target that moves fast enough can actually dodge. The swarm size scales with the number of players in the match. A HUD counter shows how many drones are still airborne. Session ends when every drone has either detonated or the time limit expires.
🐂 Red Bull
Gives you wings. Cracks open a can and grants a speed boost more powerful than coffee, plus a jump height boost that lasts for its duration. Use it to cross the course fast, escape a bad situation, or just make yourself a much harder target to hit.
🍩 Super Donut
Trigger an orbital laser on all other players at the same time.
🌗 Gravity Gun
Like the icon weapon from the Half Life franchise, use the Gravity Gun to throw players and golf carts around with ease!
✈️ Harrier Jet
Calls in an autonomous Harrier jet that flies in from off-map, hovers over the course, and fires rockets at players on its own. No steering required after activation — you just point and watch. Can be shot down with a rocket launcher before it finishes its run.
🚀 Rocket Tether
Targets another player and fires a rocket that spawns directly above them, then launches straight up. The target is tethered to the rocket by a spring force and gets dragged skyward with it. When the timer runs out, the rocket detonates at altitude.
🎒 Jetpack
Strap on a jetpack and hold the fire button to thrust upward. Each canister provides a set amount of burn time; releasing the button pauses fuel consumption, so you can pulse the thrust. A fuel gauge HUD shows how much burn time is left in the current canister.
📡 Teleporter
The camera pans to a top-down overhead view of the course and a glowing marker appears on the ground. Move the marker with WASD to pick your destination, then confirm to teleport there instantly. Right-click or Space to cancel. Great for repositioning, escaping a bad lie, or just vanishing right before someone shoots at you.
🥬 Spinach
Eat your vegetables. Provides a boost to movement speed and swing power.
🔥 Flamethrower
Unleash a continuous stream of fire in front of you. Enemies caught in the flames run around like crazy while they're set ablaze before falling and rolling on the ground.
Installation
Install via Thunderstore Mod Manager or r2modman. Requires BepInEx.
Manual install: drop IssaPlugin.dll and IssaModBundle into BepinEx/plugins/.
Configuration
In-Game Spawn Config UI (recommended)
The host can open the Spawn Config panel at any time during a session by pressing M (default; rebindable in the config file). The panel lets you configure the full tiered item spawn system without touching any files.
Clients can see the panel in read-only mode; their view updates automatically whenever the host applies changes.
How the tiered spawn system works
Items are sorted into up to 5 tiers. When an item box is ready to award a custom item, the game first picks a tier by weight, then picks a random item from that tier. This gives you coarse control (how common is this whole category?) and fine control (individual item tuning) without needing to balance every item against every other item directly.
Tier settings (one set per tier):
| Setting |
What it does |
| Tier enabled |
Master switch for the whole tier. Disabled tiers are skipped entirely. |
| Spawn weight |
How likely this tier is to be chosen. Weights are relative — if Tier 1 is 70 and Tier 2 is 30, Tier 1 spawns 70% of the time. |
| Min distance behind leader |
Tier only activates for players who are at least this many units behind the current leader. Set to 0 to lift the restriction. |
| Min place to trigger |
Tier only activates for players in this place or worse (e.g. 3 = 3rd place and below). Set to 0 to lift the restriction. |
Both gating conditions must be met simultaneously. Either can be independently disabled by setting it to 0. This lets you build tiers that only give powerful items to players who are losing badly — the classic "rubber band" mechanic.
Per-item settings (shown in each tier's item list):
| Setting |
What it does |
| Enabled |
Removes this item from the spawn pool entirely when unchecked. |
| Override weight |
Give this specific item its own spawn weight instead of sharing the tier's weight equally with other items in that tier. |
| Move → |
Reassign the item to a different tier. Its weight override is cleared so it inherits the new tier's weight. |
Global settings (top row of the panel):
| Setting |
What it does |
| Custom items enabled |
Master switch for all custom items. |
| Global rate multiplier |
Scales the spawn rate of every custom item up or down. 1.0 = normal; 2.0 = twice as often. |
| Catchup boost |
Extra multiplier applied only to players who are behind the leader. 1.0 = no boost. |
| Tiers (+ / −) |
Add or remove tiers. A tier can only be removed if it has no items assigned to it. |
Applying changes
Click Apply & Sync to save your changes to the config file and broadcast the new settings to all connected clients immediately. Click Cancel to discard changes and close the panel.
All settings persist between sessions in BepInEx/config/com.scusemua.IssaPlugin.cfg.
Item-specific settings (config file)
Every item also has tuning values that can be edited in the config file or via AtomicStudio's ModConfig mod:
- Uses — how many uses come with each pickup
- Give key — keyboard shortcut to give yourself the item instantly (for testing)
- Damage, knockback, duration, speed, range — item-specific values
Note: AtomicStudio's ModConfig is recommended for editing item-specific settings — it provides a clean in-game UI for the config file.
Compatibility
- Multiplayer: All items are fully networked. The host runs as the server; all item behavior is server-authoritative. Clients do require the mod.
- Existing items: No base game items are removed or rebalanced. This mod only adds.
- Other mods: Should be compatible with anything that doesn't patch the same inventory or item-spawning hooks. In particular, this mod is compatible with AtomicStudio's ModConfig mod, as described above, as well as AtomicStudio's ItemSpawner mod. Note that the host can change settings during the game, and they will take effect the next time the associated item is used. Spawn pool weights are synchronized on a five second interval as well.
Console Commands
vote <timeout> — Host only. Starts a vote among all players to enable or disable individual custom items. The timeout (in seconds) controls how long the vote stays open before closing automatically.spawnConfigUI — Opens the tiered spawn config panel (same as pressing M).giveCustomItem <item name> — Give yourself a custom item.
Known Issues / Notes
- The Donut, AC-130, and Stealth Bomber all appear as valid lock-on targets for the rocket launcher. This is intentional.
Source
Source code available on GitHub. Bug reports and pull requests welcome.
Credits
Assets used in the project:
IssaPlugin is a fan-made mod and is not affiliated with Brimstone or Oro Interactive.
