Subscribe to download
[SOURCEMOD] Ammo Pickup ConVar/Crossbow Pickup Fix

If you've ever tried to alter the amount of ammo you get from ammo pickups in Black Mesa - whether that be to match them to Half-Life, or to fix the fact that crossbow magazines, which clearly only hold five bolts, inexplicably provide you with ten bolts instead (literally the ammo cap for the crossbow by default!) - then chances are you're aware that the console variables for this are badly formatted, making them impossible to edit. Even though this has been brought up multiple times, it's still never been fixed.

Hence this plugin's creation. This plugin adds a new set of console variables for ammo pickups that can actually be modified, allowing you to change the amount of ammo any pickup of a given type will provide you with. By default, it also halves the amount of ammo given by crossbow pickups, which also helps address the overabundance of crossbow ammo in later chapters of the game.

This plugin also has a feature wherein a mapper can add in extra spawnpoints for extra crossbow ammo, if they should so desire. This makes it possible to balance a single map for both the standard 10-bolt pickup as well as the fixed 5-bolt pickup. See below for details.

Note that this plugin is ONLY DESIGNED FOR USE IN SINGLE-PLAYER MODE. If you can get it to load on a multiplayer server, there is no guarantee it'll work properly. I do not recommend attempting this.

This plugin adds console variables for each ammo type, as well as one enabling console output and one for enabling increased crossbow ammo spawns. All of these variables are saved to a config file, which can be found at Black Mesa/bms/cfg/sourcemod/bm_ammopickupfix.cfg. If you want to change any of these values to keep them consistent between launches of the game, you can do so here.


When a map is loaded with this plugin installed, if bm_ammopickup_2x_crossbow_ammo is set to 1, then this plugin will start by scanning the map for extra crossbow ammo spawnpoints. These are accomplished via an info_target entity, with the name bmpuf_crossbow_ammo. If any info_target's with this name are found in a map, then this plugin will remove them and spawn a crossbow magazine in their place, inheriting their position and rotation.

What this means for mappers is that if you want to add extra crossbow ammo spawns for use with this plugin, all you have to do is add an info_target entity with the targetname bmpuf_crossbow_ammo. This is a simple way to allow for easily balancing a map for both the default 10-bolt ammo pickups and the 5-bolt ammo pickups that this mod has by default. Of course, players can also use this convar to increase the total number of ammo spawns even with the default 10-bolt pickups, but still.

1. Download the latest developer branch builds of SourceMod[www.sourcemod.net] and MetaMod:Source[www.sourcemm.net]. If you're not sure where exactly to find them, you can find a pre-packaged download of working builds HERE.[drive.google.com]
   
2. Install both of them to your Black Mesa installation - this should be somewhere like Program Files (x86)/Steam/steamapps/common/Black Mesa/bms, though its exact location may differ based on your setup. If you downloaded them separately, drop the addons folder from MM:Source in the bms directory, followed by the addons and cfg folders from SourceMod - if you downloaded the package, extract the bms folder from it and merge it with the directory in the Black Mesa folder.
   
3. In your Steam library, find Black Mesa, right-click it, and select Properties. At the bottom of the window is an option labelled Launch options. Add this to it:
   
   -insecure
   Do note that starting Black Mesa with this launch option enabled WILL PREVENT YOU FROM CONNECTING TO VAC-SECURED MULTIPLAYER SERVERS.
   If you should want to play multiplayer, remove the -insecure entry from the launch options.
   
4. Launch the game and bring up the developer console. In it, type the following commands and press enter.
   
   meta sm
   If MetaMod:Source and SourceMod are installed correctly, you'll get output something like this in response:
   
   ] meta Metamod:Source Menu usage: meta <command> [arguments] alias - List or set an alias clear - Unload all plugins forcefully cmds - Show plugin commands cvars - Show plugin cvars credits - About Metamod:Source force_unload - Forcefully unload a plugin game - Information about GameDLL info - Information about a plugin list - List plugins load - Load a plugin pause - Pause a running plugin refresh - Reparse plugin files retry - Attempt to reload a plugin unload - Unload a loaded plugin unpause - Unpause a paused plugin version - Version information ] sm SourceMod Menu: Usage: sm <command> [arguments] cmds - List console commands config - Set core configuration options credits - Display credits listing cvars - View convars created by a plugin exts - Manage extensions plugins - Manage Plugins prof - Profiling version - Display version information
   If you get a message stating Unknown command, then something isn't installed properly. Double-check and make sure you've got both a metamod and sourcemod directory in your /bms/addons folder, as well as a pair of files called metamod.vdf and metamod_x64.vdf. If all four of those are present, check and make sure that you added -insecure to the launch parameters via Steam before starting the game.
   
5. Subscribe to this addon and let it download (this shouldn't take very long, since it's a relatively small file). When it's done, you can find it in your workshop downloads folder for Black Mesa - this'll be somewhere like Program Files (x86)/Steam/steamapps/workshop/content/362890/2454684652. Inside, you should find a folder named BM Ammo Pickup Fix.
   
6. Copy the contents of this folder into your Black Mesa directory, merging the bms folders. This will install the compiled plugin, as well as place a copy of its source code in addons/sourcemod/scripting.
   
7. Either restart Black Mesa, or run this command in the console:
   
   sm plugins refresh
   Once that's done, run this command as well:
   
   sm plugins list
   If installed correctly, you should see a line like this somewhere in the output:
   
   11 "[Black Mesa] Ammo Pickup Fix" (1.0) by KyuuGryphon

If you've followed these instructions correctly, the plugin should be working as intended! You can now actually modify how much ammo any given pickup type provides you with to suit your liking.

If you encounter any bugs, please feel free to let me know, and I'll do what I can to fix them - though make sure you've followed these instructions correctly before reporting bugs about the plugin or SourceMod just "not working". Reading comprehension is on you, not me.