Casual Ammo

Casual Ammo is a GTFO BepInEx IL2CPP plugin for private cooperative lobbies. It makes relaxed friend-group runs less ammo-starved by improving weapon munitions packs.

Do not use this in public matchmaking. This mod does not include anti-cheat bypassing, matchmaking bypassing, memory trainers, public-lobby cheating features, or firing-method infinite-ammo patches.

Features

• Restores full weapon ammo from munitions packs by default.
• Keeps weapon munitions packs stocked with many charges.
• Logs whenever a resource pack is picked up, with a warning-level log for weapon munitions packs.
• Logs when a weapon munitions pack is applied or reaches the ammo-give path.
• Forces positive weapon ammo storage additions to full ammo in FullRestore mode.
• Replaces weapon munitions-pack apply behavior with a non-consuming ammo grant through GTFO's own resource receiver API.
• Keeps the resource-pack HUD display at the configured pack percent without a continuous per-frame item update.
• Optional reserve-ammo boost behind InfiniteReserveAmmo = false by default.
• Logs every enabled behavior on startup.

Config

BepInEx creates:

BepInEx/config/com.privatecoop.gtfo.casualammo.cfg

Options:

[General]
EnableMod = true

[Ammo Restore]
AmmoRestoreMode = FullRestore
RestoreMultiplier = 10

[Munitions Packs]
MunitionPackCharges = 999

[Reserve Ammo]
InfiniteReserveAmmo = false

[Safety]
PrivateLobbyWarning = true

AmmoRestoreMode values are FullRestore, Multiplier, and Disabled.

Changelog

1.0.13

• Fixed tool ammo refills also restoring main and special weapon ammo.
• The shared ammo restore hook now only upgrades standard/special ammo lanes when GTFO was already restoring those lanes.
• Tool ammo refills should now restore tool ammo only.

1.0.12

• Fixed the remaining class/tool ammo restore path in PlayerAgent.GiveAmmoRel.
• Standard and special weapon ammo are still restored by weapon ammo packs.
• Class/tool ammo is now preserved instead of being forced or multiplied by Casual Ammo.
• Recommended version for public sharing.

1.0.11

• Added this changelog.
• Rewrote the README to explain the mod in plainer language.
• Added clearer notes that the mod is for private cooperative lobbies only.
• Added a warning that 1.0.8 could affect tool ammo behavior and that 1.0.10 or newer should be used.

1.0.10

• Fixed tool/class ammo being treated as weapon ammo.
• Changed the manual ammo grant from standard/special/class ammo to standard/special ammo only.
• Tool ammo, med packs, and other resource packs should now keep normal behavior.

1.0.9

• Tightened the HUD override so it only applies while a weapon munitions pack is equipped.
• Prevented med packs, tool ammo packs, and other resource packs from inheriting the weapon ammo pack HUD display.

1.0.8

• Added a quiet HUD override so weapon ammo packs can display 100%.
• Kept the working non-consuming weapon ammo pack behavior.
• Known issue: this version could also affect tool ammo behavior because tool/class ammo was still included in the ammo restore path. Use 1.0.10 or newer.

1.0.7

• Removed the noisy per-frame resource pack update hook from earlier troubleshooting builds.
• Kept the successful non-consuming weapon ammo pack behavior.

1.0.6

• First successful version where weapon ammo packs could refill ammo without consuming pack charges.
• Replaced the normal weapon ammo pack apply behavior with a non-consuming grant through GTFO's resource receiver API.

1.0.5 and earlier

• Troubleshooting builds used to identify GTFO's ammo pack, HUD, and ammo restore paths.
• These versions were experimental and are not recommended for regular use.