TeamScusemua-IssaMod icon

IssaMod

IssaMod adds chaotic, weaponized gameplay through custom items (airstrikes, missiles, weapons, and physics modifiers), world modifiers, and cinematic strike abilities!

Last updated 3 days ago
Total downloads 6520
Total rating 1 
Categories Mods Items Client-Side All Clients Required
Dependency string TeamScusemua-IssaMod-0.0.29
Dependants 0 other packages depend on this package

README

IssaMod

Adds 27 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.

Regarding the Frozen Fairway Update

Release v0.0.25 re-enables IssaMod/IssaPlugin up through Hotfix 4 of the Frozen Fairway Update. The mod is very under-tested at this point, so there are likely bugs and strange interactions with the new game mechanics. The custom items also do appear in the pause menu, but their spawn weights are not updated properly. This will be addressed in a future update.

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.

๐Ÿš€๐Ÿ’ฃ Rocket Tether Grenade

Throw a toy rocket at the ground, causing a small spark. Anybody within range will be tethered to a rocket - like the rocket tether item, but somehow even more chaotic.

๐Ÿ’จ Wind Storm

Create a wind storm with extremely high speed winds and dynamically-changing directions. These winds will blow away players and golf balls alike!


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.
  • Hitting a golf ball with a fully-charged baseball bat will make the ball go backwards, as of the new Frozen Fairway update.

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.