---

Q1: How do I install this?
A1: If you have encountered an addon that needed to be placed in the "custom" folder to work, you are already familiar with the same procedure used here. If you have never done this before or need help, the installation process is direct and simple. See the steps below:

1. Go to your Black Mesa installation directory. If you installed it through Steam, the default path is: "/%STEAMROOT%/steamapps/common/Black Mesa/". Inside the "bms" folder, create a new folder called "custom" if it doesn’t already exist.
   
   
2. Now, acquire the source files (the files that come "inside" this addon) using a Steam Workshop extractor, such as "steamworkshopdownloader.io". Once downloaded, take the VPK file "bm_fpsbooster" and move it into the "custom" folder. Do the same with the extra, if you want to use it.
   
   
3. After that...
   3.1. For the main file "bm_fpsbooster": Start the game, open the console, and choose which script you want to execute. Type "exec" to execute a CFG file, followed by the file name. "mintweaks.cfg" for minimal tweaks, "basictweaks.cfg" for basic tweaks, "maxtweaks.cfg" for maximal tweaks, "extremetweaks.cfg" for extreme tweaks, and "restore.cfg" for restoration. Example: "exec maxtweaks.cfg" - Do not include the quotation marks.
   3.2. As for the extra, it should run automatically when you launch the game.

---

Q2: How do I use this?
A2: Open the console and type "exec" followed by the name of the file you want to run (for example, "exec maxtweaks.cfg"). Generally, avoid running any of the files for the first time when after loading a map, as this may crash your game. Instead, run them while still in the menu, and then run them again after loading a map to ensure all tweaks are applied. Repeat the process whenever you want to use them again.

---

Q3: How do I uninstall this?
A3: Open the console and run the "restore.cfg" file. However, if you want to completely uninstall this addon, simply delete the addon files you placed in the custom folder. Note that doing this first will not revert the changes applied.

---

Q4: How do I open the console?
A4: Check out this helpful information:

Guide: https://gtm.steamproxy.vip/sharedfiles/filedetails/?id=2556222690

Discussion: https://gtm.steamproxy.vip/app/362890/discussions/5/2798376099463827954/

---

Q5: Why does my game freeze every time I run one of the scripts?
A5: This is completely normal, especially if you have a weaker machine. The scripts execute many commands at once, which can take time for the game to process and apply. Just wait patiently.

---

Q6: Help! All textures are pink!
A6: This happens because you ran the extreme tweaks. Run "restore.cfg" to undo the changes, or use the individual command "mat_loadtextures 1" to fix the issue (you may need to restart the map).

---

Q7: Help! All textures are white!
A7: This happens because you ran the extreme tweaks. Run "restore.cfg" to undo the changes, or use the individual command "mat_perf_test_shader 0" to fix the issue (you may need to restart the map).

---

Q8: Help! My vision is too dark/blurred in the game!
A8: This likely happens because you ran one of the scripts in the menu but didn’t run it again after loading a map. Try moving around, and your vision may return to normal. Otherwise, the better option is to run the script again.

---

Q9: Why is my game crashing?
A9: This is likely because you’re trying to run the scripts only after loading a map on a low-end PC. If so, avoid doing this. Instead, run the selected script in the menu, and then run it again after loading a map. Alternatively, your computer or game version may not properly support multicore. If that’s the case, run the following commands in the console or add them to a cfg file to run automatically every time you open the game:


Additionally, you may experience occasional crashes. These may or may not be related to the scripts and typically occur only when you play the game for a long time without stopping. There’s nothing you can do about this.

If you’re experiencing constant crashes, please let me know.

---

Q10: Will this disable achievements?
A10: Yes, it will. The scripts use and require the "sv_cheats 1" command to apply the vast majority of tweaks. If you want to complete achievements, try entering "sv_cheats 0" in the console BEFORE loading a save or map (not guaranteed), or simply don’t use this.

---

Q11: Why isn’t the extra working?
A11: The extra disables the live background in the menu. If you see a static image of the last chapter you played instead of a moving background, it’s working. However, if you installed the extra correctly and the background is still animated, it might be a compatibility issue with another addon. The extra modifies the "valve.rc" file to disable the live menu background, and if another addon uses the same file, one or both may not apply. To resolve this, disable the conflicting addon or don’t use the extra.

---

Q12: Why aren't the scripts working?
A12: Because you might be applying an overall quality setting after running a script, which is incorrect and not recommended. If that's the case, always apply the overall quality setting first before running any of the scripts, otherwise the overall quality will reset some of the CVars tweaked by the scripts. If the issue persists, try reinstalling the addon from scratch and ensure the VPK file is in the "custom" folder.

---

Q13: Why isn’t restore.cfg working?
A13: This is a very uncommon issue. Try reinstalling the addon from scratch and then running the file again. If it still doesn’t work, try these two possible solutions:

1. Open the "config.cfg" file located in "/bms/cfg" in the Black Mesa directory. Go to the last line that starts with "bind" and delete everything below it. Save the file and open the game.
   
2. Disable Steam Cloud for Black Mesa, manually delete the game folder, and then reinstall the game. Remember to back up your saves or necessary files.

---

Q14: Do the scripts work in Black Mesa: Blue Shift?
A14: The scripts haven’t been tested in any game other than Black Mesa, but they will likely work correctly in BM:BS.

---

Q15: Is the file you provided a virus?
A15: No, it’s not. It’s just a VPK file. Stupid question.

---

Q16: Can I fork this and create my own version of BMOS?/Can I download this and redistribute it elsewhere?
A16: Yes, you can. Crediting is optional but appreciated.

---